oxidio-cli-1.0.0 is not a library.

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

Key	Action
`Space`	Play / Pause
`s`	Stop
`n`	Next track
`p`	Previous track
`<` / `>`	Seek backward / forward
`+` / `-`	Volume up / down

Navigation

Key	Action
`↑` / `k`	Move up
`↓` / `j`	Move down
`g`	Go to start
`G`	Go to end
`Tab`	Next view
`Shift+Tab`	Previous view

Playlist

Key	Action
`S`	Toggle shuffle
`r`	Cycle repeat mode
`e`	Edit mode
`d`	Delete track (edit mode)
`J` / `K`	Reorder tracks (edit mode)
`c`	Clear playlist

Views

Key	Action
`v`	Visualizer
`i`	Track info
`m`	Cycle visualizer style
`?`	Help
`/`	Command mode
`Esc`	Exit current mode
`q`	Quit

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

oxidio-cli 1.0.0