UnAmp

It really whips the llama's ass — on Unix. (UnAmp, as in Unix.)

Website: unamp.divanv.com

Native Rust/egui music player. Point it at a folder, a mounted drive or a network share and play what's there: album art, a scrolling title, a big time display, a proper bar spectrum analyzer and a 10-band equalizer. Like the original, it comes in separate windows — Player, Equalizer, Playlist and Media Library — that you can open, close and arrange.

Screenshot

The library in the picture is fake: make screenshot builds a temporary folder of synthesised songs, runs UnAmp against it, and saves the result to docs/screenshot.png, so it can be regenerated after any UI change without showing anyone's real music or drives (ADR-0021).

Status

New (v0.1). Built and used on Linux (ADR-0001); each release also ships an unsigned macOS .dmg, built automatically (ADR-0025).

What It Does Today

• Floating Player / Equalizer / Playlist / Media Library windows; toggle them from the Windows menu or the player's EQ / PL / ML buttons. Layout is remembered; Windows → Reset layout restores it (ADR-0006)
• Windows are tiled to fill the app by default, with a draggable split; turn off Windows → Tile windows to float them, and Windows → Snap to grid lines floating windows up on a grid and against each other's edges when you move or resize them (ADR-0022)
• Skins: stock egui by default, or pick Steam Classic (the old olive-green Steam client) or Photograph (the dark greys and Ubuntu orange of Photograph) from the Skins menu; write your own in TOML (ADR-0008), or drop in a classic Winamp .wsz and get its windows drawn from its own bitmaps (ADR-0010)
• Waveform window (Windows → Waveform, off by default): the whole track as a DAW shows it, with per-channel peak and RMS lanes, the played part highlighted, a playhead, and click or drag to seek. It fills in left to right as the track is read (ADR-0017)
• 10-band graphic equalizer (60 Hz – 16 kHz) with preamp, presets and a live response curve; double-click a slider to zero it (ADR-0007)
• Save your own EQ profiles, then rename or delete them from the presets menu (ADR-0026)
• Search (Ctrl+F): finds tracks and folders anywhere under the current location by matching every word against their paths, streaming results as it goes, no scan or database needed (ADR-0015)
• Media Library: a collapsible folder tree that loads as you expand it, so slow shares never freeze the window (ADR-0014); the sidebar lists mounted drives, ZFS pools and network shares (NFS/SMB/sshfs/GVfs)
• Plays MP3, FLAC, Ogg Vorbis, WAV, AAC/ALAC (.m4a), AIFF, CAF and MKA via symphonia
• Reads tags (title, artist, album, track number, duration, bitrate) for the folder you're viewing
• Album art from embedded covers, or cover/folder/front/album images beside the tracks
• Playlist: double-click a track in the library to play its folder from there, or right-click to add tracks or whole folders to the playlist. Drag rows to reorder the playlist or the queue
• Up-next queue: right-click any track for Play next or Add to queue. Queued tracks play before the playlist carries on from where it was, show as [1], [2] in the playlist (classic skins too), and Previous walks back through everything you heard (ADR-0012)
• Media controls (MPRIS): shows up in GNOME's notification-panel mini player with art and controls, and works with media keys, headset buttons and playerctl. Optional: without a D-Bus session it's simply off (ADR-0016)
• The playlist and queue are saved as you go and restored on startup, as standard M3U files other players can open (ADR-0013)
• Shuffle, repeat (off / all / one), seek, volume
• Spectrum analyzer with falling peak caps; elapsed/remaining time (click the time to toggle)
• Network-safe: files are opened, probed and tag-read on worker threads, never on the UI thread (ADR-0004)

Not yet: Opus, recursive folder play, named playlists (load/save list), resume-at-position, custom EQ presets.

Keyboard

The classic bottom row, with nothing focused:

Key	Action
Z	Previous (restarts the track if more than 3 s in)
X	Play
C / Space	Pause / resume
V	Stop
B	Next
← / →	Seek 5 s
M	Mute / unmute (or click the speaker)
Ctrl+F	Search the Media Library

Skins

UnAmp starts with egui's stock look; pick another from the Skins menu.

• TOML skins recolour everything. Steam Classic, Dark Orange, Calendar and Notebook come built in from Patina, the frame and skin format UnAmp shares with Photograph and other apps. Write your own in ~/.config/patina/skins/ (read by every Patina app) or ~/.config/unamp/skins/, or use Skins → Copy built-in skins to folder for an annotated one to edit.
• Classic Winamp skins: drop a .wsz in the same folder and reload. The Player, Equalizer and Playlist are drawn from the skin's own bitmaps, the way Winamp drew them. Find thousands at the Winamp Skin Museum.

The full guide, covering every TOML key, what a .wsz turns into, and what classic mode does and doesn't draw, is in docs/skinning.md.

Install

Download (.deb)

The latest .deb for Ubuntu and Debian-based distributions (x86-64) is on the releases page:

wget https://github.com/divanvisagie/UnAmp/releases/latest/download/unamp_amd64.deb
sudo apt install ./unamp_amd64.deb

Download (macOS)

The latest .dmg (Apple Silicon and Intel, macOS 11+) is on the releases page, or https://github.com/divanvisagie/UnAmp/releases/latest/download/UnAmp.dmg. Open it and drag UnAmp to Applications. It isn't signed by Apple, so allow it once under System Settings → Privacy & Security → Open Anyway (or run xattr -dr com.apple.quarantine /Applications/UnAmp.app). Mounted-drive discovery, network shares in the sidebar and media keys are Linux-only.

From crates.io

sudo apt install -y libasound2-dev pkg-config
cargo install unamp

From Source

sudo apt install -y libasound2-dev pkg-config
cargo run --release

Build the .deb yourself

sudo apt install -y dpkg-dev
make install

Configuration

Settings are saved on exit to ~/.config/unamp/config.toml: last folder, volume, shuffle, repeat, time display mode, equalizer settings, skin and which windows are open. Window positions and sizes are kept by eframe in ~/.local/share/unamp/, next to playlist.m3u8 and queue.m3u8. Those are ordinary extended M3U playlists; UnAmp marks where you were with #UNAMP-CURRENT and #UNAMP-PLAYING comment lines, which other players ignore.

Saved EQ profiles live in ~/.config/unamp/eq.toml, one table per profile:

["Late Night"]
preamp = -2.0
bands = [3.0, 2.0, 0.0, -1.0, -2.0, -1.0, 0.0, 1.0, 1.0, 0.0]

It's read at startup and only written when you save, rename or delete a profile, so it's safe to edit by hand while UnAmp is closed.

Development

cargo test
make dev     # live reload, requires cargo-watch
make help    # all targets

Significant decisions are recorded as ADRs in docs/adr/.

UnAmp was built with Claude Code from ten short prompts, listed word for word in docs/prompts.txt.

Releasing

One command, run on a clean, pushed master:

make release                 # next patch version; BUMP=minor|major or V=x.y.z to choose

It bumps the version, tags and pushes, opens a draft GitHub release and publishes the crate to crates.io. The release workflow then builds the .deb and the .dmg on GitHub, attaches them, publishes the release and points the website's download links at them (ADR-0025). Pull afterwards: the link update is a commit on master.

License

BSD-3-Clause. Not affiliated with Winamp or Llama Group.