commit da045d77d15313594de2066d2a0eeeb7eb288790 from: Omar Polo date: Thu Feb 17 11:45:26 2022 UTC update readme commit - 8e916714790046deccff6075357dc4fef087e9b4 commit + da045d77d15313594de2066d2a0eeeb7eb288790 blob - 0b167262dd4fc3c493139b681b43068ed7ce971a blob + f6c782255d80418ef019687128dca0a764224dda --- README.md +++ README.md @@ -3,7 +3,7 @@ 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, find(1) in particular. +other tools thought. The main feature is that audio decoding runs in a sandboxed process under `pledge("stdio recvfd audio")`. Oh, by the way, amused targets @@ -38,13 +38,23 @@ The fine man page has all nitty gritty details, but th - enqueue music with `amused add files...` - control the playback with `amused play|pause|toggle|stop` etc -Pro tip: amused plays well with find: +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's very handy in combo with amused too! +walk that provides 80% of what I do with find in 20% of the characters: - walk \*.opus ! amused add + walk \*.opus amused add (walk lives in my [dotfiles](//git.omarpolo.com/dotsnew))