Settings/Media/Library: Difference between revisions
Jump to navigation
Jump to search
Clarified this (I hope) + structured markup |
mNo edit summary |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 6: | Line 6: | ||
= Manage Sources = | = Manage Sources = | ||
[[File:Settings_media_library_manage_sources.jpg| | [[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 | | 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]]''' | |||
|} | |} | ||
| Line 28: | Line 28: | ||
|- valign="top" | |- valign="top" | ||
| '''Description:''' | | '''Description:''' | ||
| This provides access to the Music Sources. It is an alternate access to | | 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]]''' | |||
|} | |} | ||
| 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]]''' | |||
|} | |} | ||
| Line 47: | Line 47: | ||
= Video Library = | = Video Library = | ||
[[File: | [[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> | ||
See: '''[[Updating or removing videos]]''' | |||
|} | |} | ||
| Line 71: | Line 70: | ||
|- valign="top" | |- valign="top" | ||
| '''Description:''' | | '''Description:''' | ||
| Hide the pop-up | | Hide the pop-up progress bar. | ||
|} | |} | ||
== Group the different versions of videos == | |||
<section begin="IgnoreVideoVersionsScan" /> | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Basic | |||
|- valign="top" | |||
| '''Description:''' | |||
| | |||
Settings ► Media ► Library ► Video Library ► '''Group the different versions of videos'''<br> | |||
This new setting in v22 replaces the former ''Ignore different video versions on scan''<br> | |||
* '''Off''' - No action taken on any video versions. ''Off'' is the same as ''Enabled'' using the former setting | |||
* '''Ask''' - When versions are found, library scans will pause until a response is made by the user. ''Ask'' is the same as ''Disabled'' using the former setting. | |||
* '''Auto''' - Automatically creates a new version without user intervention. Library scans are not interrupted. | |||
Auto uses the same existing video-matching algorithms as Ask (search by unique id then title and year) and when there is a single match, creates a new version with the type of the new setting Default version type. The default type is "Standard Edition", with a selection from all the defined types in the system. | |||
The default value is "Off", same as the current setting. <ref>https://github.com/xbmc/xbmc/pull/28349</ref> | |||
|}<section end="IgnoreVideoVersionsScan" /> | |||
: See: '''[[Video_versions|Video Versions]]''' | |||
== Make the most recent version the default version == | |||
<section begin="recentversiondefault" /> | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Advanced | |||
|- valign="top" | |||
| '''Description:''' | |||
| | |||
Settings ► Media ► Library ► Video Library ► '''Make the most recent version the default version'''<br> | |||
Setting is visible when either ''Ask'' or ''Auto'' are selected in the previous setting.<br> | |||
When an existing version or movie exists and a new version is scanned into the library, this new version becomes the default version.<br> | |||
Users who prefer managing default version themselves should disable this setting. <ref>https://github.com/xbmc/xbmc/pull/28668</ref> | |||
|}<section end="recentversiondefault" /> | |||
: See: '''[[Video_versions|Video Versions]]''' | |||
== 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. Videos in the ''Extras'' folder will be treated like a movie file and added to the library. If this is unwanted, ensure the advancedsettings.xml file has the correct ignore code.<br/> | |||
See: '''[[Video_extras#Advancedsetting.xml|Video Extras Advanced Settings]]''' | |||
|}<section end="IgnoreVideoExtrasScan" /> | |||
| Line 82: | Line 136: | ||
|- valign="top" | |- valign="top" | ||
| '''Description:''' | | '''Description:''' | ||
| | | Is used to clean orphaned entries in the library database. Not all tables are cleaned by this process. | ||
Removing content from disconnected sources<br/> | |||
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/> | |||
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]]''' | |||
|} | |} | ||
== Export library == | == Export library == | ||
| Line 100: | Line 155: | ||
| '''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. | ||
{{note|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]]''' | ||
|} | |||
== Import library == | == Import library == | ||
| Line 112: | Line 167: | ||
|- 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]]''' | ||
|} | |} | ||
| Line 119: | Line 174: | ||
= Music Library = | = Music Library = | ||
[[File:Settings_media_library_music_library.jpg| | [[File:Settings_media_library_music_library.jpg|600px]] | ||
| Line 130: | Line 185: | ||
| '''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> | ||
See: '''[[Update Music Library]]''' | |||
|} | |} | ||
| Line 154: | Line 208: | ||
|- valign="top" | |- valign="top" | ||
| '''Description:''' | | '''Description:''' | ||
| Performs cleanup tasks on the '''Music''' database. Used to de-clutter the database of unused records. Used | | 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 170: | Line 225: | ||
|- valign="top" | |- valign="top" | ||
| '''Description:''' | | '''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. | 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]]''' | ||
|} | |} | ||
| Line 184: | Line 238: | ||
|- 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]]''' | ||
|} | |} | ||
= Maintenance = | |||
[[File:Settings-Media-Library-Maintenance.jpg|600px]] | |||
== Clean image cache == | |||
{| | |||
|- valign="top" | |||
| width=120px | {{nowrap|'''Settings level:'''}} | |||
| Expert | |||
|- valign="top" | |||
| '''Description:''' | |||
| v22 adds a conservative image cache cleaning process. It removes images from the cache if they are not in the video or music library and have not been used in the past month. It is a a background process checking up to 1000 images up to 4 times per day.<br> | |||
This setting allows the user to clear all old images at once. <ref>https://github.com/xbmc/xbmc/pull/25293</ref> | |||
|} | |||
= References = | |||
<references /> | |||
| Line 194: | Line 268: | ||
{{Top}} | {{Top}} | ||
{{updated| | {{updated|22}} | ||
[[Category:Settings]] | [[Category:Settings]] | ||
Latest revision as of 08:46, 16 October 2026
|
 Settings |
Media |
Library
|
Manage Sources
Videos
| Settings level: | Standard |
| Description: | This provides access to the Video Sources. It is an alternate access to Videos►Files from the main menu. |
Music
| Settings level: | Standard |
| Description: | This provides access to the Music Sources. It is an alternate access to Music►Files from the Music menu. |
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
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. |
Hide progress of library updates
| Settings level: | Standard |
| Description: | Hide the pop-up progress bar. |
Group the different versions of videos
| Settings level: | Basic |
| Description: |
Settings ► Media ► Library ► Video Library ► Group the different versions of videos
Auto uses the same existing video-matching algorithms as Ask (search by unique id then title and year) and when there is a single match, creates a new version with the type of the new setting Default version type. The default type is "Standard Edition", with a selection from all the defined types in the system. The default value is "Off", same as the current setting. [1] |
- See: Video Versions
Make the most recent version the default version
| Settings level: | Advanced |
| Description: |
Settings ► Media ► Library ► Video Library ► Make the most recent version the default version |
- See: Video Versions
Ignore video extras on scan
| Settings level: | Basic |
| Description: |
Settings ► Media ► Library ► Video Library ► Ignore video extras on scan
See: Video Extras
|
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
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. |
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
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. |
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.
|
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. |
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 |
Maintenance
Clean image cache
| Settings level: | Expert |
| Description: | v22 adds a conservative image cache cleaning process. It removes images from the cache if they are not in the video or music library and have not been used in the past month. It is a a background process checking up to 1000 images up to 4 times per day. This setting allows the user to clear all old images at once. [3] |
References
| Return to top |
|---|