Adding music to the library: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Remove Transclusion)
(Page cleared)
Line 1: Line 1:
{{mininav|[[Music library]]}}
{{cleanup}}
<section begin="intro"/>Kodi 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]]''', Kodi needs your music to be tagged. When your collection is scanned, Kodi 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 Kodi 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.
== First Time Music Library Setup ==
<section begin="First Time Music Setup" />
<gallery widths=500px heights=313px>
File:Estuary_home_music.png|'''Step 1:''' On the Home menu select '''Music''' from the menu itmes, then select '''Enter files section'''
File:Estuary_music_file_browser.png|'''Step 2:''' In the '''Music File Browser''' select '''Add music'''.
File:Estuary_add_music_source.png|'''Step 3:''' In the '''Add music source''' window select '''Browse'''.  You can also manually add your source by selecting the box with '''<None>''' then typing in your path.  If you chose to do it this way skip to '''Step 5'''
File:Estuary_music_browse_source.png|'''Step 4:''' In the '''Browse for new share''' window, navigate to where your music is stored, select the folder and then select '''OK'''.
File:Estuary_music_name_source.png|'''Step 5:''' You will now be taken back to the '''Add music source''' window where under '''Enter a name for this media source''' you can name your media source.  If you don't enter a name then, by default, Kodi will use the folder name as the name for your source.  You can then select '''OK'''.
File:Estuary_music_scan_source.png|'''Step 6:''' You will now be asked if you wish to add your media source to the library.  If you do, then select '''Yes''', if you do not, then select '''No'''.  By selecting '''No''' you will only have the option of accessing your media though the '''Music file browser'''.
File:Estuary_music_scanning_library.png|'''Step 7:''' If you selected '''Yes''' Kodi will begin scanning your source to the library.
File:Estuary_home_music_library.png|'''Step 8:''' Once your library is scanned you will be able to see & access '''Recently added albums, Random albums, Random Artist & Unplayed albums''' on the Home menu.
File:Estuary_music_albums.png|You will also be able to view your entire music library by selecting '''Music''' from the Home menu, then selecting the appropriate category.  Or from the Home menu, navigate to '''Categories''' at the top of the '''Music''' menu item and then selecting the category you wish to view.  '''Example: Category''' → '''Albums'''.
File:Estuary_music_artist.png|'''Example: Category''' → '''Artist'''.
</gallery>
<section end="First Time Music Setup" />
== Adding Additional Music Sources ==
<gallery widths=500px heights=313px>
File:Estuary_home_music_files.png|To add additional sources to your library, from the Home menu select '''Music'''.  Then navigate to the to the top of the page and under '''Categories''' select '''Files'''.  Then follow the directions from '''Step 2''' in [[Estuary:Adding_music_to_the_library#First_Time_Music_Library_Setup|First Time Music Library Setup]]
</gallery>
== Sources for Music ==
{{main|Media sources}}
Kodi 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:
* '''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 [[Configuring PC Shares|here (link)]]
== Ripping CDs ==
{{main|Ripping CDs}}
{{#lst:Ripping CDs|intro}}
== MusicBrainz integration ==
Starting in v13 "Gotham", Kodi has "MusicBrainzID" integration. This allows your music metadata to be updated automatically when that data is updated on the MusicBrainz database ''if'' the music has MusicBrainz ID 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 file view in Kodi. 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, Kodi 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 ===
Kodi 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, Kodi 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, Kodi has an additional filter system for identifying compilation albums, where each track normally has a different artist.  As Kodi 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 Kodi 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:
{| class="prettytable"
|-
|
'''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 ==
{{#lst:Music_artwork|EmbeddedArtwork}}
== Artwork ==
{{See also|Artwork}}
{{#lst:artwork|intro}}
== NFO files ==
{{main|NFO files}}
{{#lst:NFO files|intro}}
== Cue sheets ==
{{main|Cue sheets}}
{{#lst:Cue sheets|intro}}
== See also audio streams ==
{{see also|Internet_video_and_audio_streams}}
{{updated|17}}
[[Category:Manual]]
[[Category:Music library]]

Revision as of 02:49, 6 October 2017

Retrieved from "https://kodi.wiki/index.php?title=Adding_music_to_the_library&oldid=131004"