3 amused is a music player. It doesn't have any amazing functionalities
4 built-in, on the contrary: it's quite minimal (a fancy word to say
5 that does very little.) It composes well, or aims to do so, with
6 other tools, find(1) in particular.
8 The main feature is that the process of decoding the audio from the
9 files is done in a sandboxed project that runs with `pledge("stdio
10 recvfd audio")`. Oh, by the way, amused targets OpenBSD only: it
11 relies its make infrastructure to build, uses various cool stuff
12 from its libc and can output only to sndio.
14 (I *think* it's possible to compile it on other UNIX-like systems
15 too by providing shims for some non-portable functions -- hello
16 libbsd -- and assuming that sndio is available. Oh, and that you
17 bundle a copy of imsg.c too)
24 it needs the following packages from ports:
31 Release tarballs installs into `/usr/local/`, git checkouts installs
32 into `~/bin` (idea and implementation stolen from got, thanks stsp!)
37 The fine man page has all nitty gritty details, but the TL;DR is
39 - enqueue music with `amused add files...`
40 - control the playback with `amused play|pause|toggle|stop` etc
42 Pro tip: amused plays well with find:
44 find . -type f -iname \*.opus -exec amused add {} +
46 Well, for these kinds of things I wrote a wrapper aronud find called
47 walk that's very handy in combo with amused too!
49 walk \*.opus ! amused add
51 (walk lives in my [dotfiles](//git.omarpolo.com/dotsnew))
