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)