Settings/Media/Library: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Updated for v19)
Line 1: Line 1:
{{bigger|This category provides access to the windows for source managemeent and the Library settings for the databases.}}
{{mininav| [[Settings]] | [[Settings/Media|Media]]  }}
 
 
__TOC__
__TOC__


== Manage Sources ==
 
= Manage Sources =
[[File:Settings_media_library_manage_sources.jpg|500px]]
[[File:Settings_media_library_manage_sources.jpg|500px]]
=== Videos ===
 
 
== Videos ==
{|
{|
|- valign="top"
|- valign="top"
Line 11: Line 16:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| This provides access to where video sources can be added and otherwise managed.
| This provides access to the Video Sources. It is an alternate access to Videos>Files from the main menu.
{{see|HOW-TO:Create Video Library}}
|}
|}




=== Music ===
== Music ==
{|
{|
|- valign="top"
|- valign="top"
Line 22: Line 28:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| This provides access to where music sources can be added and otherwise managed.
| This provides access to the Music Sources. It is an alternate access to Music>Files from the Music menu.
{{See|HOW-TO:Create Music Library}}
|}
|}




=== Pictures ===
== Pictures ==
{|
{|
|- valign="top"
|- valign="top"
Line 33: Line 40:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| This provides access to where picture sources can be added and otherwise managed
| This provides access to the Picture Sources. It is an alternate access to Pictures from the Pictures menu.
{{See|Pictures}}
|}
|}




== Video Library ==
 
= Video Library =
[[File:Settings_media_library_video_library.jpg|500px]]
[[File:Settings_media_library_video_library.jpg|500px]]
=== Update library on startup ===
 
 
== Update library on startup ==
{|
{|
|- valign="top"
|- valign="top"
Line 46: Line 57:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Check for new mediafiles on given sources on startup.
| Check for new video content every time {{kodi}} is started.
If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media.
For alternate methods to scan new items into the library...
{{see|Updating or removing videos}}
|}
|}




=== Hide progress of library updates ===
== Hide progress of library updates ==
{|
{|
|- valign="top"
|- valign="top"
Line 57: Line 71:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Hide the library scanning progress bar during scans.
| Hide the pop-up library scanning progress bar during scans.
|}
|}




=== Clean library ===
== Clean library ==
{|
{|
|- valign="top"
|- valign="top"
Line 68: Line 82:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Remove items from our library that can't be found (either renamed, deleted or on removable storage that is currently unplugged.
| Remove items from the library.
Many users misunderstand this function. {{kodi}} has been designed to allow plugging and unplugging of portable hard drives. Due to this, when you run this option your media may not be deleted as expected. This is to ensure a library is not deleted because a USB HDD was unplugged.<br>
Use the correct method of removing titles from the library as detailed in the link below.<br>
After correctly deleting from the library ''first'' then run a clean library to purge the database of unnecessary records.
: See '''[[Updating_or_removing_videos#Remove_From_Library|Removing content]]'''
|}
|}




=== Export library ===
== Export library ==
{|
{|
|- valign="top"
|- valign="top"
Line 79: Line 97:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Export the video library database to XML files. This will optionally overwrite your current XML files
| Export the contents of the video library. Used as a backup of your library or to create a new {{kodi}} installation.
For the Video library, we recommend using the Separate Files method.
: See '''[[Import-export_library/Video|Export Video Library]]'''
 
|}
|}


=== Import library ===
 
== Import library ==
{|
{|
|- valign="top"
|- valign="top"
Line 89: Line 111:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Import a XML file into the video library database
| If you exported your library using the '''Single File''' method, use this to import the single file into the video library.
: See '''[[Import-export_library/Video#Import|Import Single File]]'''
|}
|}




== Music Library ==
 
= Music Library =
[[File:Settings_media_library_music_library.jpg|500px]]
[[File:Settings_media_library_music_library.jpg|500px]]
=== Update library on startup ===
 
 
== Update library on startup ==
{|
{|
|- valign="top"
|- valign="top"
Line 102: Line 128:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Check for new media files for all connected sources at startup
| Check for new music content every time {{kodi}} is started.
If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media.
For alternate methods to scan new items into the library...
{{see|Update Music Library}}
|}
|}




=== Hide progress of library updates ===
== Hide progress of library updates ==
{|
{|
|- valign="top"
|- valign="top"
Line 113: Line 142:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Hide the library scanning progress bar during scans
| Hide the pop-up library scanning progress bar during scans.
|}
|}




=== Clean library ===
== Clean library ==
{|
{|
|- valign="top"
|- valign="top"
Line 133: Line 162:




=== Export library ===
== Export library ==
{|
{|
|- valign="top"
|- valign="top"
Line 140: Line 169:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Export the music library database to XML files. This will optionally overwrite your current XML files. Only Album and Artist data is exported and song data such as rating, play count, and last time played are not exported<br />
| Export the contents of the video library. Used as a backup of your library or to create a new {{kodi}} installation.
{{see also|Import-export library|NFO files}}
For the Music library, we recommend using the Single Files method as this will also export play counts, user ratings and last played data.
: See '''[[Import-export_library/Music|Export Music Library]]'''
 
|}
|}




=== Import library ===
== Import library ==
{|
{|
|- valign="top"
|- valign="top"
Line 152: Line 183:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Import XML files (aka nfo files) into the music library database. The data is only imported if the library entry exists via initially scanning the source.
| If you exported your library using the '''Single File''' method, use this to import the single file into the music library.
If it exists:
: See '''[[Import-export_library/Music#Import_-_Single_File|Import Single File]]'''
# It removes all current info for that entry from the database.
# Inserts the info for that entry from the XML file.<br />
{{see also|Import-export library|NFO files}}
|}
|}




{{Top}}
{{Top}}
{{updated|19}}


 
[[Category:Settings]]
{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Video library]]
[[Category:Music library]]
[[Category:First time user]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]

Revision as of 00:28, 11 March 2021

Home icon grey.png   ▶ Settings ▶ Media ▶ Library



Manage Sources

Settings media library manage sources.jpg


Videos

Settings level: Standard
Description: This provides access to the Video Sources. It is an alternate access to Videos>Files from the main menu.
See: HOW-TO:Create Video Library


Music

Settings level: Standard
Description: This provides access to the Music Sources. It is an alternate access to Music>Files from the Music menu.
See: HOW-TO:Create Music Library


Pictures

Settings level: Standard
Description: This provides access to the Picture Sources. It is an alternate access to Pictures from the Pictures menu.
See: Pictures


Video Library

File:Settings media library video library.jpg


Update library on startup

Settings level: Standard
Description: Check for new video content every time Kodi is started.

If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media. For alternate methods to scan new items into the library...

See: Updating or removing videos


Hide progress of library updates

Settings level: Standard
Description: Hide the pop-up library scanning progress bar during scans.


Clean library

Settings level: Advanced
Description: Remove items from the library.

Many users misunderstand this function. Kodi has been designed to allow plugging and unplugging of portable hard drives. Due to this, when you run this option your media may not be deleted as expected. This is to ensure a library is not deleted because a USB HDD was unplugged.
Use the correct method of removing titles from the library as detailed in the link below.
After correctly deleting from the library first then run a clean library to purge the database of unnecessary records.

See Removing content


Export library

Settings level: Advanced
Description: Export the contents of the video library. Used as a backup of your library or to create a new Kodi installation.

For the Video library, we recommend using the Separate Files method.

See Export Video Library


Import library

Settings level: Advanced
Description: If you exported your library using the Single File method, use this to import the single file into the video library.
See Import Single File


Music Library

Settings media library music library.jpg


Update library on startup

Settings level: Standard
Description: Check for new music content every time Kodi is started.

If your content does not change often, leave this disabled as it will be running and scanning for no benefit and possibly making internet API calls for unscrapable media. For alternate methods to scan new items into the library...

See: Update Music Library


Hide progress of library updates

Settings level: Standard
Description: Hide the pop-up library scanning progress bar during scans.


Clean library

Settings level: Advanced
Description: Performs cleanup tasks on the Music database. Used to de-clutter the database of unused records. Used if you have moved, deleted or renamed files. If a source is located on removable storage that is not connected at the time of the Clean Library, you will be asked to choose to remove or keep the library entries from that drive.
  • Removes any songs with invalid paths
  • Removes any albums which have no references
  • Removes any artists which have no references
  • Removes any genres which have no references
  • Removes any paths which have no references


Export library

Settings level: Advanced
Description: Export the contents of the video library. Used as a backup of your library or to create a new Kodi installation.

For the Music library, we recommend using the Single Files method as this will also export play counts, user ratings and last played data.

See Export Music Library


Import library

Settings level: Advanced
Description: If you exported your library using the Single File method, use this to import the single file into the music library.
See Import Single File




Return to top