plan9fox/sys/man/1/zuke

185 lines
2.8 KiB
Plaintext
Raw Normal View History

.TH ZUKE 1
.SH NAME
mkplist, zuke \- graphical music player
.SH SYNOPSIS
.B audio/mkplist
[
.B -s
]
.I directory/file/URL [...]
.br
.B audio/zuke
[
.B -s
] [
.B -c
.I columns
]
.SH DESCRIPTION
.PP
.I Zuke
is a graphical music player that reads a playlist from standard input
and presents an interface to play music.
.PP
Playlists are generated by
2021-05-04 13:21:44 +00:00
.IR mkplist ,
which accepts files, directories, and URLs as its arguments,
and writes the resulting playlist to standard output. Option
.B -s
enables "simple" sorting of the entries of the playlist, where only
full paths are compared.
.PP
Formats supported by
.I zuke
2021-05-04 13:32:35 +00:00
are: MP3, OGG/Vorbis, FLAC, and WAV. With additional programs, Opus,
modules and M4A (AAC) can be played.
.I Zuke
also supports network streams, such as IceCast.
Option
.B -s
2021-05-04 13:32:35 +00:00
enables ``shuffle'' mode on start.
.PP
The columns (and their order) displayed can be changed by passing the
following letters along
.B -c
option:
.RS
2021-05-04 13:21:44 +00:00
.TF "c"
.TP
.B A
Artist
.TP
.B a
Album
.TP
.B b
File basename
.TP
.B t
Title
.TP
.B D
Duration
.TP
.B d
Date
.TP
.B T
Track number
.TP
.B p
Full file path
2021-05-04 13:21:44 +00:00
.PD
.RE
.PP
2021-05-04 13:32:35 +00:00
By default, artist, album, title, and duration are displayed, which
corresponds to
.B "-c AatD."
.PP
.I Zuke
2021-05-04 13:32:35 +00:00
can be controlled with a mouse, keyboard, and plumber. Button 1
selects a track, button 2 plays a track. Clicking on the seek bar
changes the playback position accordingly. On the right of the seek
2021-05-04 13:32:35 +00:00
bar, current position, track duration and volume are displayed. ``∫''
is shown if shuffle mode is enabled.
.PP
.I Zuke
provides a number of keyboard controls:
.RS
2021-05-04 13:21:44 +00:00
.TF "p c Space"
.TP
.B -
2021-05-04 13:21:44 +00:00
Lower volume.
.TP
.B + =
2021-05-04 13:21:44 +00:00
Increase volume.
.TP
.B ← →
Seek 10 seconds back/forward.
.TP
.B , .
Seek 60 seconds back/forward.
.TP
.B ↑ ↓ Pgup Pgdown Home End
2021-05-04 13:21:44 +00:00
Move within the playlist.
.TP
.B o i
2021-05-04 13:21:44 +00:00
Jump to current track.
.TP
.B Enter
2021-05-04 13:21:44 +00:00
Play selected track.
.TP
.B > b
2021-05-04 13:21:44 +00:00
Skip to next track.
.TP
.B < z
2021-05-04 13:21:44 +00:00
Skip to previous track.
.TP
.B v
Stop
.TP
.B p c Space
Pause/Resume.
.TP
.B s
2021-05-04 13:32:35 +00:00
Toggle ``shuffle''.
.TP
.B q Del
Quit.
.TP
.B /
Search forward.
.TP
.B ?
Search backwards.
.TP
.B n
Repeat search forward.
.TP
.B N
Repeat search backwards.
.RE
2021-05-04 13:21:44 +00:00
.PD
.PP
.I Zuke
can be controlled by emulating key presses via the plumber port
2021-05-04 13:32:35 +00:00
.IR audio .
.PP
Files present in the current playlist can be plumbed too, and will be
played immediately.
.SH EXAMPLES
Generate a playlist:
.IP
.EX
audio/mkplist /usr/glenda/music \\
file.mp3 \\
http://stream.nauticradio.net:14280/ > music.plist
.EE
.PP
Playing a playlist:
.IP
.EX
2021-05-04 13:21:44 +00:00
audio/zuke < music.plist
.EE
.PP
Append to a playlist:
.IP
.EX
audio/mkplist /n/moremusic >> music.plist
.EE
.PP
Skip to the next track using plumber:
.IP
.EX
plumb -d audio 'key >'
.EE
.SH SEE ALSO
.IR play (1)
.SH SOURCE
.B /sys/src/cmd/audio/zuke
.br
.B /sys/src/cmd/audio/libtags
.SH HISTORY
.I Zuke
first appeared in 9front (April, 2021).