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