Files
ming-wm/docs/window-likes/audio-player.md
stjet 2786865591 remove id3 dep; malvim qol
some clippy cleanup
2026-09-26 05:50:37 +00:00

36 lines
1.3 KiB
Markdown

Audio player with playlist and folder support. Requires the dev version of `alsa` lib.
## Commands
Type to write commands, backspace to delete last character, and enter to run command.
- `t`: Toggle pause/play
- `l`: Next/skip
- `j`: Volume down
- `k`: Volume up
- `b <dir>`: Set base directory (`<dir>` is path). Unless paths are absolute, they will be relative to what the base directory currently is (by default, `$HOME` is set, `/` otherwise)
- `p <dir / playlist file>`: Play audio files in `<dir>` or play the songs listed in the `<playlist file>`. Unless paths are absolute, they will be relative to the directory specified by the `b <dir>` command
- `a <dir / playlist file>`: Same as `p` but appends to the end of the queue instead of clearing the current song and the queue
Tab completion is supported for the `<dir>` and `<dir / playlist file>` arguments.
The copy shortcut will copy the currently playing song's file name, if there is a currently playing song.
## Artist Name
For mp3, artist name shows up only if there is an id3v1 tag present. For flac and mp4, the built-in metadata system should be supported.
## Playlists
Example playlist file:
```
hanyuu-maigo/オノマトペ
inabakumori/*
iyowa/*
such/Hegira
```
If there is no file extension, the player assumes `.mp3`.