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.
$ ftp https://ftp.omarpolo.com/amused-0.13.tar.gz $ tar xzf amused-0.13.tar.gz $ cd amused-0.13 $ ./configure $ make # make install
It needs the following dependencies installed:
From OpenBSD 7.1 onward is available via
The usage is described in the man page amused(1), but here's a TL;DR:
find . | amused load.
$ amused show -p >amused.dump # persist $ amused load amused.dump # reload
$ amused show | grep -vi riverside | amused load $ amused show | sort -R | amused load $ amused show | sort | uniq | amused load
amused monitorto watch for events.
alias a=amusedand take advantage that commands can be abbreviated:
$ a stat # amused status $ a l amused.dump # amused load amused.dump
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(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
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
To read the documentation, run
amusing is a simple GUI written in Tcl/Tk. It allows to filter the playing queue and to control the playback.