ytermusic

YTerMusic

YTerMusic is a TUI based Youtube Music Player that aims to be as fast and simple as possible.

Screenshots

Features and upcoming features

• Play your Youtube Music Playlist and Supermix.
• Memory efficient (Around 20MB of RAM while fully loaded)
• Cache all downloads and store them
• Work even without connection (If musics were already downloaded)
• Automatic background download manager

  Check List

  • Playlist selector
  • Error message display in the TUI
  • Enable connection less music playing
  • Cache limit to not exceed some given disk space
  • A download limit to stop downloading after the queue is full
  • Mouse support
  • Search
  • Custom theming (You can use hex! #05313d = )

Install

[!TIP] 3rd party AUR packages are available here.

• Download the latest version from releases.

  Linux

  Install the following libraries:
  bash复制

  sudo apt install alsa-tools libasound2-dev libdbus-1-dev pkg-config

• Use cargo to install the latest version
  bash复制

  cargo install ytermusic --git https://github.com/ccgauche/ytermusic

Setup

[!IMPORTANT] If you're using Firefox enable the "Raw" switch so the cookie isn't mangled.

• Give ytermusic authentication to your account, by copying out the headers
  1. Open the https://music.youtube.com website in your browser
  2. Open the developer tools (F12 or Fn + F12)
  3. Go to the Network tab
  4. Find the request to the music.youtube.com document / page
  5. Copy the Cookie header from the associated response request
  6. Create a headers.txt file in one of the checked paths.
  7. Create an entry like this :
  复制

  Cookie: 
  User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36

• Then you can start ytermusic

(Optional) Using a brand account

• If you use a second account for youtube music 1. Go to https://myaccount.google.com/ 2. Switch to your brand account 3. copy the number written in the url, after \b
  4. paste it into a new account_id.txt file in the same folder as headers.txt

Building from source

• Clone the repository
• Install rust https://rustup.rs nightly
• Run cargo build --release
• The executable is in target/release/ytermusic.exe or target/release/ytermusic

Usage

• Use your mouse to click in lists if your terminal has mouse support
• Press Space to play/pause
• Press Enter to select a playlist or a music
• Press f to search
• Press s to shuffle
• Press r to remove a music from the main playlist
• Press Arrow Right or > to skip 5 seconds
• Press Arrow Left or \ to go back 5 seconds
• Press CTRL + Arrow Right or CTRL + > to go to the next song
• Press CTRL + Arrow Left or CTRL + \ to go to the previous song
• Press + for volume up
• Press - for volume down
• Press Arrow down to scroll down
• Press Arrow up to scroll up
• Press ESC to exit the current menu
• Press CTRL + C or CTRL + D to exit

How to fix common issues

If you have any issues start by running:

ytermusic --fix-db

This will try to fix any issues with the cache database.

If you still have issues, you can clear the cache by running:

ytermusic --clear-cache

If you need to report an issue or find the files related to ytermusic:

ytermusic --files

Changelog

…