Update Music Library

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. NFO Files
6.1 Music NFO Files
7. Artwork
7.1 Music Artwork
8. Update Music Library

9. Import-export library
10. Rebuild your music library
Zappy.png
Home icon grey.png   ▶ Music library ▶ Update Music Library


Contents

1 Introduction

This page will provide information to enable you to add new music, modify existing music and remove music from your existing music library.

This page assumes you have an existing music library. If you do not have an existing music library, you will need to create one by following the guide Create Music Library.

If you use File View or File Manger, this page does not apply.

Depending upon your settings (explained further on) the addition of new music could take upto three steps:

  1. Scan files
  2. Scrape Artist
  3. Scrape Album


2 Scan Library

The Update Library function specifically relates to scanning files and importing into the library the data from the music file tags. It runs through the music source(s) looking for new, or changed, folders or files. It does this by checking through all your music, looking at timestamp and file size. But it only actually scans the tags from those files that are new or changed.

If you have a small library, this is not a problem as the scan is relatively quick. For those that have libraries in the order of tens of thousands of songs, this can be a very intensive and time consuming process. For this reason there are three ways to perform the Update Library. All achieve the same result, but their differences may suit different libraries or different user requirements.

Remember, this procedure only conducts the scanning of the tags. It is possible to have Kodi scrape the additional music data by using the setting Fetch additional info on update as follows:

  • If Fetch additional info on update is set to Disabled then you will need to follow one of the procedures in the Scrape Library section below to scrape the additional music information
  • If Fetch additional info on update is set to Enabled then Kodi will complete the scan and then conduct the scrape automatically


2.1 Update Library

This method is a global music library update. Kodi will search all music sources and all music folders and files looking for new, or changed, folders and files. It is the most commonly used process to scan music.

In the settings pages, Kodi can also be set to automatically run the Update Library function at startup. See: Update library on startup

Image 3

To scan all sources for new and changed items, follow these steps:

  1. Select Music from the main menu (Image 1)
  2. From the Category Screen (Image 2) or from within any category list (Genre, Artist, Album, Songs etc)...
  3. Call up the Side Bar Menu which is normally left-arrow (Image 3)
  4. Select Update library (Image 3)


2.2 Scan Item to Library

This method will update individual Album or Artist only. A good option for large libraries with only a few new files.

To scan a new album or artist into your library, follow these steps:

  1. Select Music from the main menu (Image 1)
  2. Select Files from the category list (Image 2)
  3. Select the Source where the album or artist is saved
  4. Select either the Artist or Album category
  5. Highlight the Album or Artist to be scanned into the library (Image 3)
  6. Call up the Context Menu (Image 3)
  7. Select Scan item to library (Image 3)
  8. Repeat as necessary

Notes:

  • Scanning an individual song will scan all songs in the album
  • If you added multiple albums from the same Artist, then conduct the above procedure at the Artist level


2.3 Scan Source to Library

The following allows you to scan one source for new items. Good if you have added multiple new music files to a single music source

To scan an entire source, follow these steps:

  1. Select Music from the main menu (Image 1)
  2. Select Files from the category list (Image 2)
  3. Highlight the source to be scanned
  4. Call up the Context Menu (Image 3)
  5. Select Scan item to library (Image 3)

Kodi will search your music files for any new or changed items. When new or changed files are located, they will be scanned and the data contained in the embedded tags will be added to the library
Note: In v18 it will be possible to request a rescan of all tags.


3 Scrape Library

This section is specifically related to Scraping additional music information. This can be from an online source or a nfo file. To use this function, files must already be scanned into the library.

The two methods available to Scrape additional information are:

  1. Refresh - Used on individual artists and albums
  2. Query info for all artists/albums - Two separate functions that performs a global query, but only downloads the additional data for those items not previously scraped. ie new items only.

If you have an item already scraped into the library but there is new information available online, or you have added new data to a nfo file, you will need to perform a Refresh to scape the data into the library. A Query for all artists/albums only looks for entries not previously scraped.


3.1 Refresh Artist

To Refresh the data for an individual Artist, or to Scrape data for a newly added Artist, follow these steps:

  1. From the Artist list highlight the Artist to be modified (Image 1)
  2. Call up the Artist Information page.
  3. Select Refresh (image 2)
  4. The Artist information will be downloaded, if available at the scraper site or the nfo file


3.2 Refresh Album

To Refresh the data for an individual Album, or to Scrape data for a newly added Album, follow these steps:

  1. From the Album list highlight the Album to be modified (Image 1)
  2. Call up the Album Information page.
  3. Select Refresh (image 2)
  4. The Album information will be downloaded, if available at the scraper site or the nfo file


3.3 Query Info for all Artists

To scrape additional information for Artists, follow these steps:

  1. Select Music from the main menu (Image 1)
  2. Select Artists from the category list (Image 2)
  3. Highlight any Artist (Image 3)
  4. Call up the Context Menu for the selected Artist (Image 3)
  5. Select Query info for all artists (Image 3)

If you do not go to the Artist category but perform this action through another music category, say Years or Roles, only that particular Artist you selected will be scraped.


3.4 Query Info for all Albums

To scrape additional information for Albums, follow these steps:

  1. Select Music from the main menu (Image 1)
  2. Select Albums from the category list (Image 2)
  3. Highlight any Album (Image 3)
  4. Call up the Context Menu for the selected Album (Image 3)
  5. Select Query info for all albums (Image 3)

If you do not go to the Album category but perform this action through another music category, say Years or Roles, only that particular Album you selected will be scraped.


4 Remove Music

The ability to remove music from the Kodi library is limited.


4.1 Remove Source

The following allows you to remove one or more Sources. This will remove from the library all music contained in that 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.2 Remove Individual Item

It is not possible to remove music from the library in the same way as you remove movies from the movie library of Kodi. If you need to remove a particular song, album or artist your options are as follows:

  1. Using the File Browser of your operating system, remove the music by either deleting it or moving it out of the Kodi Source folder. Then, within Kodi, run a Clean Library, or
  2. From within Kodi
    1. Enable the setting Allow file renaming and deletion
    2. Using Music>Files, locate and highlight the item to be deleted- either an individual song, Album or Artist
    3. From the context menu, select Delete. Be aware- This will delete the item(s) from your hard disk
    4. Run a Clean Library


5 Exclude

It is possible to exclude a particular song type (eg. mp3) or a folder from the Music Scan and Scraping process.


5.1 Exclude Song Types

With the use of the advancedsettings.xml file, you can limit the types of music files displayed.

Default extensions for MUSIC:

.nsv .m4a .flac .aac .strm .pls .rm .rma .mpa .wav .wma .ogg .mp3 .mp2 .m3u .gdm .imf .m15 .sfx
.uni .ac3 .dts .aif .aiff .wpl .ape .mac .mpc .mp+ .mpp .shn .wv .dsp .xsp .xwav .waa .wvs .wam
.gcm .idsp .mpdsp .mss .spt .rsd .sap .cmc .cmr .dmc .mpt .mpd .rmt .tmc .tm8 .tm2 .oga .url
.pxml .tta .rss .wtv .mka .tak .opus .dff .dsf .m4b .cue .zip .rar

It is possible to add or remove extensions for Music, using the following XML tags. Useful if you keep, say, FLAC and mp3 versions of music in the same folder. The <remove> tag can be used to remove mp3 from being listed in the library, leaving only the higher quality FLAC being displayed.

<musicextensions>
  <add>.ex1|.ex2</add>
  <remove>.ex3|.ex4</remove>
</musicextensions>



5.2 Exclude Folder

Within a music source, it is possible to exclude certain folders, and the contents of those folders, from the scanning and scraping process as follows:

  1. Using the file browser of your operating system locate the folder to be excluded
  2. Inside the folder to be excluded, place an empty text file and name it as follows:
    • Windows systems- .nomedia.
      • Create an empty text file.
      • Rename the text file to the above name with the leading and trailing period.
      • Windows will notify you that changing the file extension will make the file unuseable. Accept this.
      • When Windows saves the name change, it will remove the last period and the new name will be .nomedia
    • All other systems- .nomedia
  3. Kodi will read the filename and ignore the folder and its contents



Return to top


Next step: Import & Export


Personal tools
Namespaces

Variants
Actions
Navigation
Wiki help
Toolbox