Oxidio

A lightweight Terminal User Interface (TUI) music player written in Rust.

Features

• Audio Playback - Play, pause, stop, seek, volume control, next/previous track
• Multiple Formats - MP3, FLAC, OGG, WAV, M4A/AAC, OPUS, WMA, AIFF, ALAC
• Visualizers - Bars, spectrum analyzer, waveform, and level meter
• Playlist Management - Shuffle, repeat modes (off/one/all), reordering, save/load
• File Browser - Navigate local and network (SMB/UNC) paths
• Session Persistence - Remembers playlist, position, volume, and settings
• Platform Integration
  • Windows: System Media Transport Controls (lock screen, media keys)
  • Discord Rich Presence

Installation

From Source

Prerequisites:

• Rust 1.70+
• Linux: ALSA development headers (libasound2-dev on Debian/Ubuntu)

git clone https://github.com/pcnate/oxidio.git
cd oxidio
cargo build --release

The binary will be at target/release/oxidio.

Windows Installer

Download the latest installer from Releases.

Usage

# Launch with file browser
oxidio --browse

# Open a directory
oxidio --path /path/to/music

# Play specific files
oxidio track1.mp3 track2.flac

# Play all audio in a directory
oxidio /path/to/music/

Keyboard Shortcuts

Playback

Navigation

Playlist

Views

Configuration

Settings are stored at:

• Linux: ~/.config/oxidio/settings.json
• Windows: %APPDATA%\oxidio\settings.json

{
  "discord_enabled": true,
  "smtc_enabled": true
}

Building

Native Build

cargo build --release

Cross-Compile for Windows (from Linux)

cargo build --release --target x86_64-pc-windows-gnu

Docker Build

docker-compose up build-all
# Outputs to ./dist/

License

MIT