Difference between revisions of "Music library"

From Official Kodi Wiki
Jump to: navigation, search
Line 141: Line 141:
== Playlists ==
== Playlists ==
== Smart playlists ==
{{main|Smart playlists}}
{{#lst:Smart playlists|intro}}
== Music Library Settings and Maintenance ==
== Music Library Settings and Maintenance ==

Revision as of 09:39, 29 January 2013


The Music Library, one of the XBMC databases, is a key feature of XBMC. It allows the organization of your music collection by information stored in your music file ID tag, like title, artist, album, genre and popularity.

  • Support for a countless number of formats and codecs.
  • A full-featured customizable music library that makes it easy to organize, find and listen to your favorite music
  • Support for Music Videos
  • Built in ability to stream media from other computers
  • Full support for Playlists, including Smart playlists
  • Jaw-dropping Visualizations that add the visual element to your music experience
  • Integrated CD Ripping


1 Adding music to the library

2 Music playback

See: Music playback

3 Navigating your library

3.1 Side bar

The library organizes your music into many categories, allowing you to find a specific song using one of many possible criteria. Below you can see root menu showing the different sections.

You can the toggle between the different display options, amongst others; List, Icons and Big Icons.
Sort By
You can choose what criteria to sort your music by. Note the arrow to the right which controls whether the items are sorted in ascending or descending order.
Library Mode
This control allows you to switch between Library Mode and File View. (used to be called Switch View)
Party Mode
See below.
Misc Options
You can search for a string anywhere in the XBMC music database, see more below.
Allows you to filter the library to only show albums, artists or songs that include the specified string in the name.
Hide Fanart
Hides Fanart in the chosen view.
Small Fanart
Shows a smaller version of the fanart instead of a scraped artist picture.

3.2 File mode

File mode is the most basic way of browing your music. In file mode, you browse through your sources folder by folder, in the exact same way they are stored. What you see in file mode is the same as you would see if you were to browse the folders on your computer.

3.3 Library mode

The library mode is much more advanced and has many more features than the Files View. It has features like song, album and artist info to name a few. In order to utilize library mode, you first need to scan your music into the Music library using the #Contextual menu.

4 Searching your Library

The search button is available on the left side of the 'Music' window, and is also available in the root listing of your music library. Select it to begin your search. A keyboard will pop-up where you may enter search terms (SMS style with the remote, or just using the virtual keyboard). As you enter more letters, the search will be performed in the background, and results displayed in the search node of the music library. Previous searches are saved, so if you return to the search node later on, it will have the results of your previous search. Artists and Albums are shown on top, followed by matching songs. If the search string you enter is less than 3 characters, XBMC will just search in the first word of each artist/album/song. Otherwise it will do a full word search. NOTE: In order to search within words as well as just for words beginning with your search string, place a % sign in front of the match.

5 Party Mode

The Party Mode option allows you to randomly play music from your entire music or music video collection based on criteria specified in PartyMode.xsp. Simply build a Smart Playlist and save it as partymode.xsp in The UserData Folder.

Selecting 'Party Mode' from the sidebar will play ALL valid media scanned into your libraries in a random order that meet the conditions specified in the Smart Playlist.

5.1 Frodo

The Party Mode option allows you to randomly play music from your entire music or music video collection based on criteria specified in PartyMode.xsp. Simply edited the "Party mode playlist" item in the Playlist menu. Bring up the context menu and select "Play in party mode". You can do this for any valid playlist.

6 Context Menu

In the default configuration you pop up the Context Menu using the 'C' key on your keyboard. If you are navigating XBMC using a remote control, the default button is, for some releases, the 'title' button. If your remote control has no 'title' button then you may need to remap the ContextMenu action to another button.

6.1 File mode

The context menu allows you to interact with the individual media items. The following options are available whilst in File Mode, selecting an album:


Queue Item
Adds the item to the Now Playing playlist
Play or (Play using...)
Plays the selected file. (Play using... depends on players available on your platform e.g. PAPlayer or DVDPlayer
Add to Favourites
Adds the item to your Favourites menu.
Album Information
Displays information about the item from allmusic.com. You can also highlight the item and press the Info button on the remote.
Delete selection from your sources (will delete actual files) Must be enabled in Appearance Settings.
Rename selection to something more to your liking. Must be enabled in Appearance Settings.
Scan Item to Library
Scans the item into the the Music Library. Performing this on a folder will cause every item in the folder to be scanned.
Switch Media
Allows you to switch to playback of other types of media (e.g. video files).
Go to Root
Takes you to the "Music" root folder.
Now Playing...
Takes you to the Now Playing screen that shows what is currently playing and what the next queued files are.
Opens the Music Settings menu.

Other possible menu items

Allows you to search for specific media

6.2 Library mode

You perform actions on your music files using the Context Menu. In Library Mode selecting an album, the following options are available:


Queue Item
Adds the item to the Now Playing playlist.
Plays the selected file.
Add to Favourites
Adds the item to your Favourites menu.
Album / Song Information
Shows the relevant information from allmusic.com.
Query Info For All Albums
Queries information from allmusic.com for all albums in the path.
Change scraper
Change scraper from current. see also: set content
Update Library
Checks if files in the Library have been changed, added or removed, modifies the database accordingly and runs a cleaning routine. Adds missing media to the database.
Go to Root
Takes you to the Music Library root.
Now Playing...
Takes you to Now Playing screen that shows what is currently playing and what the next queued files are.
Opens the Music Settings menu.

7 Karaoke

See: Karaoke

8 Playlists

9 Smart playlists

Kodi supports smart playlists for all types of media (excluding pictures), which essentially use a set of rules to limit the results from the databases. This means that to be able to create a smart playlist in the GUI, music/video must first be added to the libraries using a scraper addon or by creating NFO files. Smart playlist can be created either by using the built-in GUI smart playlist editor accessible from the Playlists section, or by creating an XML file with the extension XSP (XBMC Smart Playlist).

10 Music Library Settings and Maintenance

The main Music Library settings can be accessed from the Library tab in Music Settings. Those can be accessed either from the Settings menu from the home screen, or via the context menu as seen above.

10.1 advancedsettings.xml

Some settings can only be altered through the advancedsettings.xml file, such as settings affecting the "All" database nodes and they way tags are displayed.

10.2 Clean Music Library

Cleaning up the Music Library (removing invalid entries and compressing)can be done via the User Interface Settings, in the Music Settings with the Clean Library option.