YTerMusic is a TUI based Youtube Music Player that aims to be as fast and simple as possible.
[!TIP] 3rd party AUR packages are available here.
Download the latest version from releases.
Install the following libraries:
sudo apt install alsa-tools libasound2-dev libdbus-1-dev pkg-config
Use cargo
to install the latest version
cargo install ytermusic --git https://github.com/ccgauche/ytermusic
[!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
music.youtube.com
document /
pageCookie
header from the associated response requestheaders.txt
file in one of the checked paths.Cookie: <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
https://rustup.rs
nightlycargo build --release
target/release/ytermusic.exe
or target/release/ytermusic
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
Beta b0.1.1
- Added `hide_channels_on_homepage` with a default value of `true` to the config file
- Added `hide_albums_on_homepage` with a default value of `false` to the config file
- Fixed default style to support transparency
- Added more color configuration options
Beta b0.1.0
- Fixed keyboard handling on windows
- Improved error handling
- Fixed youtube downloads
- Made volume bar optional in config
- Improved performance and updated dependencies
Alpha a0.0.11
- Added scrollable music view
- Added shuffle functionality
- Fixed some crashes while resizing the app
- Added error messages for invalid headers or cookies
- Added error messages for expired cookies
Alpha a0.0.10
- Speed up the download process
- Fix the download limit
- Fix music artists getting smashed together
- Fix the download manager not downloading all musics
- Improved stability
- Improved logs and added timings to better debug
Alpha a0.0.9:
- Progress info for downloads
- Mouse support on time bar
- Vertical volume bar
- Vertical volume bar supports mouse click
- Scroll to change volume and skip in timeline
- Improved the scrolling action
- Fixed the bug where the time bar would not update
- Debouncing the search input
- Changed the location of the cache folder to follow the XDG Base Directory Specification (By @FerrahWolfeh #20)
- More configuration options (By @ccgauche and @FerrahWolfeh)
Alpha a0.0.8
- Fixed scrolling
- Fixed audio-glitches
- Removed nightly flag use
Alpha a0.0.7
- Major changes in the API
- Fixed log file bloat issue
Alpha a0.0.6
- Fix: Fix a bug where the app would crash when trying to play a song that was not downloaded
- Fix: Improve the logger to not print the same error twice
- Improved startup time
- Fixed linux build
- Changed how task are distributed to the thread pool
Alpha a0.0.5
- Added local database cache to improve IO accesses
- Added searching for musics in the local library
- Greatly improved render performance and RAM usage
- Error management and error display in specific screen
Alpha a0.0.4
- Added menu navigation
- Added searching for musics
- Added new terminal backend
Alpha a0.0.3
- Mouse support to select playlist and music
- Download limiter
- Connection less music playing
Alpha a0.0.2
- Playlist selector
- Improved error management
- Improved TUI
- Performance upgrade
- Switch to Rustls instead of openSSL