Thu Feb 17 13:06:48 2022 UTC
reflow + grammar
# amused
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
does very little.) It composes well, or aims to do so, with other tools
The main feature is that audio decoding runs in a sandboxed process
under `pledge("stdio recvfd audio")`. Oh, by the way, amused targets
OpenBSD only: it relies its make infrastructure to build, uses various
cool stuff from its libc and can output only to sndio.
(I *think* it's possible to compile it on other UNIX-like systems too by
providing shims for some non-portable functions -- hello libbsd -- and
assuming that sndio is available. And that you bundle a copy of imsg.c
## building
$ make
it needs the following packages from ports:
- flac
- libmad
- libvorbis
- opusfile
Release tarballs installs into `/usr/local/`, git checkouts installs
into `~/bin` (idea and implementation stolen from got, thanks stsp!)
## usage
The fine man page has all nitty gritty details, but the TL;DR is
- enqueue music with `amused add files...`
- control the playback with `amused play|pause|toggle|stop` etc
amused tries to be usable in composition with other more familiar tools
instead of providing everything itself. For instance, there isn't a
command to remove an item from the playlist, or shuffle it; instead,
standard UNIX tools can be used:
$ amused show | grep -vi kobayashi | amused load
$ amused show | sort -R | amused load
$ amused show | sort | uniq | amused load
It also doesn't provide any means to manage a music collection. It
plays nice with find(1) however:
find . -type f -iname \*.opus -exec amused add {} +
Well, for these kinds of things I wrote a wrapper around find called
walk that provides 80% of what I do with find in 20% of the characters:
walk \*.opus amused add
but you got the idea (walk lives in my
Omar Polo