Scanning Music

From Official Kodi Wiki
Jump to: navigation, search
Steps to create your Music Library
Nuvola apps kscd.png
1. Guide Main Page
2. Music Settings
3. Music File Tagging
4. Scanning Music Into Library
5. Scraping Additional Music data

6. Update Music Library
7. NFO Files
7.1 Music NFO Files
8. Artwork
8.1 Music Artwork

9. Import-export library
10. Rebuild your music library
Home icon grey.png   ▶ Music library ▶ Adding music to the library

1 Introduction

This page details the following:

  • Adding and removing Sources
  • Scan (import) your music collection into the Music Library.
  • Troubleshooting common problems
  • Describes the network protocols accepted for remote music sources

If you are a new user of Kodi, or you have little experience setting up the Music section, then it is important that you followed Steps 2 (Music Settings) & 3 (Music File Tagging) of the guide.

A reminder of the following:

  • Ensure the setting Fetch additional information during updates is disabled
  • Ensure you have taken care to correctly tag your music. If you haven't... then you are about to find out what happens.

2 Adding Music to Library

  • Populating the music library is a two step process.
    • The first step reads the tags embedded in the music files. This is referred to as scanning. If there is any embedded artwork, this will also be scanned and cached.
    • The second optional step fetches additional artwork, artist and album information. This information and artwork can be downloaded from either online sources or fetched from local nfo files. This is referred to as scraping and is covered in detail in the next step of the guide.

2.1 Initial Set Source & Scan

This process achieves the following:

  • Sets your music source(s) in Kodi. Simply explained, this points Kodi to your music files (Steps 1-5)
  • Allows Kodi to scan the tags in the music files and import that data into the library (Steps 6-7)
  • A brief introduction to navigating the Music Library (Steps 8-9)

At this point you should have a functioning Music Library

2.2 Adding Additional Music Sources

2.3 Scan to Library

In step 6 above, you were asked Do you want to add the media from this source to your library? If you selected NO and would now like to add the music files into the library, follow these steps:

  1. Navigate to and enter Files as illustrated in Image 1
  2. Highlight the source to be scanned
  3. Call up the Context Menu (Image 2)
  4. Select Scan item to library (Image 2)

Your music files will now be scanned and the data contained in the embedded tags will be added to the library
If you answered Yes to the question in step 6 above, there is no need to perform this step. If you do perform this step, there are no consequences and Kodi will only search for new files added since the last scan.

Note: In v18 it will be possible to request a rescan of all tags. Useful if you have modified tags.

3 Remove A Source

To remove a source, follow these steps:

  1. Navigate to and enter Files as illustrated in Image 1
  2. Highlight the source to be removed
  3. Call up the Context Menu (Image 2)
  4. Select Remove source (Image 2)
  5. A confirmation prompt will display- Are you sure? Yes / No
    • Select Yes to remove the source
    • Select No to cancel the procedure
  6. If you selected Yes you will then be asked Do you want to remove all items within this path from your library?...
    • Yes- Will remove all songs from the library that were located in that source, and the associated Artists and Albums if they do not appear on any other source
    • No- Will keep the library listing of all music that was in that source.
      • Note: If you answered No but would now like to remove the items from the library...
        1. Re-add the Source following the directions above.
        2. Answer No when asked Do you want to add the media from this source to your library
        3. Follow these instructions to again remove the Source ensuring you select Yes to remove items from the library

4 Troubleshooting

4.1 Library contains random or duplicated entries

This is a result of errors in tagging.

  1. Take note of the errors and correct them by following the recommended procedure in the previous step of the guide- Music Files and Tagging
  2. Once errors are corrected follow the steps detailed in Remove A Source
  3. Re-add the source using the Initial Set Source & Scan procedure detailed above

4.2 I cannot add a source on my network

Seek further information in Section 5 - Network Sources, below

If you have successfully scanned your music library, then you can safely ignore the next section and proceed to Scraping Additional Music Data

Next step: Scraping Additional Music data

5 Network Sources

Kodi gives you the ability to listen to music from a variety of sources.

See Types of Media Sources

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

If you use an non-standard network protocol to stream your media from a network, or for information on how to configure remote file shares

Return to top

Next step: Scraping Additional Music data