gdam123(1)

NAME
gdam123 - an mpg123 clone that uses a gdam server.

SYNOPSIS
gdam123 [ --gdam-server gdamserver-location ] [ --device device_path ] [ --device-options device_options ] mp3 files, directories, or playlists...

DESCRIPTION
gdam123 is a clone of mpg123 that lets you use a gdam server instead of a raw sound device. It also provides many handy keyboard shortcuts.

KEYBOARD COMMANDS
gdam123 provides vi-style key bindings to control play. Most keys can be preceded by an integer argument, which causes the command to be repeated that many times.

j   skips one or more songs forward.

k   skips one or more songs forward.

G   skips to last song. nG skips to the nth song.

|   seeks to the first song. n| skips to the nth second of the current song.

^   seeks to the beginning of the current song.

h   seeks back one beat in the current song.

l   seeks forward one beat in the current song.

[   seeks forward one measure.

]   seeks forward one measure.

{   seeks forward four measures.

}   seeks forward four measures.

o   decreases volume 10%

p   increases volume 10%

i   stops and starts the song.

e   stops the song.

r   starts the song.

/   searches forward by song title.

?   searches backward by song title.

n   repeats last search.

N   repeats last search in opposite direction.

q   quits gdam123 gdam123 also provides ex-style commands. these commands are initiated by pressing ':'. the entire command need not be typed, only enough to uniquely distinguish it. some commands (i.e. delete) can be preceded by a range. a range is designated as a pair of numbers, seperated by a comma. the second number can be preceded by a + or -, to specify an endpoint relative to the first number. example: 2,5 specifies songs 2 through 5 while 12,+5 denotes songs 12 through 17.

append file, directory, or playlist
    add mp3 files, all the mp3 files within a directory, or the contents of a playlist file to the playlist.

[range] delete
    remove songs from the playlist. defaults to the current song.

[range] move [dest]
    moves a group of songs. dest of 0 signifies the beginning of playlist, dest of n will place the group after the current nth song.

[range] print
    print out the playlist.

[number] list
    lists current song and n songs preceeding and following it.

noclock
    stops the time display from being continually updated.

clock
    Starts the time display.

help
    print help message.

quit
    quits gdam123.

SEE ALSO
gdamcli(1) for a more flexible and complicated way to talk to a gdam server over a command line.

gdam-launcher(1) / "Queue" for a Gtk+ frontend to playing mp3s.