shithub: zuke

ref: 524e32b1cd45a332c58b8cd681662f815628deee
dir: /README.md/

View raw version
# zuke

A music player for Plan 9.

![screenshot](zuke.jpg)

With some stuff one expects from a music player:

 * gapless playback
 * seeking
 * playlists
 * good metadata support

## Installing

Install [libtags](https://git.sr.ht/~ft/libtags) first.

Clone the repo, do `mk install`.

Zuke comes with two programs.  One is `audio/zuke`, which is the player
itself.  The other one is `audio/mkplist`, it's used to make playlists
that are then fed to `audio/zuke`'s stdin:

```
% audio/mkplist /n/somefs/mymusic > $home/somefs.plist
% audio/zuke < $home/somefs.plist
```

Of course, one can combine these steps into one:

```
% audio/mkplist /n/music | audio/zuke
```

## Hot keys

```
-  volume down
+  volume up

left/right                  seek backwards/forward (10 seconds step)
, .                         seek backwards/forward (one minute step)
up down pgup pgdn home end  move within the playlist
o                           move to the currently playing track
enter                       play the selected track

> b    skip next
< z    skip prev
v      stop
p c    pause/resume
s      toggle shuffle
q/del  quit

/  search forward
?  search backwards
n  repeat search forward
N  repeat search backwards
```

## Mouse

```
left   - select a track
right  - menu
middle - play the track under the pointer
```