YT-Music CLI

Terminal-based music download tool controlled with arrow keys for high-resolution YouTube Music streaming and FLAC downloads.

Python 3.11CLIFFmpegMIT LicenseStable

Terminal Preview

yt-music-cli — kitty — 120x34
$yt-music search "Daft Punk Discovery"
Found 14 matches (cached 0.04s):
➔ [01] One More Time — 05:20
FLAC · 44.1kHz / 16-bit · 942 kbps
[02] Aerodynamic — 03:27
AAC · 256 kbps
[03] Digital Love — 04:58
FLAC · 44.1kHz
[04] Harder, Better, Faster, Stronger — 03:45
FLAC · 44.1kHz
[DOWNLOAD] Downloading: One More Time.flac
████████████████░░ 78%
78% · 28.4 MB / 36.2 MB
Speed: 14.8 MB/s · ETA: 0.5s

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

bash — package installation
# Arch Linux (AUR)
yay -S yt-music-cli

# Standard Python pip
pip install --user yt-music-cli

Example Commands

bash — execution options
# 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 ~/Music

Requirements & Compatibility

RUNTIMEPython ≥ 3.10
ENCODERFFmpeg (libopus, flac)
PLATFORMLinux / macOS / BSD
Repository Link

Visit the GitHub repository for source code and issue tracking.

•built with Next.js · v2.4.0
YT-Music CLI | vamola.dev