ytm-player
ytm-player is a terminal-based client for YouTube Music. It is built for use in a text interface and highlights synced lyrics, vim keys, and an mpv backend. The project states support for Linux, macOS, and Windows, and it also notes free-tier support.
The interface exposes library views for playlists, lyrics, liked songs, recently played tracks, and discovery mixes. Its configuration options include playback settings such as audio quality, autoplay, gapless transitions, seek step, resume on launch, and history syncing back to a YouTube Music account. Search-related options include predictive suggestions and a configurable search history size, while the UI settings cover themes, sidebar width, album art, and playback-bar appearance.
Several integrations and deployment details are named on the project page. ytm-player supports MPRIS on macOS and Windows, offers Spotify import, and can use yt-dlp-related settings such as cookies, a custom CA bundle, remote components, and selectable JavaScript runtimes. It is distributed through PyPI and can be installed with pip or pipx; platform-specific installation is also listed for Arch, NixOS, and Gentoo. The configuration files are stored under ~/.config/ytm-player/ and the page says it respects XDG_CONFIG_HOME. The project page also includes GitHub links and shows a latest release labeled v2.0.0.
Overview
5 featuresytm-player is a Players & playlists project. Allowing users to access and control YouTube Music from the terminal without a graphical interface. ytm-player is an open-source project aimed at terminal users and music enthusiasts. The project is open source (MIT). It runs on the web and the command line.
It is developed by peternaame-boop, and it first shipped in 2026. Development happens publicly on GitHub with 398 stars and 331 commits in the last 90 days. Key capabilities include YouTube Music playback, Terminal UI, and MPV integration.
Summary written by a language model from the project’s public pages.
- YouTube Music playback
- Terminal UI
- MPV integration
- Playlist management
- Open source
Built with & integrations
Trust & compliance
Indexing history
1What PulseGate has recorded for this listing
Frequently asked questions about ytm-player
- What does ytm-player do?
- Allowing users to access and control YouTube Music from the terminal without a graphical interface. It is catalogued under Players & playlists on PulseGate.
- Who should use ytm-player?
- ytm-player is an open-source project built for terminal users and music enthusiasts.
- Does ytm-player have a free plan?
- Yes — ytm-player is open source under the MIT license and free to use.
- What platforms does ytm-player run on?
- ytm-player runs on the web and the command line.
- Is ytm-player still maintained?
- The GitHub repository shows 331 commits in the last 90 days.
- What projects are similar to ytm-player?
- Similar projects tracked by PulseGate include ytm-cli, yt-tui, and ymtui.ytm-cliyt-tuiymtui
- Who develops ytm-player?
- ytm-player is developed by peternaame-boop.
- When did ytm-player launch?
- ytm-player first shipped in 2026.
Similar projects
Closest matches by what these projects do