Trix Player

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.

✨ 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 colors

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

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]
title_accent = "#7aa2f7"
current_track_accent = "#7aa2f7"
playing_indicator = "#9ece6a"

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

now_accent = "#7aa2f7"
progress_accent = "#9ece6a"
hints_accent = "#7dcfff"
search_accent = "#bb9af7"
move_accent = "#e0af68"

key_accent = "#bb9af7"
song_title_accent = "#e0af68"

text_primary = "white"
text_muted = "dark_gray"
error = "red"

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

📄 License

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

👤 Author

Riza Mohammad

• GitHub: @RIZAmohammadkhan