Skip to main content
Lab Grimoire
TW EN
Coffee
ai-tools

ytm-player: Terminal YouTube Music Client

A polished TUI music client built on mpv and yt-dlp. Supports lyrics display, Spotify playlist import, and Last.fm scrobbling. Surprisingly complete for a terminal app, but relies on cookie-based auth and unofficial YouTube APIs.

TL;DR

ytm-player is much more polished than the typical “weekend terminal toy.” It offers a full TUI music experience for YouTube Music users, including lyrics, queue management, search, library views, Spotify import, and optional Last.fm or Discord integrations.

If you are deeply committed to terminal-first workflows, it is easy to see the appeal.

Why people will like it

The project clearly understands its audience. It is keyboard-driven, structured around multiple pages rather than a single screen, and built on a stack that makes sense for this kind of tool: Python, mpv, and yt-dlp. That gives it real playback capability rather than just metadata browsing.

It also goes beyond bare-minimum playback. Synchronized lyrics, cache management, media key support, and ecosystem extras make it feel like someone cared about the actual day-to-day experience.

YTM_Player Data Flow

Why we are still cautious

There are two separate issues.

First, this is an entertainment tool rather than a core productivity tool. That does not make it bad, but it does lower its priority in a serious tool stack.

Second, the authentication and platform risk are real. The research notes describe a cookie- or header-based auth flow rather than an official OAuth path, and the project depends on unofficial endpoints through yt-dlp-style techniques. That means breakage, account friction, and maintenance uncertainty are part of the package.

There is also a supply-chain angle in the mention of remote components fetched from external sources. Even if that feature is optional, it is worth noting.

Who it is for

ytm-player makes sense if you:

  • genuinely live in the terminal
  • enjoy TUI software as a workflow preference
  • accept unofficial client trade-offs in exchange for a better keyboard-driven interface

It makes less sense if you:

  • want maximum stability
  • prefer officially supported clients
  • do not want to deal with cookie-based authentication

Bottom line

ytm-player is a well-made niche tool. We would not call it essential, and we would not call it low-risk. But for the right terminal-native user, it is easy to understand why it is compelling.

cover

FAQ

Is ytm-player an official YouTube Music app?

No. It is an unofficial third-party TUI client that uses yt-dlp and mpv under the hood. It relies on cookie-based authentication and may break if YouTube changes its API.

Can I import my Spotify playlists?

Yes. ytm-player supports importing playlists from Spotify and also integrates with Last.fm for scrobbling.