~ubuntu-branches/ubuntu/precise/rhythmbox/precise-201203091205

« back to all changes in this revision

Viewing changes to help/C/rhythmbox.xml

Tags: upstream-0.9.5
ImportĀ upstreamĀ versionĀ 0.9.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
 
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
 
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
4
  <!ENTITY legal SYSTEM "legal.xml">
5
 
  <!ENTITY GFDL SYSTEM "fdl-appendix.xml">
6
 
  <!ENTITY authors SYSTEM "authors.xml">
7
 
  <!ENTITY quick SYSTEM "quick-reference.xml">
8
 
  <!ENTITY user-guide SYSTEM "user-guide.xml">
9
 
  <!ENTITY version "0.0.3">
10
 
  <!ENTITY date "08.08.2003">
11
 
  <!ENTITY application "<application>Music Player</application>">
12
 
  <!ENTITY nyi "<note><para>Not yet implemented</para></note>">
13
 
  <!ENTITY playlist "playlist">
14
 
  <!ENTITY audio-formats "MP3, FLAC or Ogg/Vorbis">
 
5
  <!ENTITY appversion "0.9.4">
 
6
  <!ENTITY manrevision "2.0.2">
 
7
  <!ENTITY date "April 2006">
 
8
  <!ENTITY app "Rhythmbox Music Player">
15
9
]>
16
 
 
17
 
<!-- arch-tag: The toplevel glue for the English Rhythmbox DocBook documentation
18
 
  -->
19
 
 
20
 
<!--
21
 
      (Do not remove this comment block.)
22
 
  Template Maintained by the GNOME Documentation Project:
23
 
          http://developer.gnome.org/projects/gdp
24
 
  Template version: 2.0 beta
25
 
  Template last modified Feb 12, 2002
26
 
-->
27
 
 
28
10
<!--
29
11
      (Do not remove this comment block.)
30
12
  Version: 0.0.2
33
15
               Mark Finlay <sisob@eircom.net>
34
16
               Mark Humphreys <marquee@users.sourceforge.net>
35
17
-->
36
 
 
37
18
<!--
38
19
      (Do not remove this comment block.)
39
20
  Version: 0.0.3
41
22
  Maintainers:
42
23
               Mark Humphreys <marquee@users.sourceforge.net>
43
24
-->
44
 
 
 
25
<!--
 
26
      (Do not remove this comment block.)
 
27
  Version: 0.0.4
 
28
  Last modified: October 01, 2005
 
29
  Maintainers:
 
30
               Baptiste Mille-Mathias <baptiste.millemathias@gmail.com>
 
31
-->
45
32
<!-- =============Document Header ============================= -->
46
33
<article id="index" lang="en">
47
34
<!-- please do not change the id; for translations, change lang to -->
48
35
<!-- appropriate code -->
49
 
 
50
36
  <articleinfo>
51
 
    <title>&application; Manual</title>
52
 
    <copyright>
53
 
      <year>2002</year>
54
 
      <holder>Mark Finlay</holder>
55
 
    </copyright>
56
 
 
57
 
  <!-- translators: uncomment this:
58
 
 
 
37
        <title>&app; Manual V&manrevision;</title>
 
38
        <copyright>
 
39
                <year>2002</year>
 
40
                <holder>Mark Finlay</holder>
 
41
        </copyright>
 
42
        <copyright>
 
43
                <year>2002</year>
 
44
                <year>2002</year>
 
45
                <holder>Mark Humphreys</holder>
 
46
        </copyright>
 
47
        <copyright>
 
48
                <year>2005</year>
 
49
                <year>2006</year>
 
50
                <holder>Baptiste Mille-Mathias</holder>
 
51
        </copyright>
 
52
        <copyright>
 
53
                <year>2006</year>
 
54
                <holder>Victor Osadci</holder>
 
55
        </copyright>
 
56
 
 
57
<!-- translators: uncomment this:
59
58
  <copyright>
60
59
   <year>2000</year>
61
60
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
65
64
<!-- An address can be added to the publisher information.  If a role is
66
65
     not specified, the publisher/author is the same for all versions of the
67
66
     document.  -->
68
 
    <publisher>
69
 
      <publishername> GNOME Project </publishername>
70
 
    </publisher>
 
67
        <publisher>
 
68
                <publishername>GNOME Documentation Project</publishername>
 
69
        </publisher>
71
70
 
72
71
   &legal;
73
72
   <!-- This file  contains link to license for the documentation (GNU FDL), and
74
 
        other legal stuff such as "NO WARRANTY" statement. Please do not change
75
 
        any of this. -->
76
 
 
77
 
    <authorgroup>
78
 
      <author>
79
 
        <firstname>Mark</firstname>
80
 
        <surname>Finlay</surname>
81
 
        <affiliation>
82
 
          <orgname>GNOME Project</orgname>
83
 
          <address> <email>sisob@eircom.net</email> </address>
84
 
        </affiliation>
85
 
      </author>
86
 
<!-- This is appropriate place for other contributors: translators,
87
 
      maintainers,  etc. Commented out by default.
88
 
       <othercredit role="translator">
89
 
        <firstname>Latin</firstname>
90
 
        <surname>Translator 1</surname>
91
 
        <affiliation>
92
 
          <orgname>Latin Translation Team</orgname>
93
 
          <address> <email>translator@gnome.org</email> </address>
94
 
        </affiliation>
95
 
        <contrib>Latin translation</contrib>
96
 
      </othercredit>
97
 
-->
98
 
    </authorgroup>
 
73
   other legal stuff such as "NO WARRANTY" statement. Please do not change
 
74
   any of this. -->
 
75
   <authorgroup>
 
76
                <author>
 
77
                        <firstname>Mark</firstname>
 
78
                        <surname>Finlay</surname>
 
79
                        <affiliation>
 
80
                                <orgname>GNOME Documentation Project</orgname>
 
81
                                <address><email>sisob@eircom.net</email></address>
 
82
                        </affiliation>
 
83
                </author>
 
84
                <author>
 
85
                        <firstname>Mark</firstname>
 
86
                        <surname>Humphreys</surname>
 
87
                        <affiliation>
 
88
                                <orgname>GNOME Documentation Project</orgname>
 
89
                                <address><email>marquee@users.sourceforge.net</email></address>
 
90
                        </affiliation>
 
91
                </author>               
 
92
                <author role="maintainer">
 
93
                        <firstname>Baptiste</firstname>
 
94
                        <surname>Mille-Mathias</surname>
 
95
                        <affiliation>
 
96
                                <orgname>GNOME Documentation Project</orgname>
 
97
                                <address><email>baptiste.millemathias@gmail.com</email></address>
 
98
                        </affiliation>
 
99
                </author>
 
100
                <author>
 
101
                        <firstname>Victor</firstname>
 
102
                        <surname>Osadci</surname>
 
103
                        <affiliation>
 
104
                                <orgname>GNOME Documentation Project</orgname>
 
105
                                <address><email>Victor.Osadci.GNOME@xhtml.md</email></address>
 
106
                        </affiliation>
 
107
                </author>
 
108
   </authorgroup>
99
109
 
100
110
<!-- According to GNU FDL, revision history is mandatory if you are -->
101
111
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
102
 
<!-- Remember to remove the &manrevision; entity from the revision entries other
103
 
-->
104
 
<!-- than the current revision. -->
105
 
<!-- The revision numbering system for GNOME manuals is as follows: -->
106
 
<!-- * the revision number consists of two components -->
107
 
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
108
 
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
109
 
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
110
 
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
111
 
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
112
 
<!-- to V3.0, and so on. -->
113
 
<!--
114
 
    <revhistory>
115
 
      <revision>
116
 
        <revnumber>&app; Manual V&manrevision;</revnumber>
117
 
        <date>&date;</date>
118
 
        <revdescription>
119
 
          <para role="author">Documentation Writer 2
120
 
            <email>docwriter2@gnome.org</email>
121
 
          </para>
122
 
          <para role="publisher">GNOME Documentation Project</para>
123
 
        </revdescription>
124
 
      </revision>
125
 
     
126
 
 -->
127
 
    <releaseinfo>This is the &application; User's Manual
128
 
    </releaseinfo>
129
 
    <legalnotice>
130
 
      <title>Feedback</title>
131
 
      <para>To report a bug or make a suggestion regarding this package or
132
 
        this manual, follow the directions in the
133
 
        <ulink url="ghelp:gnome-feedback"
134
 
          type="help">GNOME Feedback Page</ulink>.
 
112
   <revhistory>
 
113
      <revision> 
 
114
                <revnumber>Rythmbox Music Player Manual V0.0.2</revnumber> 
 
115
                <date>October 2002</date> 
 
116
                <revdescription> 
 
117
                        <para role="author">Mark Finlay
 
118
                        </para>
 
119
                        <para role="publisher">GNOME Documentation Project</para>
 
120
                </revdescription> 
 
121
      </revision> 
 
122
      <revision> 
 
123
                <revnumber>Rythmbox Music Player Manual V0.0.3</revnumber> 
 
124
                <date>August 2003</date> 
 
125
                <revdescription> 
 
126
                        <para role="author">Mark Humphreys
 
127
                        </para>
 
128
                        <para role="publisher">GNOME Documentation Project</para>
 
129
                </revdescription> 
 
130
      </revision> 
 
131
      <revision> 
 
132
                <revnumber>Rythmbox Music Player Manual V0.0.4</revnumber> 
 
133
                <date>October 2005</date> 
 
134
                <revdescription> 
 
135
                        <para role="author">Baptiste Mille-Mathias
 
136
                        </para>
 
137
                        <para role="publisher">GNOME Documentation Project</para>
 
138
                </revdescription> 
 
139
      </revision> 
 
140
      <revision> 
 
141
                <revnumber>&app; Manual V&manrevision;</revnumber> 
 
142
                <date>&date;</date> 
 
143
                <revdescription> 
 
144
                        <para role="author">Luca Ferretti
 
145
                        </para>
 
146
                        <para role="publisher">GNOME Documentation Project</para>
 
147
                </revdescription> 
 
148
      </revision> 
 
149
    </revhistory> 
 
150
 
 
151
    <releaseinfo>This manual describes version &appversion; of Rhythmbox Music Player.
 
152
    </releaseinfo> 
 
153
    <legalnotice> 
 
154
      <title>Feedback</title> 
 
155
      <para>To report a bug or make a suggestion regarding the &app; application or
 
156
      this manual, follow the directions in the <ulink url="ghelp:gnome-feedback"
 
157
          type="help">GNOME Feedback Page</ulink>. 
135
158
      </para>
136
159
<!-- Translators may also add here feedback address for translations -->
137
 
    </legalnotice>
138
 
  </articleinfo>
139
 
  <indexterm><primary>&application;</primary></indexterm>
140
 
 
141
 
 <!-- ============= Document Body ============================= -->
142
 
 <!-- ============= Introduction ============================== -->
143
 
 
144
 
 
145
 
 <sect1 id="intro">
146
 
  <title>Introduction</title>
147
 
   <indexterm>
148
 
    <primary>ScrollKeeper</primary>
149
 
    <secondary>Examples</secondary>
150
 
    <tertiary>gdp-example2</tertiary>
151
 
   </indexterm>
152
 
 
153
 
  <sect2 id="aboutsk">
154
 
   <title>About &application;</title>
155
 
   <para>       
156
 
&application; is a ID3 organized, music library and player for your &audio-formats; music files.
157
 
<!--
158
 
&application; is a music player that lets you do everything from importing your audio cds into &audio-formats; format, to playing these music files and other music files you have. You can play your music with an assortment of visualization plugins and burn audio and MP3/OGG cds from your music files. It's a one-stop shopping application for all your music needs. -->
159
 
 
160
 
</para>
161
 
<para>
162
 
Current &application; features include:
163
 
</para>
164
 
<itemizedlist>
165
 
        <listitem>
166
 
        Play &audio-formats; music files from your ID3 organized Library.
167
 
        </listitem>
168
 
        <listitem>
169
 
        Display information on the songs through meta-data reading.
170
 
        </listitem>
171
 
        <listitem>
172
 
        Display songs in an organized view.
173
 
        </listitem>
174
 
        <listitem>
175
 
        Create &playlist; by dragging and dropping from the Library view.
176
 
        </listitem>
177
 
        <listitem>
178
 
        Search for entries in the Library.
179
 
        </listitem>
180
 
        <listitem>
181
 
        Listen to Internet radio stations. 
182
 
        </listitem>
183
 
<!--    <listitem>
184
 
        Visual effects to accompany the audio output.
185
 
        </listitem>
186
 
        <listitem>
187
 
        Audio CD Support. Play music directly off of a CD. 
188
 
        </listitem>
189
 
        <listitem>
190
 
        CD Ripping and Burning. &application; can be used to create custom CDs, based on a group of songs from the library. 
191
 
        </listitem> -->
192
 
 
193
 
</itemizedlist>
194
 
 
195
 
   </sect2>
196
 
 
197
 
 <sect2 id="aboutex">
198
 
   <title>About this Document</title>
199
 
 
200
 
<para>
201
 
     This is the &application; User Guide.
202
 
   </para>
203
 
   <para>
204
 
     This package is maintained in <ulink type="http"
205
 
     url="http://www.gnome.org/">GNOME</ulink> CVS
206
 
     in the <filename
207
 
     class="directory">rhythmbox</filename> module under 
208
 
     <filename class="directory">help</filename>.
209
 
   </para>
210
 
 
211
 
  </sect2>
212
 
 
213
 
&authors;
214
 
 </sect1>
215
 
&user-guide;
216
 
&quick;
 
160
    </legalnotice> 
 
161
 
 
162
   <abstract role="description">
 
163
     <para>Rhythmbox is the full featured music player for GNOME Desktop.</para>
 
164
   </abstract>
 
165
 
 
166
  </articleinfo> 
 
167
 
 
168
 
 
169
  <indexterm zone="index">
 
170
    <primary>Rhythmbox</primary>
 
171
  </indexterm>
 
172
  <indexterm zone="index">
 
173
    <primary>rhythmbox</primary>
 
174
  </indexterm>
 
175
  <indexterm zone="index">
 
176
    <primary>Music Player</primary>
 
177
  </indexterm>
 
178
<!-- ============= Document Body ============================= -->
 
179
<!-- ============= Introduction ============================== -->
 
180
  <sect1 id="introduction">
 
181
    <title>Introduction</title>
 
182
      <para>
 
183
        <application>&app;</application> is a music player and library for
 
184
        tagged files, that support various music formats.
 
185
      </para>
 
186
      <para>
 
187
        Current <application>&app;</application> features include:</para>
 
188
        <itemizedlist>
 
189
          <listitem>
 
190
            <para>Play various format music files from your tagged organized
 
191
            Library.</para>
 
192
          </listitem>
 
193
          <listitem>
 
194
            <para>Display information on the songs through meta-data reading.</para>
 
195
          </listitem>
 
196
          <listitem>
 
197
            <para>Display songs in an organized view.</para>
 
198
          </listitem>
 
199
          <listitem>
 
200
            <para>Create static playlists by dragging and dropping from the
 
201
            Library view.</para>
 
202
          </listitem>
 
203
          <listitem>
 
204
            <para>Create automatic playlists from criterias.</para>
 
205
          </listitem>
 
206
          <listitem>
 
207
            <para>Search for songs in the sources list like Library or
 
208
            Playlists.</para>
 
209
          </listitem>
 
210
          <listitem>
 
211
            <para>Listen to Internet radio stations.</para>
 
212
          </listitem>
 
213
          <listitem>
 
214
            <para>Read Audio CDs, and retrieve information like track title from
 
215
            the Internet.</para>
 
216
          </listitem>
 
217
          <listitem>
 
218
            <para>Burn Audio CDs from playlists.</para>
 
219
          </listitem>
 
220
        </itemizedlist>
 
221
  </sect1>
 
222
  <sect1 id="rb-getting-started">
 
223
        <title>Getting Started</title>
 
224
        
 
225
                <sect2 id="rb-launch">
 
226
                        <title>To Launch the <application>&app;</application></title>
 
227
                        <para>
 
228
                                You can launch the <application>&app;</application> in the following ways:
 
229
                                <variablelist>
 
230
                                        <varlistentry>
 
231
                                                <term><guimenu>Applications</guimenu> menu</term>
 
232
                                                <listitem>
 
233
                                                        <para>
 
234
                                                                Choose
 
235
                                                                <menuchoice><guisubmenu>Multimedia</guisubmenu>
 
236
                                                                <guimenuitem>Rhythmbox Music
 
237
                                                                Player</guimenuitem></menuchoice>.
 
238
                                                        </para>
 
239
                                                </listitem>
 
240
                                        </varlistentry>
 
241
                                        <varlistentry>
 
242
                                                <term>Command Line</term>
 
243
                                                <listitem>
 
244
                                                        <para>
 
245
                                                                Type <command>rhythmbox</command>, then press
 
246
                                                                <keycap>Return</keycap>.
 
247
                                                        </para>
 
248
                                                </listitem>
 
249
                                        </varlistentry>
 
250
                                </variablelist>
 
251
                        </para>
 
252
                </sect2>
 
253
                <sect2 id="rb">
 
254
                        <title>Running the Assistant</title>
 
255
                        <para>
 
256
                                The first time you launch the <application>&app;</application>, an 
 
257
                                assistant will help you import your music. On the second panel
 
258
                                of the assistant, press the <guibutton>Browse...</guibutton> button and 
 
259
                                select the folder where your music is stored.
 
260
                        </para>
 
261
                </sect2>
 
262
  </sect1>
 
263
  <sect1 id="rb-window">
 
264
    <title>&app; Window</title>
 
265
    <sect2 id="rb-window-intro">
 
266
      <title>Overview</title>
 
267
        <para>
 
268
                        The <application>&app;</application> window enables you to browse and play 
 
269
                        your favorite music. <xref linkend="fig-rb-window"/> shows the interface of
 
270
                        the <application>&app;</application> with its main components.
 
271
                </para>
 
272
        <figure id="fig-rb-window">
 
273
        <title>The <application>&app;</application> Window</title>
 
274
        <screenshot>
 
275
          <mediaobject>
 
276
            <imageobject>
 
277
              <imagedata fileref="figures/rb-window.png" format="PNG"/>
 
278
            </imageobject>
 
279
            <textobject>
 
280
                <phrase>Show the <application>&app;</application> window showing 
 
281
                the different parts on the <application>&app;</application> interface.
 
282
                                                Callouts: Menubar, Player area, Browser, Source list, Statusbar.
 
283
                                </phrase>
 
284
            </textobject>
 
285
          </mediaobject>
 
286
        </screenshot>
 
287
      </figure>
 
288
      <para>Table 1 describes the components of <application>&app;</application> window.</para>
 
289
      <table frame="topbot" id="table-rb-window">
 
290
        <title><application>&app;</application> Window Components</title>
 
291
        <tgroup cols="3" colsep="0" rowsep="0">
 
292
          <colspec colname="COLSPEC0"/>
 
293
          <colspec colname="COLSPEC1"/>
 
294
          <colspec colname="COLSPEC2"/>
 
295
          <thead>
 
296
            <row rowsep="1">
 
297
              <entry valign="top">Id</entry>
 
298
              <entry valign="top">Component</entry>
 
299
              <entry valign="top">Description</entry>
 
300
            </row>
 
301
          </thead>
 
302
          <tbody>
 
303
            <row>
 
304
              <entry valign="top">1</entry>
 
305
              <entry valign="top">Menubar</entry>
 
306
              <entry valign="top">Contains menus that you use to perform
 
307
                                                        tasks in <application>&app;</application> window.</entry>
 
308
            </row>
 
309
            <row>
 
310
              <entry valign="top">2</entry>
 
311
              <entry valign="top">Toolbar</entry>
 
312
              <entry valign="top">Provides access to player
 
313
                                                        functions and details about the currently playing track.</entry>
 
314
            </row>
 
315
            <row>
 
316
              <entry valign="top">3</entry>
 
317
              <entry valign="top">Time Slider</entry>
 
318
              <entry valign="top">Displays the position of the read of a track; 
 
319
                                                        it enables to jump to another part of a track.</entry>
 
320
            </row>
 
321
            <row>
 
322
              <entry valign="top">4</entry>
 
323
              <entry valign="top">Source List</entry>
 
324
              <entry valign="top">Displays a list of available
 
325
                                                        sources.</entry>
 
326
 
 
327
            </row>
 
328
            <row>
 
329
              <entry valign="top">5</entry>
 
330
              <entry valign="top">Browser</entry>
 
331
              <entry valign="top">Allows to browse and filter the
 
332
                                                        Library tracks by Genre, Artist or Album name. The
 
333
                                                        Browser also provides a search function to display only
 
334
                                                        tracks that match your criteria.</entry>
 
335
            </row>
 
336
            <row>
 
337
              <entry valign="top">6</entry>
 
338
              <entry valign="top">Tracks list</entry>
 
339
              <entry valign="top">Lists the tracks that belong to
 
340
                                                        the selected source.</entry>
 
341
            </row>
 
342
            <row>
 
343
              <entry valign="top">7</entry>
 
344
              <entry valign="top">Statusbar</entry>
 
345
              <entry valign="top">Displays informations about the
 
346
                                                        source selected in Source List.</entry>
 
347
            </row>
 
348
          </tbody>
 
349
        </tgroup>
 
350
      </table>
 
351
    </sect2>
 
352
    <sect2 id="intro-sourcelist">
 
353
      <title>The Source List</title>
 
354
      <para>The source list is where you can access your music library,
 
355
                        internet radio, your playlists and audio CDs. The source list can contain       
 
356
                        the following sources:
 
357
                                <itemizedlist>
 
358
                                  <listitem><para>The <application>&app;</application> library, where 
 
359
                                  all of the imported tracks will appear.</para></listitem>
 
360
                                  <listitem><para>The iRadio source, with all internet radio stations.
 
361
                                  </para></listitem>
 
362
                                  <listitem><para>Podcasts.</para></listitem>
 
363
                                  <listitem><para>All playlists (normal and smart).</para></listitem>
 
364
                                  <listitem><para>Audio CD's inserted into the computer's CD drives.
 
365
                                  </para></listitem>
 
366
                                  <listitem><para>Portable players like iPod plugged to your computer.
 
367
                                  </para></listitem>
 
368
                                  <listitem><para>The DAAP Music shares discovered on the local network.
 
369
                                  </para></listitem>
 
370
                                </itemizedlist>
 
371
                </para>
 
372
        <para>
 
373
                                The display of the source list can be toggled on or off by selecting
 
374
                                <menuchoice><guimenu>View</guimenu><guimenuitem>Source List</guimenuitem>
 
375
                                </menuchoice>.
 
376
                        </para>
 
377
    </sect2>
 
378
    <sect2 id="player-toolbar">
 
379
      <title>The Player Toolbar</title>
 
380
      <para>
 
381
                                The toolbar area provides access to details about the
 
382
                                currently playing track. When no track is being played, this
 
383
                                area shows no information. When a track is played, the track name
 
384
                                is displayed, and underneath, the artist and the album names.
 
385
                        </para>
 
386
      <para>
 
387
                                A tracker is also displayed, showing the progress of the
 
388
                                playing track. When the tracker has focus, the arrow keys can be used to
 
389
                                Fast-Forward or Rewind the playing track.
 
390
                        </para>
 
391
      <screenshot>
 
392
        <mediaobject>
 
393
          <imageobject>
 
394
            <imagedata fileref="figures/rb-toolbar.png" format="PNG"/>
 
395
          </imageobject>
 
396
          <textobject>
 
397
            <phrase>Shows player area</phrase>
 
398
          </textobject>
 
399
        </mediaobject>
 
400
      </screenshot>
 
401
      <tip>
 
402
        <para>
 
403
                                        If you are using a mouse with a scroll wheel, you can 
 
404
                                        adjust the volume by scrolling up or down while the mouse pointer 
 
405
                                        is over the volume button.
 
406
                                </para>
 
407
      </tip>
 
408
    </sect2>
 
409
    <sect2 id="status-area">
 
410
      <title>The Statusbar</title>
 
411
      <para>
 
412
                                The statusbar contains additional information about the number
 
413
                                of songs and the duration of the source selected. The display of the 
 
414
                                statusbar can be toggled on or off by selecting <menuchoice>
 
415
                                <guimenu>View</guimenu><guimenuitem>Statusbar</guimenuitem></menuchoice>.
 
416
                        </para>
 
417
      <screenshot>
 
418
        <mediaobject>
 
419
          <imageobject>
 
420
            <imagedata fileref="figures/rb-statusbar.png" format="PNG"/>
 
421
          </imageobject>
 
422
          <textobject>
 
423
            <phrase>Shows statusbar</phrase>
 
424
          </textobject>
 
425
        </mediaobject>
 
426
      </screenshot>
 
427
    </sect2>
 
428
    <sect2 id="rb-window-small">
 
429
      <title><application>&app;</application> Minimized Window</title>
 
430
      <para>
 
431
                                <application>&app;</application> comes with a minimized mode. This mode 
 
432
                                enables access only to the menubar and the player function of 
 
433
                                <application>&app;</application>.
 
434
                        </para>
 
435
      <para>
 
436
                                To switch to the small display, select <menuchoice><guimenu>View</guimenu>
 
437
                                <guimenuitem>Small Display</guimenuitem></menuchoice>. 
 
438
                        </para>
 
439
      <screenshot>
 
440
        <mediaobject>
 
441
          <imageobject>
 
442
            <imagedata fileref="figures/rb-window-small.png" format="PNG"/>
 
443
          </imageobject>
 
444
          <textobject>
 
445
            <phrase>Shows the <application>&app;</application> in small display mode</phrase>
 
446
          </textobject>
 
447
        </mediaobject>
 
448
      </screenshot>
 
449
    </sect2>
 
450
  </sect1>
 
451
  <sect1 id="Usage">
 
452
    <title>Using &app;</title>
 
453
    <sect2 id="Playing">
 
454
      <title>Playing Music</title>
 
455
      <para>To play a track, choose <menuchoice><guimenu>Control</guimenu>
 
456
      <guimenuitem>Play</guimenuitem></menuchoice>, or select the track and 
 
457
      press the <guibutton>Play</guibutton> button on the toolbar, or simply 
 
458
      double-click on the track to start playing.
 
459
                </para>
 
460
      <para>When track ends, <application>&app;</application> jumps to play next 
 
461
      track in the list showed in view pane.
 
462
                </para>
 
463
      <para>In the Library you can play all songs from an artist or a single 
 
464
      album simply selecting <guilabel>Album</guilabel> or <guilabel>Artist</guilabel> 
 
465
      entry in the <link linkend="library-filter-browser">library browser</link>.
 
466
                </para>
 
467
      <sect3 id="next-previous">
 
468
        <title>Next/Play/Previous</title>
 
469
        <para>The <guibutton>Next</guibutton> and <guibutton>Previous</guibutton> 
 
470
        buttons can be used to skip between tracks while playing. If a track is 
 
471
        currently playing, the previous button will restart the track. Pressing 
 
472
        the <guibutton>Play</guibutton> button will start playing the current track. 
 
473
                        <screenshot>
 
474
                                <mediaobject>
 
475
                                        <imageobject>
 
476
                                                <imagedata fileref="figures/rb-toolbar-prevplaynext.png" format="PNG"/>
 
477
                                        </imageobject>
 
478
                                        <textobject>
 
479
                                                <phrase>Shows buttons <guibutton>Previous</guibutton>,
 
480
                                                <guibutton>Play</guibutton> and <guibutton>Next</guibutton> in toolbar.</phrase>
 
481
                                        </textobject>
 
482
                                </mediaobject>
 
483
                        </screenshot>
 
484
                </para>
 
485
      </sect3>
 
486
      <sect3 id="repeat">
 
487
        <title>Repeat</title>
 
488
        <para>The option <guibutton>Repeat</guibutton> makes the 
 
489
        <application>&app;</application> restart to play tracks from the 
 
490
        beginning of the list when it reach the last track.</para>
 
491
        <para>To activate repeat, choose <menuchoice><guimenu>Control</guimenu>
 
492
        <guimenuitem>Repeat</guimenuitem></menuchoice>, or press the button 
 
493
        <guibutton>Repeat</guibutton> on the toolbar.
 
494
                        <screenshot>
 
495
                                <mediaobject>
 
496
                                        <imageobject>
 
497
                                                <imagedata fileref="figures/rb-toolbar-repeat.png" format="PNG"/>
 
498
                                        </imageobject>
 
499
                                        <textobject>
 
500
                                                <phrase>Shows repeat button in the statusbar.</phrase>
 
501
                                        </textobject>
 
502
                                </mediaobject>
 
503
                        </screenshot>
 
504
                </para>
 
505
      </sect3>
 
506
      <sect3 id="shuffle">
 
507
        <title>Shuffle</title>
 
508
        <para>The option <guibutton>Shuffle</guibutton> makes the 
 
509
        <application>&app;</application> play tracks in a random order.</para>
 
510
        <para>To activate shuffle, choose <menuchoice><guimenu>Control</guimenu>
 
511
        <guimenuitem>Shuffle</guimenuitem></menuchoice>, or press the button 
 
512
        <guibutton>Shuffle</guibutton> on the toolbar.
 
513
                        <screenshot>
 
514
                                <mediaobject>
 
515
                                        <imageobject>
 
516
                                                <imagedata fileref="figures/rb-toolbar-shuffle.png" format="PNG"/>
 
517
                                        </imageobject>
 
518
                                        <textobject>
 
519
                                                <phrase>Shows shuffle button in the statusbar.</phrase>
 
520
                                        </textobject>
 
521
                                </mediaobject>
 
522
                        </screenshot>
 
523
                </para>
 
524
      </sect3>
 
525
      <sect3 id="volume">
 
526
        <title>Volume Control</title>
 
527
        <para>
 
528
                                The volume control is located in the right hand of the toolbar.
 
529
                                Pressing the loudspeaker icon will show the volume slider.
 
530
                                Sliding this up and down will increase and decrease the volume.
 
531
                                The loudspeaker icon will change to reflect the relative volume.
 
532
                        <screenshot><mediaobject><imageobject><imagedata fileref="figures/rb-volume-changer.png" format="PNG"/></imageobject><textobject><phrase>Shows volume slider in toolbar.
 
533
                                </phrase></textobject></mediaobject></screenshot>
 
534
 
 
535
                        </para>
 
536
        <tip>
 
537
          <para>You can adjust the volume by using the mouse scroll wheel over 
 
538
          the loudspeaker icon.</para>
 
539
        </tip>
 
540
      </sect3>
 
541
    </sect2>
 
542
  </sect1>
 
543
  <sect1 id="library">
 
544
    <title>Library Source</title>
 
545
        <para>
 
546
                        The Library is the main source available in the
 
547
                        <application>&app;</application>, it is the
 
548
                        database that contains all the music files that you import in the 
 
549
                        <application>&app;</application> (The Library stores the path to access 
 
550
                        your music files, not the files themself).
 
551
                </para>
 
552
        <para>
 
553
                        The Library can not only contains music files which are physically 
 
554
                        on your computer (in your HOME Directory for instance), but it can
 
555
                        also contains music files available over remote network services. 
 
556
                        Some examples of supported network services are :
 
557
                        <itemizedlist>
 
558
                                <listitem>
 
559
                                        <para>Public FTP</para>
 
560
                                </listitem>
 
561
                                <listitem>
 
562
                                        <para>Authenticated FTP</para>
 
563
                                </listitem>
 
564
                                <listitem>
 
565
                                        <para>NFS</para>
 
566
                                </listitem>
 
567
                                <listitem>
 
568
                                        <para>Windows Share</para>
 
569
                                </listitem>
 
570
                        </itemizedlist>
 
571
                </para>
 
572
        <para>
 
573
                        The files imported in the Library are displayed in the track list
 
574
                        with the information (like the Artist name or the Album name) stored 
 
575
                        in the tags embedded on the tracks. <application>&app;</application> uses 
 
576
                        these tags to display the tracks in an organized manner.
 
577
                        <tip>
 
578
                                <para>At this time <application>&app;</application> is not able to modify the tags of
 
579
                                your music files, but you can use another software like
 
580
                                <application>Easytag</application>.</para>
 
581
                        </tip>
 
582
                </para>
 
583
    <sect2 id="library-tracks-add">
 
584
      <title>Add tracks in the Library</title>
 
585
                <para>
 
586
                                To add tracks to the Library, you can follow these different
 
587
                                methods:
 
588
                                <itemizedlist>
 
589
                                        <listitem>
 
590
                                                <para>
 
591
                                                        To import only one track, choose 
 
592
                                                        <menuchoice><guimenu>Music</guimenu><guimenuitem>Import File...
 
593
                                                        </guimenuitem></menuchoice> from the menu, then select the file
 
594
                                                        in the file selector and press the <guibutton>Open</guibutton> button.
 
595
                                                </para>
 
596
                                        </listitem>
 
597
                                        <listitem>
 
598
                                                <para>
 
599
                                                        If you want to import several music files located in a
 
600
                                                        folder, choose <menuchoice><guimenu>Music</guimenu><guimenuitem>Import
 
601
                                                        Folder...</guimenuitem></menuchoice> from the menu, then select the
 
602
                                                        folder in the file selector and press the 
 
603
                                                        <guibutton>Open</guibutton> button. All the music files located
 
604
                                                        in the folder and its sub-folders will be imported.
 
605
                                                </para>
 
606
                                        </listitem>
 
607
                                        <listitem>
 
608
                                                <para>
 
609
                                                        Drag and drop files from the file manager (like
 
610
                                                        <application>Nautilus</application>) over the Rhythmbox window.
 
611
                                                </para>
 
612
                                        </listitem>
 
613
                                </itemizedlist>
 
614
                        </para>
 
615
        <tip>
 
616
                <para>
 
617
                        If you have enabled the watch directory function (see <xref
 
618
                        linkend="prefs-library" />), all the music files
 
619
                        stored under the chosen directory will be added to the Library. New
 
620
                        files added later will be also added.
 
621
                        </para>
 
622
        </tip>
 
623
    </sect2>
 
624
    <sect2 id="library-tracks-del">
 
625
        <title>Remove tracks from the Library</title>
 
626
        <para>
 
627
                        To remove a track from the library but leave it on the disk, choose menu
 
628
                        <menuchoice><guimenu>Edit</guimenu><guimenu>Remove</guimenu></menuchoice>.
 
629
                        The track and its properties (like rating or the play count) are
 
630
                        removed from the Rhythmbox database.
 
631
                </para>
 
632
        <para>
 
633
                        To delete a track from the Library but also from your disk, choose
 
634
                        menu <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move to
 
635
                        Trash</guimenuitem></menuchoice>. The track will be removed in the
 
636
                        same way as previous, but the file will be moved in the file
 
637
                        manager Trash.
 
638
                </para>
 
639
    </sect2>
 
640
    <sect2 id="library-filter-search">
 
641
        <title>Find tracks using Search</title>
 
642
        <para>
 
643
                        Rhythmbox comes with a search function, which enables to find
 
644
                        and filter tracks by using a search term.
 
645
                </para>
 
646
        <para>
 
647
                        Enter some text in the search entry, and as you type, only
 
648
                        the tracks that match the text entered will be displayed. The search
 
649
                        function does the lookup in all the tags of the tracks stored in the
 
650
                        Library.
 
651
                </para>
 
652
                <para>
 
653
                        To perform more precise search, you can choose to lookup only
 
654
                        in specific tags <guilabel>Artists</guilabel>,
 
655
                        <guilabel>Albums</guilabel> or <guilabel>Titles</guilabel>.
 
656
                </para>
 
657
    </sect2>
 
658
    <sect2 id="library-filter-browser">
 
659
        <title>Find tracks using the Browser</title>
 
660
        <para>
 
661
                        The Browser is another convenient way to find tracks. The Browser
 
662
                        is a two or three pane view which enable to navigate among music genres,
 
663
                        artists and albums and display tracks that match the chosen criteria.
 
664
                </para>
 
665
        <para>
 
666
                        First, to display the Browser, select <menuchoice><guimenu>View</guimenu>
 
667
                        <guimenuitem>Browser</guimenuitem></menuchoice>. Select artist, album 
 
668
                        and genre, and as you choose, only the tracks that match your choice will 
 
669
                        be displayed in the track list. The criteria on the columns apply
 
670
                        from the left to the right.
 
671
                </para>
 
672
        <tip>
 
673
                <para>
 
674
                                You can choose several criteria of the same category by using the
 
675
                                key <keycombo><keycap>Ctrl</keycap></keycombo>.
 
676
                        </para>
 
677
        </tip>
 
678
                <para>
 
679
                                You can also find from a selected track in the track list, all the
 
680
                                tracks with the same genre, artist or album name. Select a track in
 
681
                                the track list, right-click on it, and choose <guilabel>Browse
 
682
                                this Genre/Artist/Album</guilabel>. Then the browser will filter the
 
683
                                tracks using the criteria chosen.
 
684
                        </para>
 
685
        </sect2>
 
686
  </sect1>
 
687
  <sect1 id="radio">
 
688
        <title>Radio Source</title>
 
689
    <para>
 
690
                The Internet Radio tuner can be used to listen to streamed audio files over a network, local or Internet.
 
691
        </para>
 
692
    <figure id="fig-iradio">
 
693
      <title>Internet Radio in <application>&app;</application></title>
 
694
      <screenshot>
 
695
        <mediaobject>
 
696
          <imageobject>
 
697
            <imagedata format="PNG" fileref="figures/rb-iradio-main.png"/>
 
698
          </imageobject>
 
699
        </mediaobject>
 
700
      </screenshot>
 
701
    </figure>
 
702
    <sect2 id="iradio-adding">
 
703
        <title>Adding a station</title>
 
704
        <para>
 
705
                        To add a new station to the Internet Radio tuner, choose <menuchoice><guimenu>Music</guimenu>
 
706
                        <guimenuitem>Add New Internet Radio Station</guimenuitem></menuchoice>, then enter the URL of
 
707
                        the Internet radio, then press the button <guibutton>Add</guibutton>.
 
708
                </para>
 
709
    </sect2>
 
710
    <sect2 id="iradio-modify">
 
711
        <title>Viewing and Changing the settings of a station</title>
 
712
        <para>
 
713
                        You can view and edit the settings of an Internet Radio station using the menu
 
714
                        <menuchoice><guimenu>Music</guimenu><guimenuitem>Properties</guimenuitem></menuchoice>.
 
715
                </para>
 
716
        <para>
 
717
                        You can also change the properties of a station by selecting the
 
718
                        station and right-click, then choose <guimenuitem>Properties</guimenuitem>.
 
719
                </para>
 
720
        <para>
 
721
                        When you access the properties of a radio stream, you can modify its title, its genre; you can 
 
722
                        also modify the stream location, and set a rating to it.
 
723
                </para>
 
724
    </sect2>
 
725
    <sect2 id="iradio-delete">
 
726
        <title>Removing a station</title>
 
727
        <para>
 
728
                        To remove a radio station from the radio stations list, choose <menuchoice><guimenu>Edit</guimenu>
 
729
                        <guimenuitem>Remove</guimenuitem></menuchoice>; you can also right-click on the station and select
 
730
                        <guimenuitem>Remove</guimenuitem>.
 
731
                </para>
 
732
    </sect2>
 
733
  </sect1>
 
734
  <sect1 id="podcast">
 
735
        <title>Podcast Source</title>
 
736
    <para>
 
737
                Podcasting is a new way to broadcast audio content over the web; when an
 
738
                author publishes an episode, podcast suscribers are informed, through an
 
739
                XML feed.
 
740
        </para>
 
741
    <para>
 
742
                Rhythmbox enables you to suscribe to podcast feeds, so when a new episode is 
 
743
                available you'll be informed, it will download this episode and it will
 
744
                play it.
 
745
        </para>
 
746
    <tip>
 
747
        <para>
 
748
                You can find more information about podcast and podcasting by visiting the
 
749
                definition of <ulink url="http://en.wikipedia.org/wiki/Podcast">Podcast</ulink> on the 
 
750
                site <ulink url="http://en.wikipedia.org/">Wikipedia</ulink>.
 
751
                </para>
 
752
    </tip>
 
753
    <para>
 
754
      <figure>
 
755
        <title>The Podcast interface</title>
 
756
        <mediaobject>
 
757
          <imageobject>
 
758
            <imagedata fileref="figures/rb-podcast-main.png" format="PNG"/>
 
759
          </imageobject>
 
760
          <textobject>
 
761
            <phrase>The Podcast interface with some registered podcasts</phrase>
 
762
          </textobject>
 
763
        </mediaobject>
 
764
      </figure>
 
765
    </para>
 
766
    <sect2 id="podcast-management">
 
767
      <title>Podcast Management</title>
 
768
      <sect3 id="podcast-feed-add">
 
769
        <title>Add a podcast</title>
 
770
        <para>
 
771
                        To register to a podcast, choose 
 
772
                        <menuchoice><guimenu>Music</guimenu><guimenuitem>New Podcast
 
773
                        Feed</guimenuitem></menuchoice>, then in the new window, enter the URL of
 
774
                        the podcast feed. Rhythmbox will retrieve the list of episodes and the 
 
775
                        latest episode will be downloaded on your hard disk.
 
776
                        </para>
 
777
        <para>
 
778
                        To add a new podcast feed, you can also right-click over the
 
779
                        <guimenuitem>Podcasts</guimenuitem>
 
780
                        source, and select <guimenuitem>New Podcast Feed</guimenuitem>.
 
781
                        </para>
 
782
      </sect3>
 
783
      <sect3 id="podcast-feed-del">
 
784
        <title>Delete a podcast</title>
 
785
        <para>
 
786
                        To delete a podcast, right-click on the podcast feed's name in the browser, and choose
 
787
                        <menuchoice><guimenuitem>Delete Podcast
 
788
                        Feed</guimenuitem></menuchoice>, then choose
 
789
                        <menuchoice><guimenuitem>Delete Feed Only</guimenuitem></menuchoice> if you want to keep the
 
790
                        podcast's episodes, or choose <menuchoice><guimenuitem>Delete Feed And
 
791
                        Item</guimenuitem></menuchoice> if you want to delete the feed and all its
 
792
                        related episodes.
 
793
                        </para>
 
794
      </sect3>
 
795
      <sect3 id="podcast-feed-update">
 
796
        <title>Update feeds</title>
 
797
        <para>
 
798
                        To know if new episodes have been published for a podcast,
 
799
                        right-click over the podcast name in the browser and choose
 
800
                        <menuchoice><guimenuitem>Update Podcast Feed</guimenuitem></menuchoice>. If new episodes
 
801
                        were pusblished, they will appear in the episode list.
 
802
                        </para>
 
803
        <tip>
 
804
          <para>
 
805
                        Rhythmbox checks regularly, by its own, the podcast feeds list
 
806
                        to know if they were updated.
 
807
                        </para>
 
808
        </tip>
 
809
        <para>
 
810
                        You can also check all podcasts, by right-clicking over the 
 
811
                        <menuchoice><guimenuitem>Podcasts</guimenuitem></menuchoice> source and choose
 
812
                        <menuchoice><guimenuitem>Update All Feeds</guimenuitem></menuchoice>.
 
813
                        </para>
 
814
      </sect3>
 
815
      <sect3 id="podcast-feed-show">
 
816
        <title>Access Podcast Feed properties</title>
 
817
        <para>
 
818
                        To access to the Feed properties, right-click on the Feed name, and
 
819
                        choose
 
820
                        <menuchoice><guimenuitem>Properties</guimenuitem></menuchoice>.
 
821
                        <itemizedlist><listitem><para>
 
822
                                                On the tab <guilabel>Basic</guilabel> you view the podcast
 
823
                                                <guilabel>Title</guilabel>, <guilabel>Author</guilabel>, the
 
824
                                                <guilabel>Last Updated</guilabel> date and the
 
825
                                                <guilabel>Description</guilabel>.
 
826
                                        </para></listitem><listitem><para>
 
827
                                                On the tab <guilabel>Details</guilabel> you view the feed 
 
828
                                                <guilabel>Source</guilabel>, <guilabel>Language</guilabel>, 
 
829
                                                and the <guilabel>Copyright</guilabel> properties.
 
830
                                        </para></listitem></itemizedlist>
 
831
                        You can view the properties, and also edit the rating.
 
832
                        </para>
 
833
      </sect3>
 
834
    </sect2>
 
835
    <sect2 id="episode-management">
 
836
      <title>Episode Management</title>
 
837
      <sect3 id="podcast-episode-download">
 
838
        <title>Download a podcast episode</title>
 
839
        <para>
 
840
                        To download an episode on your disk, right-click on the episode, and 
 
841
                        choose <menuchoice><guimenuitem>Download Post</guimenuitem></menuchoice>,
 
842
                        Rhythmbox will start to download the episode in the location defined in
 
843
                        the preferences. You can see the download progress of an episode in
 
844
                        the column <guilabel>Status</guilabel>.
 
845
                        </para>
 
846
        <tip>
 
847
          <para>
 
848
                        By default, podcasts are downloaded in folder <filename class="directory">Podcasts/</filename> in your home directory. To change location, 
 
849
                        see <xref linkend="prefs-podscast"/>.
 
850
                        </para>
 
851
        </tip>
 
852
      </sect3>
 
853
      <sect3 id="podcast-episode-read">
 
854
        <title>Read a podcast episode</title>
 
855
        <para>
 
856
                        To play a podcast episode, select the episode you want to read, and
 
857
                        choose
 
858
                        <menuchoice><guimenu>Control</guimenu><guimenuitem>Play</guimenuitem></menuchoice>;
 
859
                        you can also press the button <guibutton>Play</guibutton>.</para>
 
860
        <para>
 
861
                        The episode have to downloaded before to read it, see <xref linkend="podcast-episode-download"/> to know how to download a
 
862
                        podcast episode.
 
863
                        </para>
 
864
      </sect3>
 
865
      <sect3 id="podcast-episode-delete">
 
866
        <title>Delete a podcast episode</title>
 
867
        <para>
 
868
                        To delete an episode from a podcast, right-click on the episode, and
 
869
                        choose <menuchoice><guimenuitem>Delete</guimenuitem></menuchoice>,
 
870
                        then choose <menuchoice><guimenuitem>Delete Episode
 
871
                        Only</guimenuitem></menuchoice> if you to keep the episode file on
 
872
                        your disk, or choose <guibutton>Delete Episode And File</guibutton>
 
873
                        if you want to remove the episode from the list and delete the file from your disk.
 
874
                        </para>
 
875
        <warning>
 
876
          <para>
 
877
                        When you delete an episode, it won't be available no more in the
 
878
                        list of episodes, even if you update the podcast.
 
879
                        </para>
 
880
        </warning>
 
881
      </sect3>
 
882
      <sect3>
 
883
        <title>Display Podcast Episode properties</title>
 
884
        <para>
 
885
                        To access to the episode properties, right-click on the episode, and
 
886
                        choose
 
887
                        <menuchoice><guimenuitem>Properties</guimenuitem></menuchoice>.
 
888
                        <itemizedlist><listitem><para>
 
889
                                                On the tab <guilabel>Basic</guilabel> you view the podcast
 
890
                                                <guilabel>Title</guilabel>, <guilabel>Feed</guilabel>, the
 
891
                                                publication <guilabel>Data</guilabel> and the
 
892
                                                <guilabel>Description</guilabel>.
 
893
                                        </para></listitem><listitem><para>
 
894
                                                On the tab <guilabel>Details</guilabel> you view the podcast
 
895
                                                <guilabel>Source</guilabel>, <guilabel>Duration</guilabel>, the
 
896
                                                <guilabel>Bitrate</guilabel>, the <guilabel>Last Played
 
897
                                                Date</guilabel>, the <guilabel>Play count</guilabel> and
 
898
                                                the <guilabel>Rating</guilabel>.
 
899
                                        </para></listitem></itemizedlist>
 
900
                        </para>
 
901
      </sect3>
 
902
    </sect2>
 
903
  </sect1>
 
904
  <sect1 id="playqueue">
 
905
        <title>Play Queue Source</title>
 
906
        <para>
 
907
                Play queue is a source designed to store temporary the next tracks you
 
908
                want to play. When you add a track in Play Queue,
 
909
                <application>&app;</application> will automatically switch to this
 
910
                source, after the tracks played.
 
911
        </para>
 
912
        <para>
 
913
                Once a track been played, it will be automatically removed form the Play
 
914
                Queue Source.
 
915
                Once the Play Queue is empty, <application>&app;</application> will play the source which was
 
916
                played before.
 
917
        </para>
 
918
                <sect2 id="playqueue-track-add">
 
919
                        <title>Add a track in Play Queue</title>
 
920
                        <para>To add a track:
 
921
                                <orderedlist>
 
922
                                        <listitem>
 
923
                                                <para>
 
924
                                                        Select the track you want to play, in any
 
925
                                                        source.
 
926
                                                </para>
 
927
                                        </listitem>
 
928
                                        <listitem>
 
929
                                                <para>Choose
 
930
                                                <menuchoice><guimenu>Edit</guimenu><guimenuitem>Add to
 
931
                                                playqueue</guimenuitem></menuchoice>.</para>
 
932
                                        </listitem>
 
933
                                </orderedlist>
 
934
                        </para>
 
935
                </sect2>
 
936
                <sect2 id="playqueue-track-del">
 
937
                        <title>Remove a track in Play Queue</title>
 
938
                        <para>To remove a track stored in Play Queue:
 
939
                                <orderedlist>
 
940
                                        <listitem>
 
941
                                                <para>Select the track you want to remove in Play Queue
 
942
                                                source.</para>
 
943
                                        </listitem>
 
944
                                        <listitem>
 
945
                                                <para>Choose
 
946
                                                        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete</guimenuitem>
 
947
                                                        </menuchoice>.
 
948
                                                </para>
 
949
                                        </listitem>
 
950
                                </orderedlist>
 
951
                        </para>
 
952
                </sect2>
 
953
  </sect1>
 
954
  
 
955
  <sect1 id="playlist">
 
956
        <title>Playlists Source</title>
 
957
    <para>
 
958
                        Playlists are sources which are created from the tracks available in
 
959
                        the Library source. They enable to gather tracks following a
 
960
                        particular 'genre', a specific group of artists, or even tracks that 
 
961
                        are of a particular 'mood', or whatever you want.
 
962
        </para>
 
963
    <para>
 
964
                        Rhythmbox has 2 kinds of playlists:
 
965
                        <itemizedlist>
 
966
                                <listitem>
 
967
                                        <para>Static Playlists</para>
 
968
                                </listitem>
 
969
                                <listitem>
 
970
                                        <para>Smart Playlists</para>
 
971
                                </listitem>
 
972
                        </itemizedlist>
 
973
                </para>
 
974
    <para>
 
975
                        Rhythmbox lets you burn the tracks of your playlists to an Audio CD.
 
976
                </para>
 
977
    <sect2 id="playlist-static">
 
978
        <title>Static Playlists</title>
 
979
        <para>
 
980
                        Static playlists are playlists built from tracks dropped from the Library.
 
981
                </para>
 
982
      <sect3 id="playlist-static-new">
 
983
        <title>Create a static playlist</title>
 
984
        <para>
 
985
                        To create a new playlist, choose
 
986
                        <menuchoice><guimenu>Music</guimenu><guisubmenu>Playlist</guisubmenu><guimenuitem>New
 
987
                        Playlist</guimenuitem></menuchoice>. An empty playlist without name 
 
988
                        appears in the Source list. Enter a name for the playlist and press
 
989
                        <keycombo><keycap>Enter</keycap></keycombo>.
 
990
                </para>
 
991
      </sect3>
 
992
      <sect3 id="playlist-static-tracks-add">
 
993
        <title>Add tracks to a playlist</title>
 
994
        <para>
 
995
                                        To add tracks to a playlist, select tracks from the track
 
996
                                        list from the library and drag and drop your selection over the
 
997
                                        playlist icon in the Source list.
 
998
                                </para>
 
999
        <para>
 
1000
                                        You can also drop over a playlist a genre, an artist, or an
 
1001
                                        album name from the     browser, and all the tracks that belongs 
 
1002
                                        to the chosen category will be added to the playlist.
 
1003
                                </para>
 
1004
        <tip>
 
1005
          <para>You can create a playlist with tracks in one action. Select tracks from the <guilabel>Tracks List</guilabel>, or directly one or more categories from the browser (<guilabel>Genre</guilabel>, <guilabel>Artist</guilabel> or <guilabel>Album</guilabel>) and drop the selection over the <guilabel>Source List</guilabel>. It will create automatically a named playlist.</para>
 
1006
        </tip>
 
1007
      </sect3>
 
1008
      <sect3 id="playlist-static-tracks-del">
 
1009
        <title>Remove tracks from a playlist</title>
 
1010
        <para>
 
1011
                                        To remove tracks from a playlist, first select the tracks to
 
1012
                                        remove, and then you have two methods:
 
1013
                                        <itemizedlist><listitem><para>
 
1014
                                                                Choose
 
1015
                                                                <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete</guimenuitem></menuchoice>.
 
1016
                                                        </para></listitem><listitem><para>
 
1017
                                                                Right-click over the selection and choose <guimenuitem>Delete</guimenuitem>.
 
1018
                                                        </para></listitem></itemizedlist>
 
1019
                                        This operation deletes the track only from playlist and not
 
1020
                                        from the Library.
 
1021
                                </para>
 
1022
      </sect3>
 
1023
      <sect3 id="playlist-static-del">
 
1024
        <title>Delete a static playlist</title>
 
1025
        <para>
 
1026
                                        To delete a static playlist, select the playlist to delete,
 
1027
                                        then you have two ways to delete it:
 
1028
                                        <itemizedlist><listitem><para>
 
1029
                                                                Choose
 
1030
                                                                <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete</guimenuitem></menuchoice>.
 
1031
                                                        </para></listitem><listitem><para>
 
1032
                                                                Right-click over the playlist and choose <guimenuitem>Delete</guimenuitem>.
 
1033
                                                        </para></listitem></itemizedlist>
 
1034
                                        This operation deletes only the playlist and not the tracks
 
1035
                                        stored in the playlist deleted.
 
1036
                                </para>
 
1037
      </sect3>
 
1038
    </sect2>
 
1039
    <sect2 id="playlist-smart">
 
1040
      <title>Smart Playlists</title>
 
1041
      <para>
 
1042
                                Smart Playlists are playlists built from criterias, so their
 
1043
                                content is build dynamically; all the tracks matching criterias 
 
1044
                                will be added in the playlist.
 
1045
                        </para>
 
1046
      <sect3 id="playlist-smart-new">
 
1047
        <title>Create a smart playlist</title>
 
1048
        <para>
 
1049
                                        To create a new playlist:
 
1050
                                        <orderedlist><listitem><para>
 
1051
                                                                Choose <menuchoice><guimenu>Music</guimenu><guisubmenu>Playlist</guisubmenu><guimenuitem>New
 
1052
                                                                Automatic Playlist...</guimenuitem></menuchoice>.
 
1053
                                                        </para></listitem><listitem><para>
 
1054
                                                                Edit the playlist criterias through the query editor. 
 
1055
                                                        </para></listitem><listitem><para>
 
1056
                                                                Once your criterias chosen, click <guibutton>New</guibutton> to create the
 
1057
                                                                query.
 
1058
                                                        </para></listitem></orderedlist>
 
1059
                                </para>
 
1060
      </sect3>
 
1061
      <sect3 id="playlist-smart-edit">
 
1062
        <title>Edit a smart playlist</title>
 
1063
        <para>
 
1064
                                        Edit a smart playlist let you modify the criteria set for
 
1065
                                        this playlist. To edit a smart playlist, select the smart
 
1066
                                        playlist, choose
 
1067
                                        <menuchoice><guimenu>Music</guimenu><guisubmenu>Playlist</guisubmenu><guimenuitem>Edit...</guimenuitem></menuchoice>, and edit the criterias.
 
1068
                                        Once done, choose <guibutton>Close</guibutton>.
 
1069
                                </para>
 
1070
      </sect3>
 
1071
      <sect3 id="playlist-smart-del">
 
1072
        <title>Delete a smart playlist</title>
 
1073
        <para>
 
1074
                                        To delete a smart playlist, select the playlist to delete,
 
1075
                                        then you have two ways to delete it:
 
1076
                                        <itemizedlist><listitem><para>
 
1077
                                                                Choose
 
1078
                                                                <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete</guimenuitem></menuchoice>.
 
1079
                                                        </para></listitem><listitem><para>
 
1080
                                                                Right-click over the playlist and choose <guimenuitem>Delete</guimenuitem>.
 
1081
                                                        </para></listitem></itemizedlist>
 
1082
                                </para>
 
1083
      </sect3>
 
1084
      <sect3 id="playlist-smart-query-use">
 
1085
        <title>Use the query editor</title>
 
1086
        <para>
 
1087
                Choose the criteria to apply to the rule. If you need one
 
1088
                more criteria click on the button
 
1089
                <guibutton>Add</guibutton>, a new line appears, and you can
 
1090
                set a new criteria.
 
1091
                </para>
 
1092
        <para>
 
1093
                If you want to limit the number of tracks in the playlist,
 
1094
                tick <guilabel>Limit to:</guilabel>, and choose how to
 
1095
                limit. You can limit by tracks, by total size (in
 
1096
                <guilabel>MB</guilabel> or <guilabel>GB</guilabel>), or by
 
1097
                duration (expressed in <guilabel>Minutes</guilabel>).
 
1098
                </para>
 
1099
        <para>
 
1100
                Once you finish to set criteria for the playlist, choose
 
1101
                <guibutton>New</guibutton>; the playlist query editor window
 
1102
                closes, and the playlist display the tracks matched by your
 
1103
                criterias.
 
1104
                </para>
 
1105
      </sect3>
 
1106
    </sect2>
 
1107
  </sect1>
 
1108
  <sect1 id="AudioCD">
 
1109
    <title>Audio CD Source</title>
 
1110
        <para><application>&app;</application> can also handle Audio CDs; it can play
 
1111
        it, but it lets you also burn your own compilations.</para>
 
1112
    <sect2 id="cd-playing">
 
1113
      <title>Playing</title>
 
1114
      <para>When an Audio CD is inserted to the CD drive, it will appear in the
 
1115
          Source list, and the tracks on it can be displayed in
 
1116
          <application>&app;</application>'s main window. If you are connected to
 
1117
          Internet, the tracks name will be retrieve and displayed.
 
1118
                        </para>
 
1119
      <para>To play and pause playback, or to skip forward or backwards,
 
1120
                        use the same controls as used for playing from the library.
 
1121
                        </para>
 
1122
    </sect2>
 
1123
    <sect2 id="cd-import">
 
1124
      <title>Importing Audio CD</title>
 
1125
      <para>If you wish to keep the tracks of your Audio CDs on your computer,
 
1126
                        you can import them; the tracks will be saved as music files.</para>
 
1127
      <para>To import Audio CD tracks, choose <menuchoice><guimenu>Music</guimenu>
 
1128
          <guimenuitem>Import Audio CD...</guimenuitem></menuchoice>, it will start Sound-Juicer,
 
1129
                        a GNOME application dedicated to Audio CD import. To know more about Sound-Juicer, 
 
1130
                        you can read the <ulink url="ghelp:sound-juicer">Sound-Juicer manual</ulink>.</para>
 
1131
      <tip>
 
1132
        <para>To get imported tracks from Sound-Juicer automatically added to you Rhythmbox Library,
 
1133
                you will have to configure Sound-Juicer to extract tracks into your Rhythmbox Library location
 
1134
                and the Rhythmbox watch library feature has to be activated; refer to 
 
1135
                <ulink url="ghelp:sound-juicer#preferences">Sound-Juicer preferences</ulink> and 
 
1136
                <link linkend="prefs-library">Rhythmbox Library preferences</link>.
 
1137
                </para>
 
1138
      </tip>
 
1139
    </sect2>
 
1140
    <sect2 id="cd-burning">
 
1141
      <title>Creating Audio CD</title>
 
1142
      <para>Rhythmbox enables you to create you own Audio CDs with the music stored in the Rhythmbox Library.</para>
 
1143
      <para>To create an Audio CD: 
 
1144
                                <orderedlist><listitem><para>Create a playlist, static or smart
 
1145
                                (see <xref linkend="playlist"/>) and add tracks.</para></listitem><listitem><para>Choose <menuchoice><guimenu>Music</guimenu><guisubmenu>Playlist</guisubmenu><guimenuitem>Create Audio CD...</guimenuitem></menuchoice></para></listitem><listitem><para>Insert a blank CD.</para></listitem><listitem><para>Click the button <guibutton>Create</guibutton>, the burning process starts.</para></listitem></orderedlist>
 
1146
                        </para>
 
1147
    </sect2>
 
1148
  </sect1>
 
1149
  <sect1 id="portable-audio-player">
 
1150
    <title>Portable Audio Player Source</title>
 
1151
    <para><application>Rhythmbox</application> can detect when an portable audio player is plugged to your
 
1152
        computer, and is able to read tracks stored on it.
 
1153
        <application>&app;</application> should be able to deals with most of
 
1154
        portable audio players like Apple iPod.</para>
 
1155
    <para>At this time, Rhythmbox can only read information but cannot write
 
1156
        (like tags modification, tracks deletion or copy track from
 
1157
        <application>&app;</application> to your player).</para>
 
1158
    <para>When you plugged a Partable audio player, an icon of Portable Audio
 
1159
        Player id added in the Source List. This source works in the same way than the Library source.</para>
 
1160
        <tip><para>If <application>&app;</application> do not detect your device as
 
1161
        an portable audio player, you can create an empty file
 
1162
        <filename>.is_audio_player</filename> at the top level hierarchy of the
 
1163
        filesystem of your player.</para></tip>
 
1164
  </sect1>
 
1165
  <sect1 id="daap">
 
1166
    <title>DAAP Share Source</title>
 
1167
    <para>DAAP is a network protocol that allow to share the music stored in Rhythmbox. 
 
1168
        DAAP stands for Digital Audio Access Protocol.</para>
 
1169
    <para>As DAAP is a standard protocol for music sharing, you can listen and share music
 
1170
        not only with others Rhythmbox users, but also with other users who uses DAAP compatible
 
1171
        software like iTunes.</para>
 
1172
    <para>When you will start Rhythmbox, it will look for all DAAP shares
 
1173
        published on your local network (your home or your office, not the whole
 
1174
        Internet) by other users and will display them in the
 
1175
        <guilabel>Source</guilabel> list. In the same time Rhythmbox will publish 
 
1176
        your library and your playlists. So you can read music stored on your friends'computer
 
1177
        and they can listen your music.</para>
 
1178
    <para>To disable Rhythmbox DAAP sharing feature, see <xref
 
1179
        linkend="prefs-sharing"/> in the preferences.</para>
 
1180
  </sect1>
 
1181
  <sect1 id="notification">
 
1182
    <title>Notification Area</title>
 
1183
    <sect2 id="notification-overview">
 
1184
      <title>Overview</title>
 
1185
      <para>The Notification Area is a GNOME feature that adds a small icon to 
 
1186
      the panel while the program is running; this allows you to control 
 
1187
      <application>&app;</application> from your tray, and received information 
 
1188
      when the <application>&app;</application> interface is not visible.
 
1189
                </para>
 
1190
      <figure id="fig-notification-zone">
 
1191
        <title><application>&app;</application> in the Notification Area</title>
 
1192
        <screenshot>
 
1193
          <mediaobject>
 
1194
            <imageobject>
 
1195
              <imagedata format="PNG" fileref="figures/rb-notification-zone.png"/>
 
1196
            </imageobject>
 
1197
          </mediaobject>
 
1198
        </screenshot>
 
1199
      </figure>
 
1200
    </sect2>
 
1201
    <sect2 id="notification-info-receive">
 
1202
      <title>Get information</title>
 
1203
      <sect3 id="notification-info-tooltip">
 
1204
        <title>Tooltip information</title>
 
1205
        <para>When you move the mouse cursor over the 
 
1206
        <application>&app;</application> icon, you can see the track artist, 
 
1207
        the track name and the time position.</para>
 
1208
      </sect3>
 
1209
      <sect3 id="notification-info-window">
 
1210
        <title>Notification window</title>
 
1211
        <para>Each time the track has changed or a podcast episode was downloaded, 
 
1212
        the <application>&app;</application> can inform you; it displays a 
 
1213
        notification window on the desktop, containing the information.</para>
 
1214
        <figure id="fig-notification-window">
 
1215
          <title>The notification window of <application>&app;</application></title>
 
1216
          <screenshot>
 
1217
            <mediaobject>
 
1218
              <imageobject>
 
1219
                <imagedata format="PNG" fileref="figures/rb-notification-window.png"/>
 
1220
              </imageobject>
 
1221
            </mediaobject>
 
1222
          </screenshot>
 
1223
        </figure>
 
1224
        <tip>
 
1225
          <para>The notification window can be disabled by deselecting the 
 
1226
          <guilabel>Show Notifications</guilabel> option from the context menu of 
 
1227
          the icon in the notification area.
 
1228
                        .</para>
 
1229
        </tip>
 
1230
      </sect3>
 
1231
    </sect2>
 
1232
    <sect2 id="notification-control">
 
1233
      <title>Control Rhythmbox</title>
 
1234
      <para>Using the <application>&app;</application> icon in the notification 
 
1235
      area, the following commands can be sent to the application: 
 
1236
                </para>
 
1237
      <figure id="fig-notification-menu">
 
1238
        <title>Notification Area (showing menu)</title>
 
1239
        <screenshot>
 
1240
          <mediaobject>
 
1241
            <imageobject>
 
1242
              <imagedata format="PNG" fileref="figures/rb-notification-area-menu.png"/>
 
1243
            </imageobject>
 
1244
           </mediaobject>
 
1245
        </screenshot>
 
1246
      </figure>
 
1247
      <para>
 
1248
        <itemizedlist>
 
1249
          <listitem>
 
1250
            <para><guibutton>Play</guibutton> &mdash; If selected, plays the 
 
1251
            currently selected song.</para>
 
1252
          </listitem>
 
1253
          <listitem>
 
1254
            <para><guibutton>Previous</guibutton> &mdash; Skip to previous song 
 
1255
            in the selected source.</para>
 
1256
          </listitem>
 
1257
          <listitem>
 
1258
            <para><guibutton>Next</guibutton> &mdash; Skip to next song in the 
 
1259
            selected source.</para>
 
1260
          </listitem>
 
1261
          <listitem>
 
1262
            <para><guibutton>Show Window Player</guibutton> &mdash; Choose whether 
 
1263
            or not the <application>&app;</application> window is visible or not 
 
1264
            on the desktop.</para>
 
1265
          </listitem>
 
1266
          <listitem>
 
1267
            <para><guibutton>Show Notifications</guibutton> &mdash; Choose whether
 
1268
            or not the <application>&app;</application> will notify you about 
 
1269
            track changes and various information.</para>
 
1270
          </listitem>
 
1271
          <listitem>
 
1272
            <para><guibutton>Quit</guibutton> &mdash; Quit the 
 
1273
            <application>&app;</application>.</para>
 
1274
          </listitem>
 
1275
        </itemizedlist>
 
1276
        <tip>
 
1277
                <para>If you are using a mouse with a scroll wheel, you can adjust 
 
1278
                the volume by scrolling up or down while the mouse pointer is over 
 
1279
                the panel applet.
 
1280
                        </para>
 
1281
          <para>You can quickly toggle Play/Pause by pressing the middle mouse button.</para>
 
1282
        </tip>
 
1283
      </para>
 
1284
    </sect2>
 
1285
  </sect1>
 
1286
  <sect1 id="customize">
 
1287
    <title>Customizing &app;</title>
 
1288
    <para>
 
1289
        You can customize <application>&app;</application> to suit your requirements and
 
1290
        preferences. This section describes how to customize <application>&app;</application>.
 
1291
        </para>
 
1292
    <sect2 id="prefs">
 
1293
      <title>Setting Your Preferences</title>
 
1294
      <para>
 
1295
                Using the <guilabel>Preferences</guilabel> dialog you can customize how you 
 
1296
                want <application>&app;</application> to look and behave. To display the
 
1297
                <guilabel>Preferences</guilabel> dialog, choose 
 
1298
                <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.
 
1299
                </para>
 
1300
      <sect3 id="prefs-general">
 
1301
        <title>General</title>
 
1302
        <para>
 
1303
                        Choose the <guilabel>Visible Columns</guilabel> you want to
 
1304
                        display in <application>&app;</application>. This option is global and affects the
 
1305
                        following sources:
 
1306
                        <itemizedlist>
 
1307
                                <listitem><para>Library</para></listitem>
 
1308
                                <listitem><para>Audio CD</para></listitem>
 
1309
                                <listitem><para>Portable Players</para></listitem>
 
1310
                                <listitem><para>Playlists</para></listitem>
 
1311
                                <listitem><para>DAAP Music shares</para></listitem>
 
1312
                        </itemizedlist>
 
1313
                </para>
 
1314
      </sect3>
 
1315
      <sect3 id="prefs-library">
 
1316
        <title>Library</title>
 
1317
        <itemizedlist>
 
1318
          <listitem>
 
1319
            <para>
 
1320
                                Choose the way the <guilabel>Browser View</guilabel> will be displayed. 
 
1321
                                You can choose to use three or two panes.
 
1322
                        </para>
 
1323
          </listitem>
 
1324
          <listitem>
 
1325
            <para>
 
1326
                                The <guilabel>Library Location</guilabel> is a folder
 
1327
                                that <application>&app;</application> will monitor to find new songs. 
 
1328
                                When you add new audio files in this folder or its sub-folders with the 
 
1329
                                file browser (like Nautilus), <application>&app;</application> 
 
1330
                                will detect them and they will be added automatically in the Library.
 
1331
                        </para>
 
1332
            <warning>
 
1333
                <para>
 
1334
                                        Avoid to set your <filename class="directory">Home</filename> folder 
 
1335
                                        as library location because this feature is CPU consuming.
 
1336
                                </para>
 
1337
            </warning>
 
1338
            <para>
 
1339
                                To disable the watch functionality deselect 
 
1340
                                <guilabel>Watch my library for new files</guilabel>.
 
1341
                        </para>
 
1342
            <tip>
 
1343
                <para>If you want to add more than one folder to watch, 
 
1344
                use <application>gconf-editor</application> and add it to the list
 
1345
                /app/rhythmbox/library_locations
 
1346
                                </para>
 
1347
            </tip>
 
1348
          </listitem>
 
1349
        </itemizedlist>
 
1350
      </sect3>
 
1351
      <sect3 id="prefs-podscast">
 
1352
        <title>Podcasts</title>
 
1353
        <itemizedlist>
 
1354
          <listitem>
 
1355
            <para>
 
1356
                                The <guilabel>Download Location</guilabel> of Podcasts is defined 
 
1357
                                by default to Folder <filename class="directory">Podcasts/</filename>
 
1358
                                in your home directory.
 
1359
                        </para>
 
1360
            <para>
 
1361
                                If this location doesn't fit your       needs, select another folder 
 
1362
                                in the drop-down list or choose <guilabel>Other...</guilabel>
 
1363
                                to make the File Selector appears.
 
1364
                        </para>
 
1365
          </listitem>
 
1366
          <listitem>
 
1367
            <para>
 
1368
                                Choose the frequency that <application>&app;</application> will check for new
 
1369
                                podcast episodes.
 
1370
                        </para>
 
1371
          </listitem>
 
1372
        </itemizedlist>
 
1373
      </sect3>
 
1374
      <sect3 id="prefs-sharing">
 
1375
        <title>Sharing</title>
 
1376
        <para>The <application>&app;</application> can share your Library 
 
1377
        contents over your Local Area Network, to other 
 
1378
        <application>&app;</application> and Apple iTunes users.</para>
 
1379
        <itemizedlist>
 
1380
          <listitem>
 
1381
            <para>Select <guilabel>Share my music</guilabel> to enable
 
1382
                                        the users of your network to see and read your songs.</para>
 
1383
          </listitem>
 
1384
          <listitem>
 
1385
            <para>
 
1386
                                Enter the name of you want to appear of the network in
 
1387
                                the field <guilabel>Shared music name</guilabel>.</para>
 
1388
          </listitem>
 
1389
        </itemizedlist>
 
1390
      </sect3>
 
1391
      <sect3 id="prefs-lastfm">
 
1392
        <title>Last.fm profile</title>
 
1393
        <para>
 
1394
                        The Last.fm profile plugin collects information about the songs you listen to
 
1395
                        and sends it to the <ulink url="http://www.last.fm/">Last.fm</ulink> website,
 
1396
                        building up a profile of your listening habits.  With this profile, you can:
 
1397
                        <itemizedlist>
 
1398
                                <listitem>
 
1399
                                        <para>consult statistics, such as most played songs or most played artists.</para>
 
1400
                                </listitem>
 
1401
                                <listitem>
 
1402
                                        <para>receive recommendations about artists that you might like.</para>
 
1403
                                </listitem>
 
1404
                        </itemizedlist>
 
1405
                </para>
 
1406
        <warning>
 
1407
          <para>
 
1408
                    In order to use the Last.fm profile plugin, you must have a Last.fm account.  
 
1409
                        If you don't already have one, use the 
 
1410
                        <ulink url="http://www.last.fm/signup.php">Last.fm signup page</ulink> to 
 
1411
                        create one.  Enter your Last.fm account details in the <guilabel>Username</guilabel>
 
1412
                        and <guilabel>Password</guilabel> fields in the Last.fm profile plugin 
 
1413
                        configuration window.
 
1414
                  </para>
 
1415
        </warning>
 
1416
                <para>
 
1417
                    The configuration window for the Last.fm profile plugin also displays 
 
1418
                        status information.  If your Last.fm profile page shows that your 
 
1419
                        profile is not being updated, the information displayed here may 
 
1420
                        help you to diagnose the problem.
 
1421
                </para>
 
1422
      </sect3>
 
1423
    </sect2>
 
1424
  </sect1>
 
1425
  <sect1 id="shortcuts">
 
1426
    <title>Shortcuts</title>
 
1427
    <sect2 id="keyboard-keys">
 
1428
      <title>Keyboard Shortcuts</title>
 
1429
      <table frame="topbot" id="rb-shorcuts-1">
 
1430
                <title>Player Shortcuts</title>
 
1431
        <tgroup cols="2" colsep="0" rowsep="0">
 
1432
          <colspec colname="COLSPEC0" colwidth="30*"/>
 
1433
          <colspec colname="COLSPEC1" colwidth="70*"/>
 
1434
          <thead>
 
1435
            <row>
 
1436
              <entry>Shortcuts</entry>
 
1437
              <entry>Actions</entry>
 
1438
            </row>
 
1439
          </thead>
 
1440
          <tbody>
 
1441
            <row>
 
1442
              <entry>
 
1443
                <keycombo>
 
1444
                  <keycap>Alt</keycap>
 
1445
                  <keycap>Space</keycap>
 
1446
                </keycombo>
 
1447
              </entry>
 
1448
              <entry>
 
1449
                <para>Play / Pause</para>
 
1450
              </entry>
 
1451
            </row>
 
1452
            <row>
 
1453
              <entry>
 
1454
                <keycombo>
 
1455
                  <keycap>Alt</keycap>
 
1456
                  <keycap>Left</keycap>
 
1457
                </keycombo>
 
1458
              </entry>
 
1459
              <entry>
 
1460
                <para>Jump to the Previous Track / Back to the beginning of the track</para>
 
1461
              </entry>
 
1462
            </row>
 
1463
            <row>
 
1464
              <entry>
 
1465
                <keycombo>
 
1466
                  <keycap>Alt</keycap>
 
1467
                  <keycap>Right</keycap>
 
1468
                </keycombo>
 
1469
              </entry>
 
1470
              <entry>
 
1471
                <para>Jump to the Next Track</para>
 
1472
              </entry>
 
1473
            </row>
 
1474
            <row>
 
1475
              <entry>
 
1476
                <keycombo>
 
1477
                  <keycap>Ctrl</keycap>
 
1478
                  <keycap>R</keycap>
 
1479
                </keycombo>
 
1480
              </entry>
 
1481
              <entry>
 
1482
                <para>Enable / Disable Repeat play</para>
 
1483
              </entry>
 
1484
            </row>
 
1485
            <row>
 
1486
              <entry>
 
1487
                <keycombo>
 
1488
                  <keycap>Ctrl</keycap>
 
1489
                  <keycap>U</keycap>
 
1490
                </keycombo>
 
1491
              </entry>
 
1492
              <entry>
 
1493
                <para>Enable / Disable Shuffle play</para>
 
1494
              </entry>
 
1495
            </row>
 
1496
          </tbody>
 
1497
        </tgroup>
 
1498
      </table>
 
1499
      <table frame="topbot" id="rb-shorcuts-2">
 
1500
                <title>General Shortcuts</title>
 
1501
                <tgroup cols="2" colsep="0" rowsep="0">
 
1502
          <colspec colname="COLSPEC0" colwidth="30*"/>
 
1503
          <colspec colname="COLSPEC1" colwidth="70*"/>
 
1504
          <thead>
 
1505
            <row>
 
1506
              <entry>Shortcuts</entry>
 
1507
              <entry>Actions</entry>
 
1508
            </row>
 
1509
          </thead>
 
1510
          <tbody>
 
1511
            <row>
 
1512
              <entry>
 
1513
                <keycombo>
 
1514
                  <keycap>Ctrl</keycap>
 
1515
                  <keycap>A</keycap>
 
1516
                </keycombo>
 
1517
              </entry>
 
1518
              <entry>
 
1519
                <para>Select All</para>
 
1520
              </entry>
 
1521
            </row>
 
1522
            <row>
 
1523
              <entry>
 
1524
                <keycombo>
 
1525
                  <keycap>Shift</keycap>
 
1526
                  <keycap>Ctrl</keycap>
 
1527
                  <keycap>A</keycap>
 
1528
                </keycombo>
 
1529
              </entry>
 
1530
              <entry>
 
1531
                <para>Deselect All</para>
 
1532
              </entry>
 
1533
            </row>
 
1534
            <row>
 
1535
              <entry>
 
1536
                <keycombo>
 
1537
                  <keycap>Ctrl</keycap>
 
1538
                  <keycap>E</keycap>
 
1539
                </keycombo>
 
1540
              </entry>
 
1541
              <entry>
 
1542
                <para>Extract CD (launch Sound-Juicer)</para>
 
1543
              </entry>
 
1544
            </row>
 
1545
            <row>
 
1546
              <entry>
 
1547
                <keycombo>
 
1548
                  <keycap>Ctrl</keycap>
 
1549
                  <keycap>J</keycap>
 
1550
                </keycombo>
 
1551
              </entry>
 
1552
              <entry>
 
1553
                <para>Jump to playing song</para>
 
1554
              </entry>
 
1555
            </row>
 
1556
            <row>
 
1557
              <entry>
 
1558
                <keycombo>
 
1559
                  <keycap>Ctrl</keycap>
 
1560
                  <keycap>Y</keycap>
 
1561
                </keycombo>
 
1562
              </entry>
 
1563
              <entry>
 
1564
                <para>Clear the search field text and remove all filters in the browser</para>
 
1565
              </entry>
 
1566
            </row>
 
1567
            <row>
 
1568
              <entry>
 
1569
                <keycombo>
 
1570
                  <keycap>Ctrl</keycap>
 
1571
                  <keycap>N</keycap>
 
1572
                </keycombo>
 
1573
              </entry>
 
1574
              <entry>
 
1575
                <para>Create a New playlist</para>
 
1576
              </entry>
 
1577
            </row>
 
1578
            <row>
 
1579
              <entry>
 
1580
                <keycombo>
 
1581
                  <keycap>Ctrl</keycap>
 
1582
                  <keycap>I</keycap>
 
1583
                </keycombo>
 
1584
              </entry>
 
1585
              <entry>
 
1586
                <para>Add a new Internet Radio Station</para>
 
1587
              </entry>
 
1588
            </row>
 
1589
            <row>
 
1590
              <entry>
 
1591
                <keycombo>
 
1592
                  <keycap>Ctrl</keycap>
 
1593
                  <keycap>P</keycap>
 
1594
                </keycombo>
 
1595
              </entry>
 
1596
              <entry>
 
1597
                <para>Add a New Podcast Feed</para>
 
1598
              </entry>
 
1599
            </row>
 
1600
            <row>
 
1601
              <entry>
 
1602
                <keycombo>
 
1603
                  <keycap>Ctrl</keycap>
 
1604
                  <keycap>O</keycap>
 
1605
                </keycombo>
 
1606
              </entry>
 
1607
              <entry>
 
1608
                <para>Add a folder to the library</para>
 
1609
              </entry>
 
1610
            </row>
 
1611
            <row>
 
1612
              <entry>
 
1613
                <keycombo>
 
1614
                  <keycap>Alt</keycap>
 
1615
                  <keycap>Return</keycap>
 
1616
                </keycombo>
 
1617
              </entry>
 
1618
              <entry>
 
1619
                <para>Display the Track Properties</para>
 
1620
              </entry>
 
1621
            </row>
 
1622
          </tbody>
 
1623
        </tgroup>
 
1624
      </table>
 
1625
      <table frame="topbot" id="rb-shorcuts-3">
 
1626
                <title>Window Shortcuts</title>
 
1627
        <tgroup cols="2" colsep="0" rowsep="0">
 
1628
          <colspec colname="COLSPEC0" colwidth="30*"/>
 
1629
          <colspec colname="COLSPEC1" colwidth="70*"/>
 
1630
          <thead>
 
1631
            <row>
 
1632
              <entry>Shortcuts</entry>
 
1633
              <entry>Actions</entry>
 
1634
            </row>
 
1635
          </thead>
 
1636
          <tbody>
 
1637
                        <row>
 
1638
              <entry>
 
1639
                <keycombo>
 
1640
                  <keycap>Ctrl</keycap>
 
1641
                  <keycap>W</keycap>
 
1642
                </keycombo>
 
1643
              </entry>
 
1644
              <entry>
 
1645
                <para>Close the <application>&app;</application> window</para>
 
1646
              </entry>
 
1647
            </row>
 
1648
            <row>
 
1649
              <entry>
 
1650
                <keycombo>
 
1651
                  <keycap>Ctrl</keycap>
 
1652
                  <keycap>Q</keycap>
 
1653
                </keycombo>
 
1654
              </entry>
 
1655
              <entry>
 
1656
                <para>Quit the <application>&app;</application></para>
 
1657
              </entry>
 
1658
            </row>
 
1659
            <row>
 
1660
              <entry>
 
1661
                <keycombo>
 
1662
                  <keycap>Ctrl</keycap>
 
1663
                  <keycap>B</keycap>
 
1664
                </keycombo>
 
1665
              </entry>
 
1666
              <entry>
 
1667
                <para>Show / Hide the browser</para>
 
1668
              </entry>
 
1669
            </row>
 
1670
            <row>
 
1671
              <entry>
 
1672
                <keycombo>
 
1673
                  <keycap>Ctrl</keycap>
 
1674
                  <keycap>D</keycap>
 
1675
                </keycombo>
 
1676
              </entry>
 
1677
              <entry>
 
1678
                <para>Toggle / Untoggle the small display mode</para>
 
1679
              </entry>
 
1680
            </row>
 
1681
            <row>
 
1682
              <entry>
 
1683
                <keycombo>
 
1684
                  <keycap>Ctrl</keycap>
 
1685
                  <keycap>L</keycap>
 
1686
                </keycombo>
 
1687
              </entry>
 
1688
              <entry>
 
1689
                <para>Show / Hide the sources list</para>
 
1690
              </entry>
 
1691
            </row>
 
1692
            <row>
 
1693
              <entry>
 
1694
                <keycombo>
 
1695
                  <keycap>Ctrl</keycap>
 
1696
                  <keycap>K</keycap>
 
1697
                </keycombo>
 
1698
              </entry>
 
1699
              <entry>
 
1700
                <para>Show / Hide the Queue Sidebar</para>
 
1701
              </entry>
 
1702
            </row>
 
1703
            <row>
 
1704
              <entry>
 
1705
                <keycombo>
 
1706
                  <keycap>Ctrl</keycap>
 
1707
                  <keycap>S</keycap>
 
1708
                </keycombo>
 
1709
              </entry>
 
1710
              <entry>
 
1711
                <para>Show / Hide the Song Position Slider</para>
 
1712
              </entry>
 
1713
            </row>
 
1714
            <row>
 
1715
              <entry>
 
1716
                <keycombo>
 
1717
                  <keycap>Shift</keycap>
 
1718
                  <keycap>Ctrl</keycap>
 
1719
                  <keycap>T</keycap>
 
1720
                </keycombo>
 
1721
              </entry>
 
1722
              <entry>
 
1723
                <para>Show / Hide the Queue Sidebar</para>
 
1724
              </entry>
 
1725
            </row>
 
1726
            <row>
 
1727
              <entry>
 
1728
                <keycombo>
 
1729
                  <keycap>F11</keycap>
 
1730
                </keycombo>
 
1731
              </entry>
 
1732
              <entry>
 
1733
                <para>Toggle / Untoggle the Full Screen mode</para>
 
1734
              </entry>
 
1735
            </row>
 
1736
          </tbody>
 
1737
        </tgroup>
 
1738
      </table>
 
1739
    </sect2>
 
1740
    <sect2 id="multimedia-keys">
 
1741
      <title>Multimedia Keys</title>
 
1742
      <para><application>&app;</application> supports the keys on multimedia 
 
1743
      keyboards, if configured in your desktop environment.</para>
 
1744
      <table frame="none">
 
1745
                <title>Window Shortcuts</title>
 
1746
        <tgroup cols="2" colsep="0" rowsep="0">
 
1747
          <colspec colname="COLSPEC0"/>
 
1748
          <colspec colname="COLSPEC1"/>
 
1749
          <thead>
 
1750
            <row>
 
1751
              <entry>Shortcuts</entry>
 
1752
              <entry>Actions</entry>
 
1753
            </row>
 
1754
          </thead>
 
1755
          <tbody>
 
1756
            <row>
 
1757
              <entry>
 
1758
                <keycap>Stop</keycap>
 
1759
              </entry>
 
1760
              <entry>
 
1761
                <para>Stop</para>
 
1762
              </entry>
 
1763
            </row>
 
1764
            <row>
 
1765
              <entry>
 
1766
                <keycap>Pause / Play</keycap>
 
1767
              </entry>
 
1768
              <entry>
 
1769
                <para>Pause / Play</para>
 
1770
              </entry>
 
1771
            </row>
 
1772
            <row>
 
1773
              <entry>
 
1774
                <keycap>Prev</keycap>
 
1775
              </entry>
 
1776
              <entry>
 
1777
                <para>Previous Played Track</para>
 
1778
              </entry>
 
1779
            </row>
 
1780
            <row>
 
1781
              <entry>
 
1782
                <keycap>Next</keycap>
 
1783
              </entry>
 
1784
              <entry>
 
1785
                <para>Next Track</para>
 
1786
              </entry>
 
1787
            </row>
 
1788
          </tbody>
 
1789
        </tgroup>
 
1790
      </table>
 
1791
    </sect2>
 
1792
    <sect2 id="lirc">
 
1793
      <title>Linux Infrared Remote Control</title>
 
1794
      <para>The <application>&app;</application> includes a plugin for Linux 
 
1795
      Infrared Remote Control (LIRC) support. The following command strings are 
 
1796
      supported, using the program name 'rhythmbox': </para>
 
1797
      <table frame="none">
 
1798
                <title>Window Shortcuts</title>
 
1799
        <tgroup cols="2" colsep="0" rowsep="0">
 
1800
          <colspec colname="COLSPEC0"/>
 
1801
          <colspec colname="COLSPEC1"/>
 
1802
          <thead>
 
1803
            <row>
 
1804
              <entry>Command string</entry>
 
1805
              <entry>Action</entry>
 
1806
            </row>
 
1807
          </thead>
 
1808
          <tbody>
 
1809
            <row>
 
1810
              <entry> <keycap>play</keycap> </entry>
 
1811
              <entry> <para>Start playback</para> </entry>
 
1812
            </row>
 
1813
            <row>
 
1814
              <entry> <keycap>pause</keycap> </entry>
 
1815
              <entry> <para>Pause playback</para> </entry>
 
1816
            </row>
 
1817
            <row>
 
1818
              <entry> <keycap>shuffle</keycap> </entry>
 
1819
              <entry> <para>Toggle the shuffle play order</para> </entry>
 
1820
            </row>
 
1821
            <row>
 
1822
              <entry> <keycap>repeat</keycap> </entry>
 
1823
              <entry> <para>Toggle the repeat play order</para> </entry>
 
1824
            </row>
 
1825
            <row>
 
1826
              <entry> <keycap>next</keycap> </entry>
 
1827
              <entry> <para>Skip to the next track</para> </entry>
 
1828
            </row>
 
1829
            <row>
 
1830
              <entry> <keycap>previous</keycap> </entry>
 
1831
              <entry> <para>Skip to the previous track</para> </entry>
 
1832
            </row>
 
1833
            <row>
 
1834
              <entry> <keycap>seek_forward</keycap> </entry>
 
1835
              <entry> <para>Skip 10 seconds forward in the playing track</para> </entry>
 
1836
            </row>
 
1837
            <row>
 
1838
              <entry> <keycap>seek_backward</keycap> </entry>
 
1839
              <entry> <para>Skip 10 seconds backward in the playing track</para> </entry>
 
1840
            </row>
 
1841
            <row>
 
1842
              <entry> <keycap>volume_up</keycap> </entry>
 
1843
              <entry> <para>Increase the playback volume by 10%</para> </entry>
 
1844
            </row>
 
1845
            <row>
 
1846
              <entry> <keycap>volume_down</keycap> </entry>
 
1847
              <entry> <para>Decrease the playback volume by 10%</para> </entry>
 
1848
            </row>
 
1849
            <row>
 
1850
              <entry> <keycap>mute</keycap> </entry>
 
1851
              <entry> <para>Mute the playback</para> </entry>
 
1852
            </row>
 
1853
          </tbody>
 
1854
        </tgroup>
 
1855
      </table>
 
1856
    </sect2>
 
1857
  </sect1>
217
1858
</article>