ytermusic

github.com/ccgauche/ytermusic Linux Apps Open-source projectOpen source

ytermusic plays YouTube Music from a terminal interface, with a text-based user interface described by its project.

github.com/ccgauche/ytermusic
ytermusic homepage screenshot

About ytermusic

ytermusic is an open-source, terminal-based YouTube Music client for Linux, written in Rust. It plays YouTube Music playlists and Supermix through a text user interface, and the project describes its aims as privacy, simplicity and performance, reporting memory use of around 20MB while fully loaded.

Key features

  • Plays YouTube Music playlists and Supermix in a terminal text interface
  • Automatic background download manager caches and stores downloads
  • Can play already-downloaded music without an internet connection
  • Keyboard and mouse controls for playback, volume, seeking and shuffle
  • Account access through browser cookie headers, with brand account support
  • Maintenance commands to fix the cache database, clear cache or locate files
Best for: Linux users who want to listen to their YouTube Music library from a terminal, including offline playback of tracks already cached.
Good for
  • Open source, installable from source, from releases or via third-party AUR packages
  • Reported memory use of around 20MB while fully loaded
  • Cached tracks can be played without a connection
Watch out for
  • Linux only; installation requires ALSA, dbus and pkg-config libraries
  • Setup requires manually copying cookie headers from a browser
  • Authentication cookies can expire and need to be replaced

ytermusic at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Platforms
Linux
Open source
Yes · Source code
Language
English
Good for
Developers
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

ytermusic alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in Linux Apps

Well-known listings from the same topic.

All 222

ytermusic FAQ

How do I give ytermusic access to my account?
Copy the Cookie header from the music.youtube.com document request in your browser's developer tools Network tab into a headers.txt file, along with a User-Agent line. Firefox users need to enable the Raw switch so the cookie is not mangled.
Can ytermusic play music without an internet connection?
It can play music that was already downloaded, because downloads are cached and stored. The project lists connectionless playing for previously downloaded tracks.
What should I do if the cache database has problems?
Run ytermusic --fix-db to try to fix cache database issues, ytermusic --clear-cache to clear the cache, or ytermusic --files to find the files related to ytermusic.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing