~ubuntu-branches/ubuntu/oneiric/rhythmbox/oneiric

« back to all changes in this revision

Viewing changes to help/gl/rhythmbox.xml

  • Committer: Bazaar Package Importer
  • Author(s): Rico Tzschichholz
  • Date: 2011-07-29 16:41:38 UTC
  • mto: This revision was merged to the branch mainline in revision 191.
  • Revision ID: james.westby@ubuntu.com-20110729164138-wwicy8nqalm18ck7
Tags: upstream-2.90.1~20110802
ImportĀ upstreamĀ versionĀ 2.90.1~20110802

Show diffs side-by-side

added added

removed removed

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