rhythmbox-client(1) 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 running 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.
--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.
Multiple options can be combined using quotes. For example "%tn %aa %tt", will print the track number fol-
lowed by the artist and the 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
%ay Release year of album
%an Album disc number
%aN Album disc number with leading 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
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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE 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 3 Dec 2007 rhythmbox-client(1)