termitune

A fast, lightweight, keyboard-driven terminal music player in Rust for unix systems.

Features

• File Browser - Navigate directories and browse audio files
• Audio Metadata - Displays title, artist, and duration
• Queue System - Add tracks to queue and manage playback
• Playback Controls - Play/pause, next/previous track
• Volume Control - Adjust volume with +/- keys
• Progress Bar - Track progress with time display
• Automatic Queue Progression - Automatically advances to next track when current finishes
• Persistent Volume - Volume settings persist across track changes

Installation

cargo install termitune

NOTE: If cargo is missing, then refer: Building From Source

Building From Source

1. Install Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Install System Dependencies

Debian/Ubuntu

sudo apt-get update
sudo apt-get install build-essential pkg-config libasound2-dev

Fedora

sudo dnf update
sudo dnf install gcc pkgconfig alsa-lib-devel

Arch Linux

sudo pacman -Sy
sudo pacman -S base-devel alsa-lib

macOS (untested)

brew install pkg-config
# Note: Additional audio library setup may be required on macOS

3. Build & Run

# Clone the repository
git clone https://github.com/ohmygodashish/termitune.git
cd termitune

# Build release version
cargo build --release

# Run
cargo run --release

Keyboard Shortcuts

Supported Audio Formats

• MP3
• FLAC
• WAV
• OGG
• M4A
• AAC
• WMA

License

MIT License