User:Karellen/scratchpad: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Update Music Library)
(Page cleared)
Line 1: Line 1:
{{MusicLibraryCreate}}
{{mininav|[[Music library]]}}


= Introduction =
This page will provide information to enable you to add new music, modify existing music and remove music from your '''existing''' music library.
{{red|'''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 [[:HOW-TO:Create_Music_Library| 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:
#Scan files
#Scrape Artist
#Scrape Album
= Scan Library =
<!-- https://forum.kodi.tv/showthread.php?tid=320887&pid=2641709#pid2641709 -->
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 '''[[Settings/Media/Music#Fetch_additional_information_during_updates|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 '''Scrape Library''' 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
== 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.
<gallery widths=500px heights=300px>
File:Estuary_home_music_files.png|Image 1
File:Music-CategoryList.jpg|Image 2
File:Music-AlbumContextMenuFile.jpg|Image 3
</gallery>
To scan a new album or artist into your library, follow these steps:
#Select '''Music''' from the main menu (Image 1)
#Select '''Files''' from the category list (Image 2)
#Select the Source where the album or artist is saved
#Highlight the Album or Artist to be scanned into the library
#Call up the Context Menu (Image 3)
#Select '''Scan item to library''' (Image 3)
#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
== 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
<gallery widths=500px heights=313px>
File:Estuary_home_music_files.png|Image 1
File:Music-CategoryList.jpg|Image 2
File:Source-ContextMenu.jpg|Image 3
</gallery>
To scan an entire source, follow these steps:
#Select '''Music''' from the main menu (Image 1)
#Select '''Files''' from the category list (Image 2)
#Highlight the source to be scanned
#Call up the Context Menu (Image 3)
#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<br />
{{note|In v18 it will be possible to request a rescan of all tags.}}
== 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.
[[File:EstuarySideBarMenu_small.gif|frame|right|Image 3]]
<gallery widths=500px heights=300px>
File:Estuary_home_music_files.png|Image 1
File:Music-CategoryList.jpg|Image 2
</gallery>
To scan all sources for new and changed items, follow these steps:
#Select '''Music''' from the main menu (Image 1)
#From the Category Screen (Image 2) or from within any category list (Genre, Artist, Album, Songs etc)...
#Call up the '''Side Bar Menu''' which is normally ''left-arrow'' (Image 3)
#Select '''Update library''' (Image 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:
#'''Refresh''' - Used on individual artists and albums
#'''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 data to a nfo, 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.
== Refresh Artist ==
<gallery widths=500px heights=300px>
File:Artwork-MusicArtist01.jpg|Image 1
File:Artwork-MusicAdd01.jpg|Image 2
</gallery>
To Refresh the data for an individual Artist, or to Scrape data for a newly added Artist, follow these steps:
#From the Artist list highlight the Artist to be modified (Image 1)
#Call up the Artist Information page.
#Select '''Refresh''' (image 2)
#The Artist information will be downloaded, if available at the scraper site or the nfo file
== Refresh Album ==
<gallery widths=500px heights=300px>
File:Artwork-MusicAlbum01.jpg|Image 1
File:Artwork-MusicAdd04.jpg|Image 2
</gallery>
To Refresh the data for an individual Album, or to Scrape data for a newly added Album, follow these steps:
#From the Album list highlight the Album to be modified (Image 1)
#Call up the Album Information page.
#Select '''Refresh''' (image 2)
#The Album information will be downloaded, if available at the scraper site or the nfo file
== Query Info for all Artists ==
{{#lst:Scraping_Music|ScrapeArtists}}
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.
== Query Info for all Albums ==
{{#lst:Scraping_Music|ScrapeAlbums}}
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.
= Remove Music =
The ability to remove music from the Kodi library is limited.
== Remove Source ==
The following allows you to remove one or more Sources. This will remove from the library all music contained in that source
{{#lst:Adding_music_to_the_library|Remove A Source}}
== Remove Individual Item ==
It is not possible to remove music from the library in the same way as you remove movies in the Video section of {{kodi}}. If you need to remove a particular song, album or artist your options are as follows:
#Using your operating systems File Browser remove the music by either deleting it or moving it out of the Source folder then, within {{kodi}}, run a [[Settings/Media/Library#Clean_library_2|Clean Library]], or
#From within {{kodi}}
##Enable the setting [[Settings/Media/General#Allow_file_renaming_and_deletion|Allow file renaming and deletion]]
##Using Music>Files, locate and highlight the item to be deleted- either an individual song, Album or Artist
##From the context menu, select '''Delete'''. Be aware- '''This will delete the item(s) from your hard disk
##Run a [[Settings/Media/Library#Clean_library_2|Clean Library]]
= Exclude =
It is possible to exclude a particular song type (eg. mp3) or a folder from the Music Scan and Scraping process.
== Exclude Song Types ==
With the use of the ''advancedsettings.xml'' file, you can limit the types of music files displayed.
{{#lst:Advancedsettings.xml|musicextensions}}
;{{See also|Advancedsettings.xml}}
== 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:
#Using the file browser of your operating system locate the folder to be excluded
#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 saving the name change, Windows will remove last period and the new name will be '''''.nomedia'''''
#*All other systems- '''''.nomedia'''''
#Kodi will read the filename and ignore the folder and its contents
{{Top}}
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Import-export_library|Import & Export]]}} </div>
{{updated|17}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:First time user]]
[[Category:Music library]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]

Revision as of 04:42, 14 October 2017