Settings/Media/Library: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Updated for v19)
(v21 Updates)
 
(6 intermediate revisions by 2 users not shown)
Line 6: Line 6:


= Manage Sources =
= Manage Sources =
[[File:Settings_media_library_manage_sources.jpg|500px]]
[[File:Settings_media_library_manage_sources.jpg|600px]]




Line 16: Line 16:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| This provides access to the Video Sources. It is an alternate access to Videos>Files from the main menu.
| This provides access to the Video Sources. It is an alternate access to Videos>Files from the main menu.<br>
{{see|HOW-TO:Create Video Library}}
See: '''[[HOW-TO:Create Video Library]]'''
|}
|}


Line 28: Line 28:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| This provides access to the Music Sources. It is an alternate access to Music>Files from the Music menu.
| This provides access to the Music Sources. It is an alternate access to Music>Files from the Music menu.<br>
{{See|HOW-TO:Create Music Library}}
See: '''[[HOW-TO:Create Music Library]]'''
|}
|}


Line 40: Line 40:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| This provides access to the Picture Sources. It is an alternate access to Pictures from the Pictures menu.
| This provides access to the Picture Sources. It is an alternate access to Pictures from the Pictures menu.<br>
{{See|Pictures}}
See: '''[[Pictures]]'''
|}
|}


Line 47: Line 47:


= Video Library =
= Video Library =
[[File:Settings_media_library_video_library.jpg|500px]]
[[File:Settings-Media-Library-VideoLibrary.jpg|600px]]




Line 58: Line 58:
| '''Description:'''
| '''Description:'''
| Check for new video content every time {{kodi}} is started.
| 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.
'''Note: '''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.<br>
For alternate methods to scan new items into the library...
See: '''[[Updating or removing videos]]'''
{{see|Updating or removing videos}}
|}
|}


Line 71: Line 70:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Hide the pop-up library scanning progress bar during scans.
| Hide the pop-up progress bar.
|}
|}
== Ignore different video versions on scan ==
<section begin="IgnoreVideoVersionsScan" />
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Basic
|- valign="top"
| '''Description:'''
|
Settings ► Media ► Library ► Video Library ► '''Ignore different video versions on scan'''
* '''Disabled''' - When an Update Library is run and the scanner discovers a title that may be a duplicate of another title already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate. The Library Update will not continue until the pop-up is cleared.
* '''Enabled''' - (default) When an Update Library is run, there are no interruptions to the scan and the various versions will be scanned or scraped into the library without a video version being created. Use the Versions Manager method described below to create a Video Version after scanning has ended.
|}<section end="IgnoreVideoVersionsScan" />
== Ignore video extras on scan ==
<section begin="IgnoreVideoExtrasScan" />
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Basic
|- valign="top"
| '''Description:'''
|
Settings ► Media ► Library ► Video Library ► '''Ignore video extras on scan'''
* '''Disabled''' - When an Update Library is run, and if a folder named ''Extras'' exists, any video files in the folder will be added to the Extras listing for the movie.<br/>See: '''[[Video_extras|Video Extras]]'''
* '''Enabled''' - (default) When an Update Library is run, any extras in the ''Extras'' folder will not be added to the Extras listing.<br/>Videos in the ''Extras'' folder will be treated like a movie file and added to the library. To avoid this ensure the advancedsettings.xml file has the correct ignore code.<br/>See: '''[[Add-on:Extras#Preventing_Extras_Being_Added_To_Library|Preventing Extras being added to the library]]'''
|}<section end="IgnoreVideoExtrasScan" />




Line 82: Line 113:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Remove items from the library.
| Is used to clean orphaned entries in the library database. Not all tables are cleaned by this process.
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>
Removing content from disconnected sources<br/>
After correctly deleting from the library ''first'' then run a clean library to purge the database of unnecessary records.
If storage media are disconnected, using this function will not remove their contents from the library. This protects your library from accidental erasure in case a removable storage device is unplugged.<br/>
: See '''[[Updating_or_removing_videos#Remove_From_Library|Removing content]]'''
To permanently remove titles from the library:
# 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.<br>
See: '''[[Updating_or_removing_videos#Remove_From_Library|Removing content]]'''
|}
|}


Line 97: Line 131:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Export the contents of the video library. Used as a backup of your library or to create a new {{kodi}} installation.
| 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.
{{note|For the Video library, we recommend using the Separate Files method.}}<br>
: See '''[[Import-export_library/Video|Export Video Library]]'''
See: '''[[Import-export_library/Video|Export Video Library]]'''
 
|}
|}


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


Line 118: Line 151:


= Music Library =
= Music Library =
[[File:Settings_media_library_music_library.jpg|500px]]
[[File:Settings_media_library_music_library.jpg|600px]]




Line 129: Line 162:
| '''Description:'''
| '''Description:'''
| Check for new music content every time {{kodi}} is started.
| 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.
'''Note:''' 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.<br>
For alternate methods to scan new items into the library...
See: '''[[Update Music Library]]'''
{{see|Update Music Library}}
|}
|}


Line 153: Line 185:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''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.
| Performs cleanup tasks on the '''Music''' database. Used to de-clutter the database of unused records. Used when you have moved, deleted or renamed files. To remove music from the library, delete the music files first then run the Clean library option.<br>
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 songs with invalid paths
* Removes any albums which have no references
* Removes any albums which have no references
Line 169: Line 202:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Export the contents of the video library. Used as a backup of your library or to create a new {{kodi}} installation.
| Music files are still required to have the correct embedded tags to be scanned into the library. This function will export the additional data that was scraped into the music library.  
For the Music library, we recommend using the Single Files method as this will also export play counts, user ratings and last played data.
For the Music library, we recommend using the Single Files method as this will also export play counts, user ratings and last played data.<br>
: See '''[[Import-export_library/Music|Export Music Library]]'''
See: '''[[Import-export_library/Music|Export Music Library]]'''
 
|}
|}


Line 183: Line 215:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| If you exported your library using the '''Single File''' method, use this to import the single file into the music library.
| If you exported your library using the '''Single File''' method, use this to import the single file into the music library.<br>
: See '''[[Import-export_library/Music#Import_-_Single_File|Import Single File]]'''
See: '''[[Import-export_library/Music#Import_-_Single_File|Import Single File]]'''
|}
|}




Line 193: Line 224:


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


[[Category:Settings]]
[[Category:Settings]]

Latest revision as of 00:54, 1 May 2024

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

Settings-Media-Library-VideoLibrary.jpg


Update library on startup

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

Note: 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.
See: Updating or removing videos


Hide progress of library updates

Settings level: Standard
Description: Hide the pop-up progress bar.


Ignore different video versions on scan

Settings level: Basic
Description:

Settings ► Media ► Library ► Video Library ► Ignore different video versions on scan

  • Disabled - When an Update Library is run and the scanner discovers a title that may be a duplicate of another title already scanned into the library, the Update Library will pause with a pop-up requesting confirmation on how to treat the duplicate. The Library Update will not continue until the pop-up is cleared.
  • Enabled - (default) When an Update Library is run, there are no interruptions to the scan and the various versions will be scanned or scraped into the library without a video version being created. Use the Versions Manager method described below to create a Video Version after scanning has ended.


Ignore video extras on scan

Settings level: Basic
Description:

Settings ► Media ► Library ► Video Library ► Ignore video extras on scan

  • Disabled - When an Update Library is run, and if a folder named Extras exists, any video files in the folder will be added to the Extras listing for the movie.
    See: Video Extras
  • Enabled - (default) When an Update Library is run, any extras in the Extras folder will not be added to the Extras listing.
    Videos in the Extras folder will be treated like a movie file and added to the library. To avoid this ensure the advancedsettings.xml file has the correct ignore code.
    See: Preventing Extras being added to the library


Clean library

Settings level: Advanced
Description: Is used to clean orphaned entries in the library database. Not all tables are cleaned by this process.

Removing content from disconnected sources
If storage media are disconnected, using this function will not remove their contents from the library. This protects your library from accidental erasure in case a removable storage device is unplugged.
To permanently remove titles from the library:

  1. Use the correct method of removing titles from the library as detailed in the link below.
  2. 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.

Note: 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.

Note: 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.
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 when you have moved, deleted or renamed files. To remove music from the library, delete the music files first then run the Clean library option.

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: Music files are still required to have the correct embedded tags to be scanned into the library. This function will export the additional data that was scraped into the music library.

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
Retrieved from "https://kodi.wiki/index.php?title=Settings/Media/Library&oldid=252617"