Adding music to the library: Difference between revisions
m (Bot: Automated text replacement (-XBMC +{{name}})) |
m (Robot: Substituting template: Name) |
||
Line 1: | Line 1: | ||
{{mininav|[[Music library]]}} | {{mininav|[[Music library]]}} | ||
{{cleanup}} | {{cleanup}} | ||
<section begin="intro"/> | <section begin="intro"/>XBMC adds music to the library by [[Adding music to the library#Scanning Your Music Into the Music Library|scanning]] music files to extract identifying information from tags in the files. In order to be able to include information on your music collection in the '''[[music 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.<section end="intro"/> | ||
Your audio files '''MUST''' have a valid ID tag for them to work properly in the | 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. | ||
== See also audio streams == | == See also audio streams == | ||
Line 9: | Line 9: | ||
== Scanning Your Music Into the Music Library == | == Scanning Your Music Into the Music Library == | ||
[[File: | [[File:XBMC12_Scan_Music_Library.jpeg|right|500px]]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 bring up the the [[Music library#Context Menu|Context Menu]]. (The selected item can be a music file, a folder containing music files, or a folder containing other folders.) Select the option labelled "Scan Item to Library". XBMC will then scan the selected music source into the library database. Once the scan is complete, you can browse your collection by selecting 'Library Mode'. | ||
{{-}} | {{-}} | ||
[[File:Update_Library_startup.png|left|500px]]You can simplify the library maintenance by selecting the option "Update library on startup" (Menu System > Settings > Music > Library). This way, each time you start your | [[File:Update_Library_startup.png|left|500px]]You can simplify the library maintenance by selecting the option "Update library on startup" (Menu System > Settings > Music > Library). This way, each time you start your XBMC, the sources will be scanned and library updated with the new contents. You can still, off course, scan manually the sources as explained just before. | ||
{{-}} | {{-}} | ||
== Sources for Music == | == Sources for Music == | ||
{{main|Media sources}} | {{main|Media sources}} | ||
XBMC gives you the ability to listen to music from a variety of sources, click here for more information and examples of [[Types of Media Sources|Types of Media Sources (link)]].<br /> | |||
Some examples of sources that allow you to easily access all your digital music collection: | Some examples of sources that allow you to easily access all your digital music collection: | ||
* '''On your computer or a [[NAS (Network Attached Storage)]] device/system, which supports [[SMB]] file sharing''' | * '''On your computer or a [[NAS (Network Attached Storage)]] device/system, which supports [[SMB]] file sharing''' | ||
Line 29: | Line 29: | ||
== Applications to edit music Tags == | == Applications to edit music Tags == | ||
Your audio files '''MUST''' have correct audio tags to use the Music Library mode. Without tags you're limited to the fileview in | Your audio files '''MUST''' have correct audio tags to use the Music Library mode. Without tags you're limited to the fileview in XBMC. There are several tools out there that will allow you to manipulate music ID tags. | ||
* [[Supplemental tools/Linux#Music tools]] | * [[Supplemental tools/Linux#Music tools]] | ||
Line 39: | Line 39: | ||
For many categories, such as genres and artists, | For many categories, such as genres and artists, XBMC supports multiple values in the one field. By default it uses the character sequence " / " to divide the entry into multiple values. This divider may be changed via [[advancedsettings.xml]]. | ||
=== Artist Tags - Resolving Compilations and Multiple Artists === | === Artist Tags - Resolving Compilations and Multiple Artists === | ||
XBMC reads the ''Album Artist'' tag in ID3, Ogg, APE and MP4 tags and uses it if available to assign an artist to the album (independently of the track's artist information). This is the "Album Artist" tag (in ID3 this is represented by the "TPE2" tag; in vorbiscomment (ogg) files "ALBUMARTIST", "ALBUM ARTIST" and "ENSEMBLE" are all supported). Multiple artists for either a track or album artist can be specified in "Artist1 / Artist2 / Artist3" format. | |||
If no ''Album Artist'' tag exists, | If no ''Album Artist'' tag exists, XBMC will use the first (primary) artist from the tracks as the ''Album Artist''. Essentially we do a string comparison of all the track artists, and assign the common artists as the ''Album artist''. This is generally the TPE1 tag in ID3. | ||
As many users don't yet use the ''Album Artist'' tag, | As many users don't yet use the ''Album Artist'' tag, XBMC has an additional filter system for identifying compilation albums, where each track normally has a different artist. As XBMC scans a folder, it does the following: | ||
# Identifies albums based on ''Album'' name alone in the folder and groups the songs that have the same ''Album'' name together as an album. | # Identifies albums based on ''Album'' name alone in the folder and groups the songs that have the same ''Album'' name together as an album. | ||
# Runs through each album's assigned songs. If there is 2 or more tracks with the same ''Track'' number, the group of songs must come from 2 or more albums, so the ''Album'' name is ruled out as a possible compilation. | # Runs through each album's assigned songs. If there is 2 or more tracks with the same ''Track'' number, the group of songs must come from 2 or more albums, so the ''Album'' name is ruled out as a possible compilation. | ||
# If any of the songs assigned to the ''Album'' name have an ''Album Artist'' tag, then | # If any of the songs assigned to the ''Album'' name have an ''Album Artist'' tag, then XBMC assumes the user knows what they're doing, and this album is also ruled out from being a compilation. | ||
# If two or more songs assigned to the ''Album'' name then have different primary artists, then the ''Album'' name is considered to be a group of songs from a compilation, and the ''Various Artists''" tag is assigned as the album artist. | # If two or more songs assigned to the ''Album'' name then have different primary artists, then the ''Album'' name is considered to be a group of songs from a compilation, and the ''Various Artists''" tag is assigned as the album artist. | ||
# Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's ''Album Artist'', and we assume the additional artists are guest artists. | # Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's ''Album Artist'', and we assume the additional artists are guest artists. | ||
Line 104: | Line 104: | ||
== Embedded Album Art == | == Embedded Album Art == | ||
XBMC supports embedded album art in files with ID3 tags, WMA tags and MP4 tags only. It does not support embedded album art in APE, Ogg or FLAC tags currently. To have album art for these formats, see the [[Thumbnails]] portion of the manual. | |||
== Album art and thumbnails == | == Album art and thumbnails == | ||
Line 113: | Line 113: | ||
Album art can by obtained via [http://www.allmusic.com Allmusic.com] and described in the [[My Music Navigation and Control#The Context Menu|The Context Menu]] section. Music tags can also contain art for that specific song, as can be seen in [[Preparing your Music]].<br /> | Album art can by obtained via [http://www.allmusic.com Allmusic.com] and described in the [[My Music Navigation and Control#The Context Menu|The Context Menu]] section. Music tags can also contain art for that specific song, as can be seen in [[Preparing your Music]].<br /> | ||
If you want a custom thumb, you can add a .jpg file to your music directory. The .tbn file can be either a .JPG or a .PNG file (with transparency) that you simply rename the extension from .jpg/.png to .tbn.<br /> | If you want a custom thumb, you can add a .jpg file to your music directory. The .tbn file can be either a .JPG or a .PNG file (with transparency) that you simply rename the extension from .jpg/.png to .tbn.<br /> | ||
The size of the picture can be anything from 64x64 to 256x256 in pixel-size (you may want to use a larger pixel-size if you use | The size of the picture can be anything from 64x64 to 256x256 in pixel-size (you may want to use a larger pixel-size if you use XBMC in 720p/1080i HDTV resolution to get a sharper image).<br /> | ||
'''Examples:'''<br /> | '''Examples:'''<br /> | ||
Line 139: | Line 139: | ||
Now your album/artist folder will have a lovely custom thumbnail-image. | Now your album/artist folder will have a lovely custom thumbnail-image. | ||
You can via [[advancedsettings.xml]] change the default filename of the image that | You can via [[advancedsettings.xml]] change the default filename of the image that XBMC uses for music folders. See the [[advancedsettings.xml#<musicthumbs>|<musicthumbs>]] tag. for more information. | ||
== NFO files == | == NFO files == | ||
Line 149: | Line 149: | ||
{{#lst:Cue sheets|intro}} | {{#lst:Cue sheets|intro}} | ||
[[Category: | [[Category:XBMC Manual]] | ||
[[Category:Music library]] | [[Category:Music library]] |
Revision as of 20:08, 5 June 2014
Music library | Adding music to the library |
This page or section may require cleanup, updating, spellchecking, reformatting and/or updated images. Please improve this page if you can. The discussion page may contain suggestions. |
XBMC adds music to the library by scanning music files to extract identifying information from tags in the files. In order to be able to include information on your music collection in the music 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.
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.
See also audio streams
Scanning Your Music Into the Music Library
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 bring up the the Context Menu. (The selected item can be a music file, a folder containing music files, or a folder containing other folders.) Select the option labelled "Scan Item to Library". XBMC will then scan the selected music source into the library database. Once the scan is complete, you can browse your collection by selecting 'Library Mode'.
You can simplify the library maintenance by selecting the option "Update library on startup" (Menu System > Settings > Music > Library). This way, each time you start your XBMC, the sources will be scanned and library updated with the new contents. You can still, off course, scan manually the sources as explained just before.
Sources for Music
XBMC gives you the ability to listen to music from a variety of sources, click here for more information and examples of Types of Media Sources (link).
Some examples of sources that allow you to easily access all your digital music collection:
- On your computer or a NAS (Network Attached Storage) device/system, which supports SMB file sharing
- Stored directly on the hard drive
- On CDs/DVDs
- Streamed from the Internet
For information on how to configure remote file shares, please click here (link)
Ripping CDs
Kodi has integrated Audio-CD (CDDA) ripping functionality. In order to use this feature, first configure the CD ripping settings (to set which encoder quality to use and where to store the files). To Rip the entire CD, highlight the Audio CD from the My Music root listing and choose Rip Audio CD from the context menu. To rip a single track, enter the Audio CD, highlight the desired track, and choose Rip Audio Track from the context menu.
Applications to edit music Tags
Your audio files MUST have correct audio tags to use the Music Library mode. Without tags you're limited to the fileview in XBMC. There are several tools out there that will allow you to manipulate music ID tags.
- Supplemental tools/Linux#Music tools
- Supplemental tools/Mac OS X#Music tools
- Supplemental tools/Windows#Music tools
Technical Explanation: File tags
Skip this section if you're not interested a technical explanation of this subject. You don't need this information to use what is explained in the previous section.
For many categories, such as genres and artists, XBMC supports multiple values in the one field. By default it uses the character sequence " / " to divide the entry into multiple values. This divider may be changed via advancedsettings.xml.
Artist Tags - Resolving Compilations and Multiple Artists
XBMC reads the Album Artist tag in ID3, Ogg, APE and MP4 tags and uses it if available to assign an artist to the album (independently of the track's artist information). This is the "Album Artist" tag (in ID3 this is represented by the "TPE2" tag; in vorbiscomment (ogg) files "ALBUMARTIST", "ALBUM ARTIST" and "ENSEMBLE" are all supported). Multiple artists for either a track or album artist can be specified in "Artist1 / Artist2 / Artist3" format.
If no Album Artist tag exists, XBMC will use the first (primary) artist from the tracks as the Album Artist. Essentially we do a string comparison of all the track artists, and assign the common artists as the Album artist. This is generally the TPE1 tag in ID3.
As many users don't yet use the Album Artist tag, XBMC has an additional filter system for identifying compilation albums, where each track normally has a different artist. As XBMC scans a folder, it does the following:
- Identifies albums based on Album name alone in the folder and groups the songs that have the same Album name together as an album.
- Runs through each album's assigned songs. If there is 2 or more tracks with the same Track number, the group of songs must come from 2 or more albums, so the Album name is ruled out as a possible compilation.
- If any of the songs assigned to the Album name have an Album Artist tag, then XBMC assumes the user knows what they're doing, and this album is also ruled out from being a compilation.
- If two or more songs assigned to the Album name then have different primary artists, then the Album name is considered to be a group of songs from a compilation, and the Various Artists" tag is assigned as the album artist.
- Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's Album Artist, and we assume the additional artists are guest artists.
Ratings in ID3 tags
Ratings in ID3 tags are read via the POPM field, and (if this doesn't exist) in a custom (TXXX) field named "RATING". For the RATING field, we accept 1-5 as valid ratings. For the POPM field things are more complicated, as there is no established standard in place. We currently most closely respect what Mediamonkey does, and also have some support for what Windows Media Player 11 does. The POPM tag takes a value from 0..255, with 0 meaning no rating, 1 the worst, and 255 the best. We currently map these as follows:
POPM value |
Star rating |
0 |
|
1 |
* This is a special case for Windows Media Player |
2-8 |
|
9-49 |
* |
50-113 |
** |
114-167 |
*** |
168-218 |
**** |
219-255 |
***** |
Embedded Album Art
XBMC supports embedded album art in files with ID3 tags, WMA tags and MP4 tags only. It does not support embedded album art in APE, Ogg or FLAC tags currently. To have album art for these formats, see the Thumbnails portion of the manual.
Album art and thumbnails
There are a number of ways to get thumbnails to display in Music. Examples: Music\path\audiofilename.mp3 Music\path\audiofilename.tbn |
The same goes for playlists, Cue sheets, SHOUTcast, and internet-stream files, eg:
Music\path\audioplaylistname.m3u Music\path\audioplaylistname.tbn Music\path\cuelistname.cue Music\path\cuelistname.tbn Music\path\shoutcastlinkname.pls Music\path\shoutcastlinkname.tbn Music\path\audiostreamname.strm Music\path\audiostreamname.tbn
If you store each of your music-albums or artists in a separate subfolder to keep things organized, you can also make the folder have a custom thumbnail image. To do this you need to rename your .jpg thumbnail as folder.jpg and place it in the folder (the size of the picture can be anything from 64x64 to 256x256 in pixel size).
Example:
Music\path\album\folder.jpg
Now your album/artist folder will have a lovely custom thumbnail-image.
You can via advancedsettings.xml change the default filename of the image that XBMC uses for music folders. See the <musicthumbs> tag. for more information.
NFO files
NFO files are used to populate the music and video library using locally stored information. They are helpful if data for your particular title does not exist, such as for home movies and sporting events. A Parsing and Combination NFO file can be used to control the search behaviour of scrapers when problematic and ambiguous titles prevent your preferred title from being scraped.
Cue sheets
Cue Sheets are used to provide index and playlist information for a large audio file. They are generally used in conjunction with either extracting from, or burning to, Music AudioCD. Cue sheets have the file extension ".cue", and are simple plain text files.