Update Music Library - Revision history

Karellen: /* Exclude Folder */

2024-12-02T03:28:33Z

Exclude Folder

← Older revision		Revision as of 03:28, 2 December 2024
Line 231:		Line 231:
	<section begin="ExcludeFolder" />It is possible to exclude certain folders, and the contents of those folders, from the scanning and scraping process as follows:		<section begin="ExcludeFolder" />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		#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:		#Inside the folder to be excluded, place an empty text file and name it as follows (including the preceding period): <big>'''.nomedia'''</big>
	~~#*Windows systems- '''''.nomedia.'''''~~
	~~#**Create an empty text file.~~		Kodi will read the filename and ignore the folder and its contents.
	~~#**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.~~		On Windows systems, ensure file extensions are enabled and visible. There should be no file extension for this file.<section end="ExcludeFolder" />
	~~#**When Windows saves the name change, it will remove the 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<section end="ExcludeFolder" />

Karellen: removed Category:FAQ using HotCat

2023-02-22T19:52:50Z

removed Category:FAQ using HotCat

← Older revision		Revision as of 19:52, 22 February 2023
Line 251:		Line 251:

	{{updated\|18}}		{{updated\|18}}
	~~[[Category:FAQ]]~~
	[[Category:Index]]		[[Category:Index]]
	[[Category:Guides]]		[[Category:Guides]]

Karellen at 21:34, 11 July 2020

2020-07-11T21:34:37Z

← Older revision		Revision as of 21:34, 11 July 2020
Line 61:		Line 61:
	== Update Library- via Add-ons ==		== Update Library- via Add-ons ==
	* '''''[[Add-on:XBMC Library Auto Update]]''''' can be used to schedule automatic updates to the library.		* '''''[[Add-on:XBMC Library Auto Update]]''''' can be used to schedule automatic updates to the library.

	* '''''[[Add-on:Library watchdog]]''''' can be used to watch folders for new files to trigger library updates.

Karellen at 05:26, 25 May 2019

2019-05-25T05:26:26Z

← Older revision		Revision as of 05:26, 25 May 2019
Line 231:		Line 231:

	== Exclude Folder ==		== Exclude Folder ==
	<section begin="ExcludeFolder" />~~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:		<section begin="ExcludeFolder" />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		#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:		#Inside the folder to be excluded, place an empty text file and name it as follows:

Karellen: Updated for v18

2019-04-16T08:21:03Z

Updated for v18

Show changes

Karellen at 05:04, 19 May 2018

2018-05-19T05:04:59Z

← Older revision		Revision as of 05:04, 19 May 2018
Line 166:		Line 166:

	= Remove Music =		= Remove Music =
	~~The ability to remove~~ music from the Kodi library is ~~limited~~.		Removing music from the Kodi library works differently to removing a movie from the Video Library. Due to the virtual links between Artist-Album-Songs, it is not possible to remove items directly from the library. The following two methods are available.

Karellen: Added more Update Library options

2018-03-29T09:09:56Z

Added more Update Library options

@@ Line 29: / Line 29: @@
-== Update Library ==
+== Update Library- Automatic ==
 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.
 [[File:EstuarySideBarMenu_small.gif|frame|right|Image 3]]
@@ Line 45: / Line 56: @@
 #Call up the '''Side Bar Menu''' which is normally ''left-arrow'' (Image 3)
 #Select '''Update library''' (Image 3)
@@ Line 71: / Line 109: @@
 *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
@@ Line 102: / Line 120: @@
 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.
@@ Line 129: / Line 162: @@
 #Select '''Refresh''' (image 2)
 #The Album information will be downloaded, if available at the scraper site or the nfo file
@@ Line 180: / Line 199: @@
 == Exclude Folder ==
-<section begin="ExcludeFolder" />Within a source, it is possible to exclude certain folders, and the contents of those folders, from the scanning and scraping process as follows:
+<section begin="ExcludeFolder" />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:

Karellen at 09:22, 6 March 2018

2018-03-06T09:22:26Z

← Older revision		Revision as of 09:22, 6 March 2018
Line 206:		Line 206:
	[[Category:Guides]]		[[Category:Guides]]
	[[Category:Manual]]		[[Category:Manual]]
			[[Category:Karellen]]
	[[Category:First time user]]		[[Category:First time user]]
	[[Category:Music library]]		[[Category:Music library]]
	[[Category:Advanced topics]]		[[Category:Advanced topics]]
	[[Category:Quick Start Guide]]		[[Category:Quick Start Guide]]

Karellen: Add transclusion

2018-02-24T21:25:34Z

Add transclusion

← Older revision		Revision as of 21:25, 24 February 2018
Line 180:		Line 180:

	== Exclude Folder ==		== 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:		<section begin="ExcludeFolder" />Within a 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		#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:		#Inside the folder to be excluded, place an empty text file and name it as follows:
Line 189:		Line 189:
	#**When Windows saves the name change, it will remove the last period and the new name will be '''''.nomedia'''''		#**When Windows saves the name change, it will remove the last period and the new name will be '''''.nomedia'''''
	#*All other systems- '''''.nomedia'''''		#*All other systems- '''''.nomedia'''''
	#Kodi will read the filename and ignore the folder and its contents		#Kodi will read the filename and ignore the folder and its contents<section end="ExcludeFolder" />

Karellen: New Page

2017-10-14T04:36:00Z

New Page

New page

{{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 =

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 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

== 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: [[Settings/Media/Library#Update_library_on_startup_2|Update library on startup]]'''''

[[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)

== 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
#Select either the Artist or Album category
#Highlight the Album or Artist to be scanned into the library (Image 3)
#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.}}

= 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 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.

== 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 from the movie library of {{kodi}}. If you need to remove a particular song, album or artist your options are as follows:

#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 [[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 Windows saves the name change, it will remove the 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]]