oxidio-cli
| Crates.io | oxidio-cli |
| lib.rs | oxidio-cli |
| version | 1.0.0 |
| created_at | 2026-01-21 22:02:59.316284+00 |
| updated_at | 2026-01-21 22:42:52.390133+00 |
| description | Terminal UI for Oxidio music player |
| homepage | |
| repository | |
| max_upload_size | |
| id | 2060201 |
| size | 189,426 |
Nathan Baker (pcnate)
documentation
README
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-devon 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