Music library: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Sho
mNo edit summary
>NedBot
m (Bot: Automated text replacement (-__NOEDITSECTION__ + ); cosmetic changes)
Line 1: Line 1:
{{XBMC wiki toc Inline}}
{{XBMC wiki toc Inline}}
__NOEDITSECTION__
 
__TOC__
__TOC__
The Music Library, one of the [[The XBMC Database|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.  
The Music Library, one of the [[The XBMC Database|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.  


{{TOCleft}}
{{TOCleft}}
[[image:Library.music.fanart.WSCR.jpg|480px]]
[[File:Library.music.fanart.WSCR.jpg|480px]]


==Preparing your Music to be Scanned==
== Preparing your Music to be Scanned ==
In order to be able to include information on your music collection in the Library, XBMC needs your music to be tagged. When your collection is scanned, XBMC stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.
In order to be able to include information on your music collection in the Library, XBMC needs your music to be tagged. When your collection is scanned, XBMC stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection.
If you have never taken the time to tag your music properly, the time is now! Today most media applications and players (iTunes / iPod for example) organize your music by this ID tag information.<br>
If you have never taken the time to tag your music properly, the time is now! Today most media applications and players (iTunes / iPod for example) organize your music by this ID tag information.<br />
'''Note:''' Your audio files '''MUST''' have a valid ID tag for them to work properly in the XBMC Music Library. There are third party applications available for download from the internet that allow you to add and manage ID tags in your music files.
'''Note:''' Your audio files '''MUST''' have a valid ID tag for them to work properly in the XBMC Music Library. There are third party applications available for download from the internet that allow you to add and manage ID tags in your music files.
{|
{|
| valign="top" |
| valign="top" |
;For information on preparing your music to be indexed see:
;For information on preparing your music to be indexed see:
*[[Preparing your Music]]
* [[Preparing your Music]]
|
|
|}
|}


==Scanning your music==
== Scanning your music ==
{|
{|
| valign="top" |
| valign="top" |
|
|
To scan your music collection into the Music Library, first make sure you are not in 'Library Mode' (checkmark on the left). Next browse to the location of your music collection and brings up the [[Music Navigation and Control#The Context Menu |The Context Menu]] menu with various options. Select the option labelled "Scan item to database". XBMC will then proceed to scan the selected music source in the background into the database/library. Once the scan is complete, you can browse your collection by selecting 'Library Mode'.<br>
To scan your music collection into the Music Library, first make sure you are not in 'Library Mode' (checkmark on the left). Next browse to the location of your music collection and brings up the [[Music Navigation and Control#The Context Menu|The Context Menu]] menu with various options. Select the option labelled "Scan item to database". XBMC will then proceed to scan the selected music source in the background into the database/library. Once the scan is complete, you can browse your collection by selecting 'Library Mode'.<br />
|
|
|}
|}


==Navigating your Library==
== Navigating your Library ==
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.
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.
{|
{|
|
|
[[image:Library.music.controls.jpg|right|360px]]
[[File:Library.music.controls.jpg|right|360px]]
| valign="top" |
| valign="top" |
; View:
; View:
Line 53: Line 53:
<div id="searching"></div>
<div id="searching"></div>


==Searching your Library==
== 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.'''
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.'''


==Party Mode==
== Party Mode ==
The Party Mode option allows you to randomly play music from your entire music or [[Music Videos|music video]] collection based on criteria specified in [[PartyMode.xsp]]. Simply build a  
The Party Mode option allows you to randomly play music from your entire music or [[Music Videos|music video]] collection based on criteria specified in [[PartyMode.xsp]]. Simply build a  
[[Playlists#Smart_Playlists|Smart Playlist]] and save it as '''partymode.xsp''' in [[The UserData Folder]].
[[Playlists#Smart Playlists|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.
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.


==Music Context Menu in Library Mode==
== Music Context Menu in Library Mode ==
You perform actions on your music files using the [[General_Navigation#Context_Menus|Context Menu]]. In Library Mode selecting an album, the following options are available:
You perform actions on your music files using the [[General Navigation#Context Menus|Context Menu]]. In Library Mode selecting an album, the following options are available:
{|
{|
|
|
[[image:Context.library.mymusic.jpg]]
[[File:Context.library.mymusic.jpg]]
|
|
; Queue Item
; Queue Item
Line 88: Line 88:
|}
|}


==Remote browsing==
== Remote browsing ==
To be able to browse the Music Library outside the GUI, like through [[The Web Interface]], you'll currently have to add a special [[Types of Media Sources#Music_Library|musicdb:// source]], which will show up as 'Library' under Music in the web interface.
To be able to browse the Music Library outside the GUI, like through [[The Web Interface]], you'll currently have to add a special [[Types of Media Sources#Music Library|musicdb:// source]], which will show up as 'Library' under Music in the web interface.


==Music Library Settings and Maintenance==
== Music Library Settings and Maintenance ==
The main Music Library settings can be accessed from the [[Music_Settings#Library|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.
The main Music Library settings can be accessed from the [[Music Settings#Library|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.


===advancedsettings.xml===
=== advancedsettings.xml ===
Some settings can only be altered through the [[advancedsettings.xml#<musiclibrary>|advancedsettings.xml]] file, such as settings affecting the "All" database nodes and they way tags are displayed.
Some settings can only be altered through the [[advancedsettings.xml#<musiclibrary>|advancedsettings.xml]] file, such as settings affecting the "All" database nodes and they way tags are displayed.


===Clean Music Library===
=== 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.
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.


[[category:Usage]]
[[Category:Usage]]
[[category:Library]]
[[Category:Library]]
[[category:Music Library]]
[[Category:Music Library]]

Revision as of 14:55, 7 September 2011

Template:XBMC wiki toc Inline  

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.

Library.music.fanart.WSCR.jpg

Preparing your Music to be Scanned

In order to be able to include information on your music collection in the Library, XBMC needs your music to be tagged. When your collection is scanned, XBMC stores all the tagging information (artist, album, year, genre, etc) in the database which allows you to efficiently search and manage your music collection. If you have never taken the time to tag your music properly, the time is now! Today most media applications and players (iTunes / iPod for example) organize your music by this ID tag information.
Note: Your audio files MUST have a valid ID tag for them to work properly in the XBMC Music Library. There are third party applications available for download from the internet that allow you to add and manage ID tags in your music files.

For information on preparing your music to be indexed see

Scanning your music

To scan your music collection into the Music Library, first make sure you are not in 'Library Mode' (checkmark on the left). Next browse to the location of your music collection and brings up the The Context Menu menu with various options. Select the option labelled "Scan item to database". XBMC will then proceed to scan the selected music source in the background into the database/library. Once the scan is complete, you can browse your collection by selecting 'Library Mode'.

Navigating your Library

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.

View
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
Search
You can search for a string anywhere in the XBMC music database, see more below.
Filter
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.

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.

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.

Music Context Menu in Library Mode

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

File:Context.library.mymusic.jpg

Queue Item
Adds the item to the Now Playing playlist.
Play
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.
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.
Settings
Opens the Music Settings menu.

Remote browsing

To be able to browse the Music Library outside the GUI, like through The Web Interface, you'll currently have to add a special musicdb:// source, which will show up as 'Library' under Music in the web interface.

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.

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.

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.