1rhythmbox(1)                General Commands Manual               rhythmbox(1)
2
3
4

NAME

6       rhythmbox-client - controls a running instance of rhythmbox
7

SYNOPSIS

9       rhythmbox-client [option...][file...]
10

DESCRIPTION

12       rhythmbox-client  is a tool for controlling an already running instance
13       of rhythmbox.  It's useful for remote control  scripting,  adding  spe‐
14       cific  files  to  the  library  from  the shell, or printing details of
15       what's playing. Any files specified after the option arguments will  be
16       added to the library.  If the --enqueue option is given, the files will
17       also be added to the play queue.
18

OPTIONS

20       -?,--help
21              Show help options
22
23       --debug
24              Enable debug output
25
26       --no-start
27              Do not start a new instance of rhythmbox
28
29       --quit Quit rhythmbox
30
31       --no-present
32              Don't present an existing rhythmbox window
33
34       --hide Hide the rhythmbox window
35
36       --next Jump to next song
37
38       --previous
39              Jump to previous song
40
41       --notify
42              Show notification of the playing song
43
44       --play Resume playback if currently paused
45
46       --pause
47              Pause playback if currently playing
48
49       --play-pause
50              Toggle play/pause mode
51
52       --play-uri=URI
53              Play a specified URI, importing it if necessary
54
55       --enqueue
56              Add specified tracks already in the library to the play queue
57
58       --clear-queue
59              Empty the play queue before adding new tracks
60
61       --print-playing
62              Print the title and artist of the playing song
63
64       --print-playing-format=format
65              Print formatted details of the song (see FORMAT OPTIONS below).
66
67       --set-volume
68              Set the playback volume
69
70       --volume-up
71              Increase the playback volume
72
73       --volume-down
74              Decrease the playback volume
75
76       --print-volume
77              Print the current playback volume
78
79       --mute Mute playback
80
81       --unmute
82              Unmute playback
83

FORMAT OPTIONS

85       %at    album title
86
87       %aa    album artist
88
89       %aA    album artist (lowercase)
90
91       %as    album artist sortname
92
93       %aS    album artist sortname (lowercase)
94
95       %ay    album year
96
97       %ag    album genre
98
99       %aG    album genre (lowercase)
100
101       %an    album disc number
102
103       %aN    album disc number, zero padded
104
105       %st    stream title
106
107       %tn    track number (i.e 8)
108
109       %tN    track number, zero padded (i.e 08)
110
111       %tt    track title
112
113       %ta    track artist
114
115       %tA    track artist (lowercase)
116
117       %ts    track artist sortname
118
119       %tS    track artist sortname (lowercase)
120
121       %td    track duration
122
123       %te    track elapsed time
124
125       Variables can be combined using quotes. For example "%tn %aa %tt", will
126       print  the  track  number  followed  by the artist and the title of the
127       track.
128

AUTHOR

130       This manual page was written by Sven Arvidsson  <sa@whiz.se>,  for  the
131       Debian system (but may be used by others).
132

SEE ALSO

134       rhythmbox(1).
135
136
137
138GNOME                             2007-06-28                      rhythmbox(1)