ytm-player is a terminal-based client for YouTube Music.
It provides a keyboard-driven interface for browsing and playing music from a YouTube Music account, with playback handled by mpv. The application is written in Python and is designed for users who want a capable music player experience without leaving the terminal.
This is free and open source software.
Key Features
- Offers Vim-style keybindings, including j/k movement, multi-key sequences, and count prefixes.
- Displays synced lyrics with live highlighting and LRCLIB fallback support.
- Supports native desktop integrations including MPRIS on Linux, Now Playing on macOS, and media keys on Windows.
- Includes theming support with Textual themes and per-app color overrides.
- Can import Spotify playlists using the Spotify API or a scraper fallback.
- Provides CLI and IPC controls for managing a running TUI from another terminal.
- Restores the last-playing track and queue when the application is launched.
- Offers optional Discord Rich Presence and Last.fm scrobbling support.
- Cross-platform support – runs under Linux, macOS, and Windows.
Website: github.com/peternaame-boop/ytm-player
Support:
Developer: Peter Naame
License: MIT License

ytm-player is written in Python. Learn Python with our recommended free books and free tutorials.
Related Software
| Console-Based YouTube Tools | |
|---|---|
| yt-dlp | Fork of youtube-dl offering new features |
| You-Get | Downloader that scrapes the web |
| Lux | Download library and CLI tool |
| yewtube | Terminal based YouTube player and downloader |
| YouTube TUI | Lightweight and user friendly TUI for browsing YouTube |
| Tizonia | Cloud music player for the Linux terminal |
| pipe-viewer | Lightweight YouTube client with CLI and GUI |
| yt-x | Browse YouTube from the terminal |
| pytubefix | Library and CLI for downloading YouTube videos |
| ytsurf | Clean and distraction-free |
| YTerMusic | Aims to be as fast and simple as possible |
| xytz | TUI frontend for yt-dlp |
| tuitube | TUI to download videos |
| youtube-dl | Download videos from YouTube and many other sites. Extremely versatile |
| ytcc | Keep track of your favorite playlists on YouTube |
| Rataplay | TUI to search, play and download videos |
| MPS-YouTube | Terminal based YouTube player and downloader |
| GoMusic | Download and stream music from YouTube |
Read our verdict in the software roundup.
Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |

