← 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

🆕 What's New in termusic 0.11.0+

Enhanced Podcast Support: Better RSS feed handling and episode management
Improved Cover Display: Better album cover protocols and terminal compatibility
Performance Optimizations: Faster audio processing and reduced memory usage
Better Tag Editor: Enhanced metadata editing capabilities
Streaming Improvements: Better online source integration and download features
UI Enhancements: Improved interface and user experience

📦 Installation from debian.griffo.io

Step 1: Add Repository

curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg
echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list
sudo apt update
                

curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg
echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list
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 debian.griffo.io?

📊 Repository Comparison:

Official Debian: Available in some versions but often outdated
Cargo Install: Requires Rust toolchain and complex dependencies
debian.griffo.io: Latest version (0.11.0+) 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 debian.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.
        

🎵 Install Latest termusic on Debian