YT-Music CLI
Terminal-based music download tool controlled with arrow keys for high-resolution YouTube Music streaming and FLAC downloads.
Terminal Preview
About
YT-Music CLI is a terminal-based tool developed to deliver a seamless listening experience by eliminating the high memory and CPU overhead caused by desktop clients. As an alternative to bulky Electron-based web interfaces, it stays true to the Unix philosophy and provides full compatibility with input/output pipelines.
Built with Python 3.11 and an async network layer, the architecture caches search queries locally and presents an interactive terminal menu within seconds. It carries no heavy GUI dependencies; everything is controlled via arrow keys or Vim navigation shortcuts.
Features
Lossless Audio Streaming
Captures YouTube Music Opus and WebM streams, routes them to a lossless PCM buffer via local FFmpeg build, and converts them to FLAC containers instantly.
Tag & Cover Mapping
Automatically processes artist, album, release year, and lyrics metadata in ID3v2/Vorbis format; embeds the highest-resolution cover art from the original source into the file.
Lightweight & Fast
Delivers sub-35ms cold start on CPython runtime and maintains steady RAM usage under 24MB during operation.
Vim Keybindings
Beyond standard arrow keys, full j / k / Enter Vim shortcuts and fzf-like fuzzy search filtering architecture.
Installation & Usage
Installation
# Arch Linux (AUR)
yay -S yt-music-cli
# Standard Python pip
pip install --user yt-music-cliExample Commands
# Direct track or album search
yt-music search "Pink Floyd" --format flac
# Background sync playlist to local directory
yt-music playlist --sync-id PL12345 --output ~/MusicRequirements & Compatibility
Visit the GitHub repository for source code and issue tracking.