User Commands rhythmbox-client(1)
NAME
rhythmbox-client - controls a running instance of rhythmbox
SYNOPSIS
rhythmbox-client [--clear-queue] [--debug] [--
enqueue=filename] [--help] [--hide] [--mute] [--next] [--
no-present] [--no-start] [--notify] [--pause] [--play] [--
play-pause] [--play-uri=uri] [--previous] [--print-playing]
[--print-playing-format=format] [--print-volume] [--quit]
[--set-volume=float] [--unmute] [--volume-down] [--volume-
up]
DESCRIPTION
rhythmbox-client is a tool for controlling an already run-
ning instance of rhythmbox. It is useful for remote control
scripting or printing details of what is playing.
OPTIONS
The following options are supported:
--client-queue Empty the play queue before
adding new tracks.
--debug Display debug output.
--enqueue=filename Add specified tracks already
in the library to the play
queue.
-?, --help Show help options.
--hide Hide the rhythmbox-client
window.
--mute Mute playback.
--next Jump to next song.
SunOS 5.11 Last change: 3 Dec 2007 1
User Commands rhythmbox-client(1)
--no-present Do not present an existing
rhythmbox-client window.
--no-start Do not start a new instance
of rhythmbox-client.
--notify Show notification of the
playing song.
--pause Pause playback if currently
playing.
--play Resume playback if currently
paused.
--play-pause Toggle play/pause mode.
--play-uri=uri Play a specified uri,
importing it if necessary.
--previous Jump to previous song.
--print-playing Print the title and artist
of the playing song.
--print-playing-format=format Print the formatted details
of the song. Refer to the
extended description to see
valid format options. Mul-
tiple options can be com-
bined using quotes. For
example "%tn %aa %tt", will
print the track number fol-
lowed by the artist and the
SunOS 5.11 Last change: 3 Dec 2007 2
User Commands rhythmbox-client(1)
title of the track.
--print-volume Print the current playback
volume.
--quit Quit Rhythmbox.
--set-volume=float Set the playback volume.
--unmute Unmute playback
--volume-down Decreate the playback
volume.
--volume-up Increase the playback
volume.
EXTENDED DESCRIPTION
rhythmbox-client accepts the following format options to be
used with the --print-playing-format option:
%at Album title
%aT Album title in lowercase
%aa Album artist
%aA Album artist in lowercase
SunOS 5.11 Last change: 3 Dec 2007 3
User Commands rhythmbox-client(1)
%ay Release year of album
%an Album disc number
%aN Album disc number with lead-
ing zero
%ag Album genre
%aG Album genre in lowercase
%tt Track title
%tT Track title in lowercase
%ta Track artist
%tA Track artist in lowercase
%tn Track number
%tN Track number with leading
zero
%td Track duration
%te Elapsed time of track
SunOS 5.11 Last change: 3 Dec 2007 4
User Commands rhythmbox-client(1)
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
FILES
The following files are used by this application:
/usr/bin/rhythmbox-client
Executable for rhythmbox-client
/usr/lib/rhythmbox/plugins
Location of rhythmbox-client plugins.
/usr/share/gtk-doc/html/rhythmbox
Location of developer documentation for writing a
rhythmbox-client plugin.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWgnome-media-player
Interface stability Volatile
SEE ALSO
rhythmbox(1), attributes(5)
NOTES
Written by Brian Cameron, Sun Microsystems Inc., 2007.
SunOS 5.11 Last change: 3 Dec 2007 5
|
