Adding music to the library: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Clicks
No edit summary
>Tmpdir
(added easy(functional) introduction and moved more technical stuff to the end of the page.)
Line 1: Line 1:
==Preparing your Music to be Scanned==
==Why should you prepare your music?==
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.
Adding your music to XBMC is easy. This allows you to play your music using XBMC. If you are like most XBMC users you'll want a bit more than just navigate to a album and select a number to play from it. You want more... you want to search for music from a certain artist, genre, etc. If thats the case than your music should be tagged (add meta-information to your music files).  


Preparing your music collection for scanning into your [[Music Library]] may be the most time consuming portion of getting it up and running, but for most users it will probably be well worth it. 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.
These days most music files already have these tags. But sometimes you're out of luck and need to correct this yourself. In this article we take a look at the best tools to fix music tags and organizing and cleaning your songs.


'''Note:''' Your audio files '''MUST''' have a valid ID tag for them to work properly in the XBMC Music Library mode.
A well tagged MP3 collection makes everything from organization to playback easier.


{|
{|
| valign="top" |
| valign="top" |


==Music File Tags==
==Tools to Manipulate Music File Tags==
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.
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. Consult the homepages of these tools how to tag your music collection
 
Free ID3 tag programs:
*[http://kid3.sourceforge.net/ kid3] [Win, Lin, Mac]
*[http://musicbrainz.org/doc/MusicBrainz_Picard MusicBrainz Picard] [Win, Lin, Mac]
*[http://www.mediamonkey.com/ MediaMonkey] [Win]
*[http://www.mp3tag.de/en/download.html Mp3Tag] [Win]
*[http://easytag.sourceforge.net/ Easytag] [Lin, Mac]
*[http://puddletag.sourceforge.net/ puddletag] [Lin]
 
 
Programs that allow you to download album art thumbnails for multiple albums at a time:
*[http://code.google.com/p/quodlibet/ Ex Falso] [Win, Lin, Mac, BSD]
*[http://team.thenexusnet.com/nexus/AAA/ Album Art Aggregator] [Win]
*[http://sourceforge.net/projects/album-art/ Album Art Downloader] [Win]
 


Most media players also allow users to manipulate ID tags, some examples:
*[http://code.google.com/p/quodlibet/ Qued Libet] [Win, Lin, Mac, BSD]
*[http://www.microsoft.com/windows/windowsmedia/player/10/default.aspx Windows Media Player] [Win]
*[http://www.apple.com/itunes/ iTunes] [Mac]
*[http://www.winamp.com/ Winamp] [Win]
*etc.
==Techical: Music File Tags==
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]].
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]].


Line 78: Line 103:
==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.
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.
==Tools to Manipulate Music File Tags==
There are several tools out there that will allow you to manipulate music ID tags.
Free ID3 tag programs:
*[http://kid3.sourceforge.net/ kid3] [Win, Lin, Mac]
*[http://musicbrainz.org/doc/MusicBrainz_Picard MusicBrainz Picard] [Win, Lin, Mac]
*[http://www.mediamonkey.com/ MediaMonkey] [Win]
*[http://www.mp3tag.de/en/download.html Mp3Tag] [Win]
*[http://easytag.sourceforge.net/ Easytag] [Lin, Mac]
*[http://puddletag.sourceforge.net/ puddletag] [Lin]
Programs that allow you to download album art thumbnails for multiple albums at a time:
*[http://code.google.com/p/quodlibet/ Ex Falso] [Win, Lin, Mac, BSD]
*[http://team.thenexusnet.com/nexus/AAA/ Album Art Aggregator] [Win]
*[http://sourceforge.net/projects/album-art/ Album Art Downloader] [Win]
Most media players also allow users to manipulate ID tags, some examples:
*[http://code.google.com/p/quodlibet/ Qued Libet] [Win, Lin, Mac, BSD]
*[http://www.microsoft.com/windows/windowsmedia/player/10/default.aspx Windows Media Player] [Win]
*[http://www.apple.com/itunes/ iTunes] [Mac]
*[http://www.winamp.com/ Winamp] [Win]
*etc.


[[category:Usage]]
[[category:Usage]]

Revision as of 10:09, 23 September 2011

Why should you prepare your music?

Adding your music to XBMC is easy. This allows you to play your music using XBMC. If you are like most XBMC users you'll want a bit more than just navigate to a album and select a number to play from it. You want more... you want to search for music from a certain artist, genre, etc. If thats the case than your music should be tagged (add meta-information to your music files).

These days most music files already have these tags. But sometimes you're out of luck and need to correct this yourself. In this article we take a look at the best tools to fix music tags and organizing and cleaning your songs.

A well tagged MP3 collection makes everything from organization to playback easier.

Tools to Manipulate Music File 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. Consult the homepages of these tools how to tag your music collection

Free ID3 tag programs:


Programs that allow you to download album art thumbnails for multiple albums at a time:


Most media players also allow users to manipulate ID tags, some examples:


Techical: Music File Tags

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:

  1. Identifies albums based on Album name alone in the folder and groups the songs that have the same Album name together as an album.
  2. 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.
  3. 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.
  4. 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.
  5. 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.