uamp

Universal Advanced Music Player written in Rust.

Uamp is a minimal music player that doesn't get in your way. It is fast, reliable, and powerful.

Uamp currently works as playback server controled with CLI, mpris which may be integrated into your system or web GUI:

Configuration

The configuration is saved in the efault configuration folder on your platform. You can use uamp config to open the config file with your default editor.

CLI

See short help of uamp:

uamp -h

Examples

Show help with all the options (shortest version):

uamp h all

To play/pause you can use the command:

uamp instance play-pause

or the short version

uamp i pp

To start uamp in backgound:

uamp run -d

or short:

uamp -R-d

Stop the running instance:

uamp i x

Show info about now playing:

uamp -Info

Set the playlist to all songs, shuffle and play:

uamp i sp sort=rng pj pp=play

Play file in the currently running instance:

uamp i play='path/to/file.flac'

How it looks

Uamp how has web gui:

Library page

Now playing

Playlist

Albums

Album page

Artists

Artist page

Settings

Possible uamp setup

This is the way that I have confugred and use uamp:

Make uamp start on startup with your cmomputer with the command uamp (or uamp -R-d to make it detached).

Use your OS settings to bind global shortcuts to commands for controlling uamp. For example:

• Ctrl + Alt + Home: uamp i pp (play/pause)
• Ctrl + Alt + PgUp: uamp i ps Previous song
• Ctrl + Alt + PgDown: uamp i ns Next song
• Ctrl + Alt + Up: uamp i vu Volume up
• Ctrl + Alt + Down: uamp i vd Volume down
• Ctrl + Alt + Left: uamp i rw Rewind
• Ctrl + Alt + Right: uamp i ff Fast forward

Now you can just start playing when you want to by using your global shortcut.

Open gui as app with chrome

Set the setting web_client_command to the following value to run uamp web client in chrome as app (replace /chrome/binary with the binary for chrome. It is usually google-chrome or chromium or use whatever other browser that supports web apps):

{
  // ...
  "web_client_command": "/chrome/binary --app=${ADDRESS} --class=uamp"
}

Endless playback

Now you can start the playback with the default alias uamp i al=endless-mix and you never have to worry about it. It will shuffle all your songs into a playlist and when the playlist ends it will reshuffle the playlist and start from the start.

When you will load new songs, they will also be automatically mixed in the playlist after the currently playing song.

Custom tab complete

Uamp can also provide custom tab completion for any bash like shell (works in zsh). To do that add this to your .bashrc/.zshrc/...:

`uamp sh tab`

And that is it. Uamp will now have custom tab completion.

How to get it

Arch linux

If you have arch, you can install it from aur.

Linux single line install

This install script will ask for sudo privilages to move the build files to their apropriate locations.

wget -nv -O - https://raw.githubusercontent.com/BonnyAD9/uamp/master/packages/script/install.sh | sh

Build from source

If you don't have arch, you have to compile it yourself, but that shouldn't be any problem because all you need is cargo:

cargo build -r

the binary will be ./target/release/uamp. It doesn't depend on any other files.

Links

• Author: BonnyAD9
• GitHub repository: BonnyAD9/uamp
• My website: bonnyad9.github.io
• Project website: bonnyad9.github.io/uamp
• Aur package: aur.archlinux.org