add zuke(1) manpage (thanks kemal & humm)
This commit is contained in:
Sigrid
parent
5e81cc48bd
commit
fd785b5546
1 changed files with 174 additions and 0 deletions
174
sys/man/1/zuke
Normal file
174
sys/man/1/zuke
Normal file
|
|
@ -0,0 +1,174 @@
|
||||||
|
.TH ZUKE 1
|
||||||
|
.SH NAME
|
||||||
|
mkplist, zuke \- graphical music player
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B audio/mkplist
|
||||||
|
.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. Playlists are generated
|
||||||
|
by
|
||||||
|
.I mkplist
|
||||||
|
, which accepts files, directories, and URLs as its arguments and
|
||||||
|
writes the resulting playlist to standard output.
|
||||||
|
.PP
|
||||||
|
Formats supported by
|
||||||
|
.I zuke
|
||||||
|
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
|
||||||
|
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
|
||||||
|
.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
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
By default,
|
||||||
|
artist, album, title and duration are displayed, which corresponds to
|
||||||
|
.B "-c AatD."
|
||||||
|
.PP
|
||||||
|
.I Zuke
|
||||||
|
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
|
||||||
|
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
|
||||||
|
.TP
|
||||||
|
.B -
|
||||||
|
Lower the volume.
|
||||||
|
.TP
|
||||||
|
.B + =
|
||||||
|
Increase the volume.
|
||||||
|
.TP
|
||||||
|
.B ← →
|
||||||
|
Seek 10 seconds back/forward.
|
||||||
|
.TP
|
||||||
|
.B , .
|
||||||
|
Seek 60 seconds back/forward.
|
||||||
|
.TP
|
||||||
|
.B ↑ ↓ Pgup Pgdown Home End
|
||||||
|
Move withing the playlist.
|
||||||
|
.TP
|
||||||
|
.B o i
|
||||||
|
Move to the currently playing track.
|
||||||
|
.TP
|
||||||
|
.B Enter
|
||||||
|
Play the selected track.
|
||||||
|
.TP
|
||||||
|
.B > b
|
||||||
|
Skip to the next track.
|
||||||
|
.TP
|
||||||
|
.B < z
|
||||||
|
Skip to the previous track.
|
||||||
|
.TP
|
||||||
|
.B v
|
||||||
|
Stop
|
||||||
|
.TP
|
||||||
|
.B p c Space
|
||||||
|
Pause/Resume.
|
||||||
|
.TP
|
||||||
|
.B s
|
||||||
|
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
|
||||||
|
.PP
|
||||||
|
.I Zuke
|
||||||
|
can be controlled by emulating key presses via the plumber port
|
||||||
|
.I audio.
|
||||||
|
See examples section.
|
||||||
|
.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
|
||||||
|
audio/zuke < 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).
|
||||||
Loading…
Reference in a new issue