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