Sat Jun 11 07:55:04 2022 UTC
some tweaks for the readme
# amusedamused is a music player. It doesn't have any amazing featuresbuilt-in, on the contrary: it's quite minimal (a fancy word to saythat does very little.) It composes well, or aims to do so, withother tools thought.The main feature is that audio decoding runs in a sandboxed processunder `pledge("stdio recvfd audio")`. Oh, by the way, amused targetsOpenBSD only: it relies its make infrastructure to build, uses variouscool stuff from its libc and can output only to sndio.(I *think* it's possible to compile it on other UNIX-like systems too byproviding shims for some non-portable functions -- hello libbsd -- andassuming that sndio is available. And bundling a copy of imsg.c too)## Building$ make$ make install # eventuallyRelease tarballs installs into `/usr/local/`, git checkouts installsinto `~/bin` (idea and implementation stolen from got, thanks stsp!)It needs the following packages from ports:- flac- libmpg123- libvorbis- opusfileIt's available on the OpenBSD port tree starting with 7.1## UsageThe 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` etcamused tries to be usable in composition with other more familiar toolsinstead of providing everything itself. For instance, there isn't acommand 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 loadIt also doesn't provide any means to manage a music collection. Itplays nice with find(1) however:find . | amused loadI wrote a bit more about the background of amused [in a blogpost](https://www.omarpolo.com/post/amused.html).