Is Termusic in the official Debian repositories?

No — Termusic is not packaged in the official Debian archives. This repository is currently the only apt source, serving Termusic 0.13.2.

How do I install the latest Termusic on Debian?

Add the deb.griffo.io repository once using the instructions above, then run: sudo apt install termusic. New releases arrive through the normal sudo apt upgrade.

Are the packages signed and how are they built?

Every package is signed with the repository's GPG key (EA0F721D231FDD3A0A17B9AC7808B4DD62C41256) and built from upstream releases in public GitHub packaging repositories that anyone can inspect.

Which Debian releases are supported?

Debian 12 Bookworm, Debian 13 Trixie, Forky and Sid.

Install Latest Termusic on Debian via apt

Source	Version
deb.griffo.io	0.13.2 ✅
Official Debian	🚫 not packaged

← Back to home

What is 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 Philosophy:

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

            🚀 Why Latest Versions Matter: termusic is actively developed with frequent releases containing new features, performance improvements, and enhanced audio format support. The latest versions include better podcast support, improved album cover display, and enhanced streaming capabilities.
        

⚡ 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

            🚀 Always ahead of the official archives: Debian and Ubuntu freeze package versions when a release ships — this repository publishes new upstream releases typically within hours. A simple apt upgrade keeps you on the latest version.
        

📦 Installation from deb.griffo.io

Run the commands

Step 1: Add Repository

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 update

install -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 update

🆓 There is an always-free mirror. deb-free.griffo.io serves packages free forever — no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries Ghostty, Oh My Posh and Zed; Termusic is not one of them, so the repository above is the only way to get it today — ask and it can be enrolled.

How the free mirror works →

Step 2: Install termusic

# Install latest termusic
sudo apt install termusic

# Verify installation
termusic --version

# Install latest termusic
apt install termusic

# Verify installation
termusic --version

🎯 Basic Usage Examples

Launch termusic:

# Start termusic
termusic

# Start with specific music directory
termusic --music-dir ~/Music

# Start server mode for remote control
termusic-server

Essential 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

🚀 Why Choose deb.griffo.io?

📊 Repository Comparison:

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

📦 Package Build Repository

The Debian packages are automatically built and maintained in this GitHub repository:

🎵 termusic-debian - Latest release builds

🔗 Related Packages

Also available from deb.griffo.io:

lowfi - Simple lofi music player
Yazi File Manager - Browse music files efficiently
fzf Fuzzy Finder - Search music collections

            🎯 Perfect for: Music enthusiasts who want comprehensive terminal audio experience, podcast listeners, developers who prefer terminal applications, and anyone seeking freedom from subscription-based music platforms.
        

💝 Support This Project

If this repository saves you time and effort, please consider supporting it!

⭐ Star on GitHub 🐦 Share on Twitter

🎵 Install Latest termusic on Debian