# &application; Window

## Overview

The &application; window enables you to display and play your favorite music. Figure 1 shows the &application; window displaying the library.

The Library in the &application; Window

Show the &application; window showing Library. Callouts: Menubar, Player area, View pane, Side pane, Statusbar.

Table 1 describes the components of &application; window.

&application; Window Components

Component | Description
--- | ---
Menubar | Contains menus that you use to perform tasks in &application;.
Side pane | Enable you to switch between Library and &playlist;.
Player area | Provides access to details about the currently playing track and, in Library, enable you to search for a particular word or phrase.
View pane | Displays a list of available tracks from: Library Music groups Internet radio
Statusbar | Displays global informations about tracks in View Pane.

## The Side Pane

Shows side pane with library and &playlist; icons.

The side pane is where you can access your music library internet radio and your &playlist; .The side pane can contain the following icons:

- The &application; library, where all of the imported songs will appear.
- Any &playlist; that have been created from imported songs.
- Listen to Internet Radio stations.

The display of the side pane can be toggled on or off by selecting View Source List

## The Player Area

Shows player area

The 'player' area provides access to details about the currently playing track. When a track is not being played, this area shows no information. When 'Play' is selected, the track name is displayed, and underneath, the artist and the album names.

A tracker is also displays, showing the progress of the playing. When tracker has focus, the arrow keys can be used to Fast-Forward or Rewind the playing track.

Clicking on the artist or album name (where they are underlined) will load the appropriate 'allmusic.com' page.

If you are using a mouse with a scroll wheel, you can adjust the volume by scrolling up or down while the mouse pointer is over the volume button.

## The Statusbar

Shows statusbar

The statusbar contains additional information about the songs in the library or the &playlist;. In the left corner are two buttons for shuffling or repeating the songs. The display of the statusbar can be toggled on or off by selecting View Statusbar

## &application; Minimized Window

By using View Small Display the &application; window will be minimized displaying only the play area.

Shows player area in small display mode

# Using &application;

## Playing Music

To play a track, either select the track and press the Play button on the toolbar, or simply double-click on the track to start playing.

When track ends, &application; jump to play next track in the list showed in view pane.

In Library you can play all song from an artist or a single album simply select Album or Artist entry in library browser.

### Shuffle

Shows shuffle button in statusbar.

When this option is selected, the tracks in the browser are played in 'random' order.

### Repeat

Shows repeat button in statusbar.

When this option is selected, when the last track in the browser is played, the list is repeated from the beginning.

### Next/Play/Previous

Shows repeat button in toolbar.

The Next and Previous buttons can be used to skip between tracks whilst playing. If a song is currently playing, the previous button will restart the song. Clicking on the Play button will start &application; playing the current track. Whilst playing this will change to a Pause icon.

### Volume Control

Shows volume slider in toolbar.

volume control in the right hand of the player area. Clicking on the loudspeaker icon will show the volume slider. Sliding this up and down will increase and decrease the volume. The loudspeaker icon will change to reflect the relative volume.

## The Library

The &application; Library is an organized view of your music files. You can browse the Library by artist or by album. Once you have added a song to your Library you can play it directly or add it to a &playlist; to be played as part of a playlist.

Choose Organize Add to Library... to add music files to &application; Library. If you select a folder, all music file in all subfolders will be added to Library.

The library is located in the `.gnome2/rhythmbox` directory in your home directory. It is unique for each user on your system.

If you delete or move this directory a new, empty library will be created when the application is next opened.

### Adding Songs

A song can be added to the library in a few ways, as shown below;

- Choose Music Import Folder to add a single file or a whole folder to the library.
- Drag and drop from other applications. eg. Nautilus
- Opening a song/directory from Nautilus with &application;, using the context menu.
  The &application; context menu in Nautilus.

### Deleting Songs

To delete songs from the library, simply select the song then choose Edit Delete item or press the Delete key.

Once the last entry of an album (or artist) is deleted, the appropriate entry is also deleted from Library browser.

### Using the Browser

The Browser allows the library to be easily browsed, showing the artist, then album of the current track. It is not shown when viewing a &playlist;. Choose View Browser to change browser visibility.

The &application; browser

When started, the browser defaults to viewing all artists, and all tracks. Selecting an individual artist will change the Album list to show all albums by this artist, and the track list changes to show all tracks for these albums. Selecting an album will change the track list to show only the contents of this album.

### Properties

Choose Edit Properties to view the properties of a particular track .

The Basic tab shows the details of the song, as Title, Artist, Date.

Basic song properties

The Details tab of the dialog shows more detailed information about the file itself and its encoding. It also shows the associated with the file.

Details song properties

### Searching

To search the &application; library for a particular word or phrase, type into the search field, and the view will show all the entries that have the search criteria will be shown the in the tracks list.

Search name entry

## Statistics

&application; can maintain statistics on the use of the library. &application; automatically records the number of plays, the last played date and allows you to rating each track. You can access this information through Additional tab in dialog for each song or directly in the View Pane for all songs displayed in Library or &playlist;; you can add proper columns via the dialog.

application; statistic in View Pane

Show all statistic FIXME

### Ratings

This allows each song in the library to be rated on a scale of 1 to 5 stars. To rate a song:

- Select the song, choose Edit Properties, select Details tab, click in different part of Rating entry to set required rating

- Click in different parts of the Rating column in View Pane to set the required rating.

### Number of plays

Each time a track has completed playing, its play count is incremented by 1. This will allow the most popular songs in the library to be easily identified.

### Last played time

When the play count is incremented, the last played time is also recorded.

## Playlists

A &playlist; is an ad hoc list that has been created from songs in &application; library, to have a different sorting method from artist/album library default. It might consist of a list of songs of a particular 'genre', a specific group of artists, or even songs that are of a particular 'mood', or whatever you want.

To display the contents of a &playlist;, simply click on the required icon in side pane, and the view pane will change to show the contents.

### Creating &playlist;s

To create a &playlist; use one of the following methods:

- Choose Music Playlist New Playlist.... The new &playlist; will appear in the side pane and ask you for the name of the new &playlist;. Enter your desired name into the empty textbox.

  Dialog to create a new &playlist;

- Choose Music Playlist New Automatic Playlist.... A dialog is displayed prompting for your desired inclusion or exclusion criterias. You may add more filters by clicking the Add button. Once you are done a new &playlist; will be created basing on your selctions in the side pane. Enter in the empty texbox your desired name for the Automatic &playlist;.

  Dialog to create a new automatic &playlist;

- Choose Music Playlist Load Playlist... to load a previously saved &playlist; into &application;.

### Adding Songs

To add songs, album or artist to an already existing group just drag and drop it from the library to the &playlist;''s icon in the side pane.

### Deleting Songs

To delete songs from a &playlist;, simply select the song then choose Edit Delete Edit or simply press the Delete key.

### Remove a &playlist;

Right click on group icon in Side Pane to display the group menu. This will allow the deletion of the &playlist;. Selecting the Delete will delete the &playlist; (note that the 'content' of the &playlist; is not removed from the library, just the 'playlist'. An alternative way to do this is Music Playlist Remove....

### Changing the order of the &playlist;s in the side pane

To change the position of the &playlist; in the side pane simply drag it on the position you want to have it. The library and the radio playlist will remain always on top.

### Modify an automatic &playlist;

Right click on group icon in Side Pane to display the group menu. Selecting the Edit will allow you to modify the filters of the &playlist;.

## Internet Radio

### Listening via Internet

The Internet Radio tuner can be used to listen to streamed audio files.

Internet Radio in &application;

### Adding a station

New stations can be added to the Internet Radio tuner, using the Music Add New Internet Radio Station menuoption.

Adding a new station to &application;

### Changing the settings of a station

The settings of the Internet Radio stations can be changed, using the Music Preferences menuoption.

### Removing a station

Internet Radio stations can be removed from the tuner list. Right click on the station and select Delete to remove the station from the list.

## Panel Applet

The Notification Area is a Gnome feature that allows applications to add a small icon to the panel while the program is running. &application; adds it''s icon to the notification area and this allows you to control &application; from your tray.

Using the &application; icon in the notification area, the following commands can be sent to the application:

- Play | Pause — Play or Pause the currently selected song. This item changes depending on whether a song is playing or not.
- Previous — Skip to previous song in playlist.
- Next — Skip to next song in playlist.
- Show Window — choose whether or not the &application; window is visible or not.

If you are using a mouse with a scroll wheel, you can adjust the volume by scrolling up or down while the mouse pointer is over the panel applet.

&application; in the Gnome Notification Area

Notification Area (showing menu)

# Customizing &application;

You can customize &application; to suit your requirements and preferences. This section describes how to customize &application;.

## Preferences

Using the Preferences dialog you can customize how you want &application; to look. To display the Preferences dialog, choose Edit Preferences .

### Columns

This section of the dialog allows you to select which columns will be displayed.

General Preferences

Show the general &application; preferences dialog.

### Browser preferences

This section of the dialog allows you to select how the browser will be displayed.

Library Preferences

Show the library preferences dialog.

### iPod preferences

This section of the dialog allows you to select how the iPod browser will be displayed.

Library Preferences

Show the iPod preferences dialog.

Changing the preferences here will also change the settings of the library.