Mezzmo Kodi Addon Settings - jbinkley60/MezzmoKodiPlugin GitHub Wiki
The Mezzmo Kodi addon has a rich set of controls to maximize your viewing and ease of use experience.
Last updated January 5, 2025
Bookmark Delay - Set bookmark delay 0-30 secs behind current playback resume position. Default is 0 seconds.
Picture Slideshow Pause - Adjust slideshow pause between photos / images 2-20 secs. Default is 3 seconds.
Mezzmo Server Timeout - Mezzmo server response timeout value. Default is 60 seconds.
Other UPnP Server Timeout - non-Mezzmo UPnP server response timeout value. Default is 60 seconds.
Server Search Time - Mezzmo addon new UPnP server discovery timeout value. Default is 5 seconds.
Pause Autostop - Automatically stop paused video / music in minutes. 0 = never automatically stop paused playback.
Only Discover Mezzmo Servers - When enabled only Mezzmo severs are discovered by UPnP. Otherwise all UPnP servers are found. Default is disabled. Note - A server discovery Refresh is required after changing the setting to discover the new server setting.
Only Show Mezzmo Servers - The Mezzmo addon works with many other UPnP servers. Disabling this will display all UPnP servers found. Default is enabled.
Server No Response Dialog Box - Display dialog box for server not responding. Enable displays a dialog box. Disable displays a notification. Default is enabled.
Select Mezzmo Sync Server - Select and view Mezzmo server to sync with Kodi. If only one Mezzmo server is found it will be selected automatically.
PIN to unlock all content - Entering Mezzmo assigned PIN will override parental controls for this Kodi client
Cache Mezzmo images - Set Kodi thumbnail caching options for Mezzmo artwork. On enables caching. off disables caching and clears the cache as you browse the Mezzmo server. On demand adds a context menu item to allow you to clear the cache at any time. Default is On. Even if off the background cache process sets recently used artwork to be refetched every 30 minutes.
Kodi DB actor information copy - Add Mezzmo actor information to Kodi database during playlist browsing. Automatically disabled by background sync option when enabled and sync is achieved.
Add TV Episodes to Kodi DB - Adds Mezzmo TV episodes to the Kodi database. By Season checks for a valid season and episode number. By category checks for the category being TV Show. Video items which don't match the setting will be added to the Kodi movies folder. Default is Season.
Kodi DB Change detection - Detect Mezzmo metadata changes during playlist browsing. Automatically disabled by background sync option when enabled and sync is achieved.
Mezzmo Background Sync - Background sync process to keep Mezzmo and Kodi databases in sync. Automatically disables real time updates when sync is achieved. Default is normal.
- Off - Disables background sync process
- Daily - Just performs once a day full sync between midnight and 6AM
- Normal - Hourly sync of 1/6th of the Mezzmo database. Cycles through all Mezzmo records every 6 hours and checks newest records every hour. Also performs daily sync.
- Newest - Checks newest 400 Mezzmo records every hour and performs daily sync.
Automatic background Sync - Kodi automatically manages the Mezzmo Background Sync setting based upon the sync state with Mezzmo. Default is enabled. Disable for more manual control.
Mezzmo Duplicate Logging - Logs duplicate entries in the Mezzmo database to the Kodi logfile during daily sync process (Midnight to 6AM). A handy feature to keep your Mezzmo database clean. A duplicate entry is two or more video titles with the exact same name.
Context Menu Confirmations - Enable to provide context menu confirmation dialogs for bookmark clearing and watch status updates to protect against accidental changes. Default is enabled.
UPnP Dynamic Music Playlists - When enabled will create dynamic music playlists for UPnP servers and add a context menu item to play them. Default is disabled.
Enhanced Descriptions - Prepends additional information such as Last Played Date / Time and Play Count to media item description. Default is Off.
Kodi Additional Artwork - Adds additional Kodi artwork entries such as Clearlogo, Clearart, Banner and more which can leverage the UserPoster feature for additional artwork. Default is disabled.
Kodi DB clear Mezzmo data on startup - Clears and/or resync the Mezzmo entries in your Kodi database upon Mezzmo addon startup. Clear: Just clears Mezzmo data in the Kodi DB. Full sync: Clears and rebuilds all Mezzmo data in the Kodi DB. Option will be set to Off when complete. A regular database clear is part of the daily sync process. This option is for one time clearing.
The Mezzmo Kodi addon has a number of native mode settings to allow tailoring of your Kodi native mode experience.
Kodi Native Mode Sync - Enable for native Kodi Mezzmo data sync. This is needed to display cast metadata, movie sets and similar in native mode operation. Default is disabled. With Mezzmo Kodi addon version 2.1.6.4 and higher along with Kodi 20 (Nexus) or higher this setting also enables the Mezzmo context menu in native mode. With Kodi 19 and lower the context menu is always enabled. (See note 1)
Mezzmo Selective Sync Tag - Allows selectively synchronizing all or part of your Mezzmo library with Kodi. Default is All.
Mezzmo Fast Sync Time - Fast Sync speeds up sync time between Mezzmo and Kodi when opperting in native mode. )-5 minutes. Default is 0, which is disabled
Kodi Bookmark Sync - Syncs Mezzmo bookmarks to the Kodi DB. This is valuable if you access Mezzmo via the native Kodi skin. Default is disabled. (See note 1)
Native Mode TV Show Actors - Enables listing of all TV Show actors in native skin mode. Default is disabled. (See note 1)
Sync Kodi Tags From Mezzmo - Enable for native Kodi mode to sync Mezzmo keywords to Kodi tags. Default is disabled. (See note 1 and note 2)
Kodi Music Video Sync - Enable to sync Mezzmo category music video as Kodi music videos otherwise they will sync as movies. Default is disabled. (See note 1 and note 3)
Kodi Director / Writer Sync - Enabled to sync Kodi director_link and writer_link tables to Mezzmo for Kodi skins which leverage this feature. Enabling this may cause movies and TV episodes to appear in actor searchers where the selected actor is the director when using the Kodi information window actor search. This is skin dependent. Default is disabled (See note 1)
Kodi Single Studio Sync - When enabled only syncs and displays one studio with Kodi. This is to address certain Kodi skins which can only handle a single studio. Default is disabled. (See note 4)
Kodi Native Skin Updates - Reloads the Kodi skin, to show changes, after direct Kodi DB updates like the sync process and similar. Default is disabled. (See note 5)
Note 1 - When enabling these settings a full sync cycle is needed for the Kodi database to update for additional native mode capabilities.
Note 2 - When synchronizing TV show Keywords to Kodi Tags all episodes in Mezzmo must have the keyword which is mapped to the tag. This is due to Mezzmo not having an exact equivalent to a TV Show in Kodi. You can use the multi-select feature to bulk update the keyword all episodes in a TV series.
Note 3 - Not all Kodi skins support native music videos. Keep option disabled for those skins
Note 4 - Only available on Kodi 19+ and higher version of the Mezzmo Kodi Addon beginning with 2.2.0.0
Note 5 - Do not enable if you only use GUI mode. Enabling can interfere with GUI mode searches by the background refresh causing the search history dialog box to appear while searching.
The Mezzmo Kodi addon provides an easy way to manage your Kodi viewing experience. The addon will detect media types as you browse your library and match the view mode to the settings below. No more playlist or folder level managing of your views.
Last Played - Enables the Last Played Media feature. 0 disables the feature. The default is 10 and 30 is the maximum.
Playlist / Folder Backdrop - Selects backdrop when browsing playlists. Choices are standard Mezzmo addon backdrop , Mezzmo playlist / folder backdrop or None. Default is Mezzmo.
Mezzmo View Mapping - Allow Mezzmo to manage Kodi views based upon the media type and view settings. Default is enabled.
Automatic Slideshow Viewer - Enable slideshow viewer when browsing pictures. When enabled a prompt will be displayed asking if the pictures should be shown using a slideshow viewer. Default is enabled.
Kodi UPnP Pictures / Photos - Playing of pictures / photos via UPnP with Kodi doesn't always work. You can enable this setting to try with a UPnP server. Default is disabled. When disabled you will see a popup saying UPnP photos aren't supported, if you browse a UPnP server which leverages UPnP vs. HTTP(s) for pictures. This option is only available on the Kodi 19+ version of the addon.
View settings - You can set your view preferences by skin (Estuary, Confluence, Aeon Nox 5). If you don't see your skin use Confluence, which is also the default mapping. The Mezzmo Kodi addon will detect the various media types and present them with the view mapping selected for each type. If a playlist has mixed media types then the view will be based upon the last item in the list.
The Mezzmo Kodi addon provides a set of capabilities for managing trailers and providing a unique experience with Mezzmo Movie Previews.
Multiple Trailer Count - Sets the number of trailers to display when accessed via the context menu. 0 is disabled, 10 is default and 20 is maximum.
Mezzmo Movie Preview Count - Mezzmo Movie Previews feature number of trailers to play before the main movie 0-6. 0 = disabled. Default is 3.
Mezzmo Preview Trailer Volume Adjust % - Adjusts Mezzmo Preview trailer playback volume. This can be used when the Mezzmo Preview trailer volume is different than the main movie. Default is 100 percent. See note below.
Mezzmo Preview Movie Volume Adjust %- Adjusts Mezzmo Preview movie playback volume. This can be used when the Mezzmo Preview movie volume is different than the trailer volume. Default is 100 percent. See note below.
Prefer Local Trailers - When enabled will only sync local trailers to Kodi when found otherwise You Tube trailers will sync. Also the Mezzmo Movie Preview feature will only play local trailers. Default is enabled. See here for more information.
Release Year Trailers - When enabled the Mezzmo Movie Preview trailers will be from the year the movie was released to recreate a theater like experience. If disabled they will be from the current year. Default is enabled.
Refresh Screen After Preview Playback - When enabled will refresh the Kodi screen after playback of the main movie completes. Not all Kodi skins (such as Confluence) refresh properly after playing a playlist. Enabling this resolves the issue. Default is disabled.
Enhanced Trailer Information - Provide additional local trailer information regarding trailer type and enables color settings by type. Default is disabled.
Player Trailer Color - Selects trailer information color for trailers which have been played.
Local IMDB Trailer Color - Selects trailer information color for local IMDB trailers.
Local YouTube Trailer Color - Selects trailer information color for local YouTube trailers.
Note - Mezzmo Preview Trailer and Movie volume adjustments will not work when Kodi is in audio passthrough mode since Kodi does not manage the volume, it just passes the audio streams through.
Mezzmo offers a wide range of search capabilities from the Kodi addon. These settings help you customize your searches.
Maximum Mezzmo Search Results 25-500 - Limits the number of search results from Mezzmo to 25-500. Default is 100.
Search History 0-30 (searches) - Number of prior search histories to retain for quick repeat searching. Default is 10.
Search Default Sort Order - Selects the sort order for Mezzmo search results. The default setting is Default. Default means that Kodi manages the sort order based upon the last time the specific search was run.
Search Default Content Type - Selects the default content type for Mezzmo search results. The default setting is None which will use the search results content type.
The remaining settings allow selecting which media types and metadata elements will be included in searches.
Searches can be initiated from the context menu in any folder or playlist in GUI mode and from the native mode context menu on any Kodi library item.
Beginning with the Mezzmo Kodi addon versions 1.1.6.2 / 2.1.6.2 this diagnostics category of settings is available to assist with troubleshooting metadata responses from Mezzmo and UPnP servers. This avoids putting Kodi into debug mode to gather this information.
Mezzmo Server Response Logging - Enables logging a specific number of Mezzmo server responses before automatically disabling. Default is disabled. Maximum is 25.
UPnP Server Response Logging - Enables logging a specific number of UPnP server responses before automatically disabling. Default is disabled. Maximum is 25.
Mezzmo Reduced General Logging - When enabled fewer general information log messages will be written to the Kodi.log file. Errors and exceptions will still be written and all log messages will continue to be available in the Mezzmo Kodi addon log viewer.
Mezzmo Reduced Sync Logging - When enabled fewer background sync process information log messages will be written to the Kodi.log file. Errors and exceptions will still be written and all log messages will continue to be available in the Mezzmo Kodi addon log viewer.
Performance Logging Enabled - Logs performance Mezzmo and Kodi addon statistics to the Kodi logfile. Default is enabled.
Mezzmo Maximum Playcount - Option to limit the maximum value of playcounts for video items in your Mezzmo library. See Mezzmo Maximum Playcount feature Wiki page for complete option setting details
Hide Watched Monitoring - Monitors Hide Watched setting druing hourly background sync process. Options are log to general logs or log and notify via GUI. Default is Off.
Export Data From Database - Select Kodi DB or Mezzmo addon table(s) for export to CSV format for external use.