什么是 termusic?
termusic is a comprehensive terminal music and podcast player written in Rust by tramhao. It allows you to listen to music and podcasts freely - both in terms of freedom and free of charge. With over 1.5k GitHub stars, it provides a full-featured music experience directly in your terminal with album covers, lyrics, and multiple audio backends.
- Freedom: No dependence on online service providers or complicated copyright restrictions
- Free of charge: Download from YouTube, NetEase, Migu, and KuGou without monthly subscriptions
- Your music: Play your local collection without platform limitations
⚡ Key Features of termusic
🎨 Album Cover Display
Shows album covers directly in terminal using Kitty, iTerm2, Sixel protocols, or ueberzug. Visual music experience in text mode.
📻 Podcast Support
Full podcast player with RSS feed support, episode management, and streaming capabilities. Listen to your favorite shows in terminal.
🔊 Multiple Backends
Symphonia (Rust), GStreamer, and MPV backends for maximum format compatibility and performance options.
📥 Download Integration
Built-in support for yt-dlp and FFmpeg to download music from various online sources including YouTube.
🏷️ Tag Editor
Built-in metadata editor for organizing your music collection. Edit tags, album art, and file information directly.
🎼 Lyrics Support
Display synchronized lyrics with timestamp adjustment. Enhanced music experience with lyric viewing and editing.
🎵 Supported Audio Formats
- Lossless: FLAC, AIFF, WAV
- Compressed: MP3, M4A, Opus, Ogg Vorbis
- Streaming: WebM, MKV (codec dependent)
- Metadata: Full tag support for most formats
apt upgrade 即可始终保持最新版本。
📦 从 deb.griffo.io 安装
步骤 1:添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅,最多落后上游 2 个月,安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed;Termusic 不在其中,因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具:它会替你写好 sources 文件并安装签名密钥,并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中,永久免费镜像则为 griffo-free,因此在 Debian(bookworm、trixie、forky、sid)上,上面的命令就是全部配置。
extrepo 只负责 sources 文件和密钥,订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内,因为 extrepo 只发布 Debian 各套件的元数据:在 Ubuntu 上请使用 sudo 或 root 的命令。
步骤 2:安装 termusic
# Install latest termusic
sudo apt install termusic
# Verify installation
termusic --version# Install latest termusic
apt install termusic
# Verify installation
termusic --version🎯 基本使用示例
Launch termusic:
# Start termusic
termusic
# Start with specific music directory
termusic --music-dir ~/Music
# Start server mode for remote control
termusic-serverEssential controls:
# Playback
Space - Play/Pause
n - Next track
p - Previous track
r - Repeat mode
s - Shuffle mode
# Navigation
j/k or ↑/↓ - Move up/down
Enter - Select/Play
Tab - Switch panels
q - Quit
# Volume
+/- - Volume up/down
m - Mute🚀 为什么选择 deb.griffo.io?
- Official Debian: Available in some versions but often outdated
- Cargo Install: Requires Rust toolchain and complex dependencies
- deb.griffo.io: Latest version with all dependencies
- ✅ Latest Features: Get newest audio format support and player features
- ✅ No Rust Compilation: Pre-built with all backends and dependencies
- ✅ Automatic Updates: Packages updated within hours of upstream releases
- ✅ Complete Package: Includes all audio backends and cover protocols
- ✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
- ✅ Easy Maintenance: Standard apt commands for updates
📦 软件包构建仓库
Debian 软件包在此 GitHub 仓库中自动构建和维护:
- 🎵 termusic-debian - Latest release builds
🔗 相关软件包
也可从 deb.griffo.io 获取:
- lowfi - Simple lofi music player
- Yazi File Manager - Browse music files efficiently
- fzf Fuzzy Finder - Search music collections