Trix Player

A beautiful, keyboard-driven terminal music player for Linux.

Features • Installation • Usage • Building

Trix is a lightweight, high-performance music player built with Rust. It is designed for Linux users who prefer the terminal, offering a clean TUI (Terminal User Interface), robust keyboard navigation (vim-like), and low resource usage.

🎬 Demo

https://github.com/user-attachments/assets/4a7be924-2580-49d4-bd89-cddd8a084f2b

✨ Features

• Format Support: MP3, FLAC, WAV, OGG, M4A, AAC, Opus.
• Intuitive TUI: Clean interface built with ratatui.
• Volume Control: Native ALSA system volume control (with software fallback).
• Search: Fast, fuzzy-like filtering to find tracks instantly.
• Playback Control: Shuffle, Loop (track/playlist), and Seek.
• File Management: Delete tracks directly from the player.
• Standard Compliance: automatically detects music via XDG_MUSIC_DIR or defaults to ~/Music.

📦 Installation

Arch Linux (AUR)

Trix is available on the AUR as trix-player. Use your favorite AUR helper:

yay -S trix-player
# or
paru -S trix-player

Debian / Ubuntu

Download the latest .deb file from the Releases Page.

sudo dpkg -i trix-player_*.deb
sudo apt-get install -f # Fix dependencies if needed

Fedora / RHEL / openSUSE

Download the latest .rpm file from the Releases Page.

sudo rpm -i trix-player-*.rpm

Generic Linux (Binary)

Download the .tar.xz archive from the Releases page, extract it, and move the binary to your path.

tar -xf trix-player-*.tar.xz
sudo mv trix /usr/local/bin/

One-line Install (curl)

Installs the latest x86_64-unknown-linux-gnu release into ~/.local/bin (or /usr/local/bin if run as root).

curl -fsSL https://raw.githubusercontent.com/RIZAmohammadkhan/TerminalMusicPlayer/main/install.sh | sh

Install to a custom prefix:

curl -fsSL https://raw.githubusercontent.com/RIZAmohammadkhan/TerminalMusicPlayer/main/install.sh | PREFIX=/usr/local sh

From Source (Rust)

If you have the Rust toolchain installed:

git clone https://github.com/RIZAmohammadkhan/TerminalMusicPlayer.git
cd TerminalMusicPlayer
cargo install --path .

🚀 Usage

Run the player by typing:

trix

By default, Trix looks for music in your XDG Music directory (usually ~/Music). You can also play a specific directory or file:

trix /path/to/my/songs

⚙️ Configuration

Trix can load a user config file from:

• $XDG_CONFIG_HOME/trix/config.toml
• or (fallback) ~/.config/trix/config.toml

Currently this is focused on theming colors.

Theme selection is intentionally not terminal-specific:

• Default theme: Atom Dark accents (standardized RGB colors) with terminal-default background
• Override: your config file values (deterministic, field-by-field)

For maximum consistency across terminals, prefer hex RGB colors (e.g. "#61afef"). Basic named colors (e.g. "cyan", "white") may still vary depending on your terminal’s ANSI palette.

Theme colors

Color values can be basic names (e.g. "cyan", "dark_gray") or hex RGB (e.g. "#61afef").

Important semantic constraint:

• theme.library_accent is used for both the Library frame and the selection highlight. This is intentional so you can't configure the UI into a confusing state where “library color” and “selection color” drift apart.

Example ~/.config/trix/config.toml:

[theme]

# Global UI background
# Use "reset" (or omit this key) to respect your terminal background/transparency.
# Set a hex color (e.g. "#282c34") to force a solid UI background.
background = "reset"

title_accent = "#61afef"
current_track_accent = "#56b6c2"
playing_indicator = "#98c379"

# Single knob: library frame + selection highlight
library_accent = "#e5c07b"

now_accent = "#61afef"
progress_accent = "#98c379"
hints_accent = "#c678dd"
search_accent = "#56b6c2"
move_accent = "#e5c07b"

key_accent = "#c678dd"
song_title_accent = "#e5c07b"

text_primary = "#abb2bf"
text_muted = "#5c6370"
error = "#e06c75"

Keyboard Controls

Trix is designed to be used entirely without a mouse.

🔧 Dependencies

To build or run Trix, you need ALSA development libraries installed on your system.

• Debian/Ubuntu: sudo apt install libasound2-dev
• Fedora: sudo dnf install alsa-lib-devel
• Arch: sudo pacman -S alsa-lib

🤝 Contributing

Contributions are welcome! Feel free to open issues for bugs or feature requests.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

Known Bugs

1. closing terminal results in 1 second lag of audio closure
2. colors don't work properly need more standardization instead of terminal specific

📄 License

Distributed under the MIT License. See LICENSE for more information.

👤 Author

Riza Mohammad

• GitHub: @RIZAmohammadkhan