rhythmbox-client(1) User Commands rhythmbox-client(1)NAMErhythmbox-client - controls a running instance of rhythmbox
SYNOPSISrhythmbox-client [--clear-queue] [--debug] [--enqueue=filename]
[--help] [--hide] [--mute] [--next] [--no-present] [--no-start]
[--notify] [--pause] [--play] [--play-pause] [--play-uri=uri] [--previ‐
ous] [--print-playing] [--print-playing-format=format] [--print-volume]
[--quit] [--set-volume=float] [--unmute] [--volume-down] [--volume-up]
DESCRIPTIONrhythmbox-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 rhythm‐
box-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 play‐
ing song.
--print-playing-format=format Print the formatted details of the
song. Refer to the extended descrip‐
tion to see valid format options. Mul‐
tiple options can be combined using
quotes. For example "%tn %aa %tt",
will print the track number followed 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 DESCRIPTIONrhythmbox-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 │gnome/media/gnome-media-player │
├─────────────────────────────┼───────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴───────────────────────────────┘
SEE ALSOrhythmbox(1), attributes(5)NOTES
Written by Brian Cameron, Sun Microsystems Inc., 2007.
SunOS 5.11 3 Dec 2007 rhythmbox-client(1)