Commit Diff
Omar Polo <>
Thu Feb 17 11:45:26 2022 UTC
update readme
commit - 8e916714790046deccff6075357dc4fef087e9b4
commit + da045d77d15313594de2066d2a0eeeb7eb288790
blob - 0b167262dd4fc3c493139b681b43068ed7ce971a
blob + f6c782255d80418ef019687128dca0a764224dda
@@ -3,7 +3,7 @@ other tools, find(1) in particular.
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 @@ Pro tip: amused plays well with find:
- 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](//
Omar Polo