NAME

qplay - a queue-able front-end for various audio players

SYNOPSIS

qplay [OPTIONS].. [FILE].. [DIR]..

DESCRIPTION

qplay is a front-end for mpg321 and ogg123. It can memorize songs to play next in a queue with high priority. After finishing playing the songs of the queue qplay returns to normal mode or to shuffle mode.

Per default qplay uses most of the vim keyboard control but it is fully configurable, too.

For playing different sound formats qplay uses modules and so it is extensible. Currently, the following audio formats are supported: mp3 (through mpg321), ogg Vorbis (through ogg123) and m3u-lists.

KEYBOARD CONTROL

<enter>

play selected song; command: play

<space>

pause song; command: pause

s

stop playing; command: stop

<CTRL>+l

repaint screen; command: clear

n

play next song; command: play next

N

play the fifth next song; command: play +5

p

play the last song; command: play prev

P

play the fifth last song; command: play +5

<Home>

select the first song in list; command: select first

<End>

select the last song in list; command: select last

<Up>, k

move the selection bar upwards; command: select prev

<Down>, j

move the selection bar downwards; command: select next

<PageUp>, <CTRL>+b

move the selection bar upwards by 25 songs; command: select -25

<PageDown>, <CTRL>+f

move the selection bar downwards by 25 songs; command: select +25

z

center the current playing song; command: select center

<CTRL>+e

scroll songlist downwards; command: select down

<CTRL>+y

scroll songlist upwards; command: select up

<Left>

rewind current playing song; command: seek -1

<Right>

wind current playing song; command: seek +1

<Insert>

insert selected song to queuelist; command: insert2queue

<Delete>

delete selected song from queuelist; command: deletefromqueue

O

sort songlist; command: sort

Z

randomize songlist; command: randomize

R

repeat mode: if the last song ist reached play starts with the first song; command: repeat

S

shuffle mode: plays a random song out of the list; command: shuffle

?

help screen (TODO...); command: help

q

quit qplay; command: quit

:

enter commandline mode; command: input

more commands for the commandline:

add

adds a new song to the list (e.g. "add /home/user/musik/neu/Juli-Perfekte Welle.mp3")

bind

binds a new key to a command (e.g. "bind t sort" -> sorting the list with key 't')

TODO...

OPTIONS

--version

output version information and exit

-d, --debug[=LEVEL]

set debug output level to LEVEL

-f, --file[=FILE]

load config file

-a, --add-all

add all file formats (by default only supported file formats are added to the list) TODO....

-i, --read-info

reads file information at startup (by default the information is read on play) TODO...

-r, --recursive

add subdirectories recursively

-i, --read-info

ds file information at startup (by default the information is read on play)

-R, -l, --repeat

repeat playlist

-s, --shuffle

shuffle mode

-Z, --randomize

randomize list

-L

read playlist in m3u-format, as created by xmms

-h, --help

display help and exit

SEE ALSO

ogg123(1), mpg123(1), mpg321(1)

FILES

/tmp/qplay.ctrl - Optional remote control fifo.

/etc/qplayrc - Optional configuration file.

~/.qplayrc - Optional configuration file.

AUTHOR

Written by jesus c. meyendriesch and Alexander Fieroch