amused

minimalistic music player

amused is a music player. It doesn't have any amazing functionalities built-in, on the contrary: it's quite minimal (a fancy word to say that it does very little.) It composes well, or aims to do so, with other tools thought.

The main feature is that audio decoding runs in a sandboxed process under pledge("stdio recvfd audio"), at least on OpenBSD.

Building

$ ftp https://ftp.omarpolo.com/amused-0.14.tar.gz
$ tar xzf amused-0.14.tar.gz
$ cd amused-0.14
$ ./configure
$ make
# make install

It needs the following dependencies installed:

flac
libmd (optional; needed on linux and only for amused-web)
libmpg123
libsndio or libasound (ALSA)
libvorbis
opusfile

From OpenBSD 7.1 onward is available via pkg_add amused.

Usage

The usage is described in the man page amused(1), but here's a TL;DR:

There's only one playing queue: tracks can be added at the end or replaced entirely.
Non-audio files are automatically skipped and removed from the playlist, so there's no harm in doing find . | amused load.

State is ephemeral: save and load it later for persistency.

$ amused show -p >amused.dump	# persist
$ amused load amused.dump	# reload

Pipes are a great way to transform data and that's how the playing queue is manipulated. Some examples:

$ amused show | grep -vi riverside | amused load
$ amused show | sort -R | amused load
$ amused show | sort | uniq | amused load

Playback can be controlled with the subcommands play, pause, toggle, stop, etc...
Amused can be trivially integrated in other systems (for example status bars) using amused monitor to watch for events.
protip: alias a=amused and take advantage that commands can be abbreviated:
```
$ a stat		# amused status
$ a l amused.dump	# amused load amused.dump
```

Extras

There are some extra scripts in the repository to show off what can be built on top of amused.

While useful -I use them every day- these adds further dependencies and so are not installed by default.

amused-web

amused-web(1) is a simple web UI to control amused remotely. It has optional websockets supports to automatically update the UI upon changes.

It depends only on libc (and on libmd on linux). Can be built and installed with:

$ make web
# make install-web

contrib/amused-monitor

amused-monitor is a simple TUI written in perl. It shows the current status of amused, the song being played and an excerpt from the playlist.

amused-monitor depends on p5-Curses and p5-Text-CharWidth.

To read the documentation, run perldoc amused-monitor.

contrib/amusing

amusing is a simple GUI written in Tcl/Tk. It allows to filter the playing queue and to control the playback.