Is Termusic in the official Debian repositories?

No — Termusic is not packaged in the official Debian archives. This free mirror serves the newest Termusic release that is at least 2 months old; the main repository at deb.griffo.io serves every release within hours of upstream.

How do I install the latest Termusic on Debian?

Add the deb-free.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 Termusic on Debian via apt

Source	Version
deb.griffo.io (main)	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 Staying Current Matters: 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

            🆓 Free forever, patched immediately: Debian and Ubuntu freeze package versions when a release ships; this free mirror instead serves the newest release once it is at least 2 months old, with security fixes published immediately. Want every release within hours instead? That's the main repository at deb.griffo.io.
        

📦 Installation from deb-free.griffo.io

Step 1: Add Repository

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt update
                

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt update
                

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-free.griffo.io?

📊 Repository Comparison:

Official Debian: Available in some versions but often outdated
Cargo Install: Requires Rust toolchain and complex dependencies
deb.griffo.io (main): 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 once a release is at least 2 months old; security fixes ship immediately
✅ 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