shithub: zuke

ref: 4af9aa84c706c45398c4c7d1b9e96fa814a45dc0
dir: zuke/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
 * basic livestreams (ie IceCast) 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 /n/otherfs/moremusic http://83.137.145.141:14280 > $home/somefs.plist
% audio/zuke < $home/somefs.plist
```

Of course, one can combine these steps into one:

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

## Columns to display

Zuke has an optional argument `-c` that specifies which columns to
display, the default is `-c AatD`.

```
A  artist
a  album
t  title
D  duration
d  date
T  track number
p  file path
```

## 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 i                         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
```