Manual Pages for UNIX Operating System command usage for man rhythmbox-client

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.



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ______________________________________________________________
    |       ATTRIBUTE TYPE        |        ATTRIBUTE VALUE        |
    |_____________________________|_______________________________|
    | Availability                | gnome/media/gnome-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