Kodi add-on settings

These are the settings you see in Kodi, in Add-ons → Elementum → Configure. The list is generated from the add-on’s settings.xml of the latest release, so it is always in sync with the add-on.

Setting is the name shown in Kodi (English).
ID is the key used in settings.xml, in exported config files and in Kodi’s userdata/addon_data/plugin.video.elementum/settings.xml.
Default and Values show the default and the allowed values (for sliders, the range).
Rows in italics are hints Kodi shows inside the settings dialog.

Some settings are only visible when another one is enabled (for example, memory size only for the Memory storage).

From plugin.video.elementum v0.1.117.

General

Setting	ID	Type	Default	Values
Addon Startup
Show welcome message on start	`greeting_enabled`	bool	true
Skip searching for installed providers	`skip_burst_search`	bool	false
Skip searching for installed Elementum repository	`skip_repository_search`	bool	false
Delay addon startup, seconds	`startup_delay`	slider	0	0 – 180
Retry requests to addon after timeout, seconds	`preload_timeout`	slider	1	1 – 120
Application platform type	`binary_platform`	select	Auto	Auto / android_arm / android_arm64 / android_x86 / android_x64 / linux_armv6 / linux_armv7 / linux_armv7_softfp / linux_arm64 / linux_x86 / linux_x64 / darwin_x86 / darwin_x64 / darwin_arm64 / windows_x86 / windows_x64
Restart Elementum addon	`action_restart`	action
Playback
Force Resume options	`play_resume_action`	enum	by Elementum - Ask	by Kodi / by Elementum - Ask / by Elementum - Force
... resume N seconds earlier	`play_resume_back`	slider	0	0 – 120
Storage
Download storage type	`download_storage`	enum	Use memory	Use files / Use memory
Choose memory size automatically	`auto_memory_size`	bool	true
Size is chosen automatically, based on physical amount of memory
Allow memory usage	`auto_memory_size_strategy`	enum	Default	Minimum / Default / Maximum
Minimum - 40MB, Default - 8%, Maximum - 15%
Memory size to use for each torrent, Mb	`memory_size`	number	100
Automatically adjust memory size for heavy torrents, if possible	`auto_adjust_memory_size`	bool	true
Create usual files on the file system and write to them. Needs selected file's full size to be available on the disk!
Using device's memory to download parts of the torrent. Disk is used only to download and save .torrent file,
so can be any storage. For 1gb memory devices 100mb is enough for memory storage, 200-250mb for bigger devices.
Same as for usual file storage, but splits file into many small files. Should be used on FAT-32 file-systems.
Same as for usual file storage, but using memory to lower filesystem operations. Experimental storage!
Which files to download	`download_file_strategy`	enum	Only playback file	Only playback file / Season files / All files
Download path	`download_path`	folder
Reset this path to '/'	`action_cmd_reset_path_download`	action
Open directory with Kodi file browser	`action_cmd_open_path_download`	action
Library path	`library_path`	folder	special://temp/elementum_library/
Reset this path to '/'	`action_cmd_reset_path_library`	action
Open directory with Kodi file browser	`action_cmd_open_path_library`	action
Torrent files path	`torrents_path`	folder	special://temp/elementum_torrents/
Reset this path to '/'	`action_cmd_reset_path_torrents`	action
Open directory with Kodi file browser	`action_cmd_open_path_torrents`	action
Reset all paths	`action_cmd_reset_path`	action
Download
Use torrents history?	`use_torrent_history`	bool	true
Store N torrents in history	`torrent_history_size`	slider	50	0 – 200
Download after play was stopped	`keep_downloading`	enum	Ask to stop	Continue / Ask to stop / Stop
Keep files for not finished video	`keep_files_playing`	enum	Ask to delete	Keep / Ask to delete / Delete
Keep files for watched/downloaded video	`keep_files_finished`	enum	Ask to delete	Keep / Ask to delete / Delete
Move finished downloads to separate folders	`completed_move`	bool	false
Movies	`completed_movies_path`	folder
TV Shows	`completed_shows_path`	folder
Rename moved files to Kodi naming (Title (Year), Show S01E01)	`completed_rename`	bool	false
Files will only be moved after seeding is finished (see - BitTorrent settings), and will wait if currently playing
Do not ask questions before playback	`silent_stream_start`	bool	false
Automatically answer Yes after timeout	`autoyes_enabled`	bool	true
Timeout, seconds	`autoyes_timeout`	slider	5	1 – 120
Force stream auto-selection from settings	`force_link_type`	bool	false
Try to find other episodes in the torrent	`smart_episode_match`	bool	true
Automatically start downloading next episode	`smart_episode_start`	bool	true
Automatically start next episode if available	`smart_episode_choose`	bool	true
Cache downloaded torrent files after search	`use_cache_torrents`	bool	true
Show watched state for torrent's files	`show_files_watched`	bool	true
Choose stream automatically
... for movie	`choose_stream_auto_movie`	bool	false
... for tv show	`choose_stream_auto_show`	bool	false
... for search	`choose_stream_auto_search`	bool	false

Kodi library

Setting	ID	Type	Default	Values
General
Enable library integration with Kodi	`library_enabled`	bool	true
If disabled - Elementum will not get/insert items to Kodi library and skip watched management with Kodi.
Maintenance
Update library	`action_library_update`	action
Enable Kodi library synchronization	`library_sync_enabled`	bool	true
Enable synchronization while playback	`library_sync_playback_enabled`	bool	true
Library update delay on startup, seconds	`library_update_delay`	slider	300	10 – 900
Library update frequency, hours	`library_update_frequency`	slider	6	0 – 24
Remove Elementum duplicates from library	`action_library_unduplicate`	action
General
Add Specials to library	`add_specials`	bool	false
Show unaired seasons	`unaired_seasons`	bool	false
Show unaired episodes	`unaired_episodes`	bool	false
Show episodes on release day (w/o delay)	`show_episodes_on_release_day`	bool	false
Percents of playback to mark as watched	`playback_percent`	slider	85	1 – 100
Run Kodi library update after add/delete	`library_update`	enum	Automatically	Automatically / Ask / No
Remove from Elementum library, when item is deleted from Kodi library	`library_sync_kodi_removals`	bool	false
Strm files language	`strm_language`	action
Create NFO files for Movie scrapers	`library_nfo_movies`	bool	true
Create NFO files for TV Show scrapers	`library_nfo_shows`	bool	true

Appearance

Setting	ID	Type	Default	Values
Appearance
Interface language	`language`	action
Interface fallback language	`second_language`	action
Disable notification sound	`do_not_disturb`	bool	false
Enable overlay status	`enable_overlay_status`	bool	true
Overlay status vertical offset	`overlay_status_offset`	number	150
Disable background progress dialog	`disable_bg_progress`	bool	false
Disable background progress dialog on playback	`disable_bg_progress_playback`	bool	true
Add episode number to the title	`add_episode_numbers`	bool	true
Lists
Elements per page	`results_per_page`	slider	20	3 – 50
Use fallback fanart if fanart wasn't found	`default_fanart`	bool	true
Use Fanart.tv for posters/images	`use_fanart_tv`	bool	false
TMDB images quality (affects Kodi performance)	`tmdb_images_quality`	enum	High	Original / High / Medium / Low
Show "All seasons" in shows	`seasons_all`	bool	true
Seasons order	`seasons_order`	enum	Ascending	Ascending / Descending
Show Specials in season listings	`seasons_specials`	bool	true
Use name of production company as Studio for shows	`tmdb_show_use_prod_company_as_studio`	bool	false
Calculate number of unwatched episodes in Shows/Seasons	`show_unwatched_episodes_number`	bool	true
Use the same view for all lists	`viewmode_global_enabled`	bool	false
Default view for all lists	`viewmode_global_id`	number
Default view for Movies	`viewmode_movies`	number
Default view for TV Shows	`viewmode_tvshows`	number
Default view for Seasons	`viewmode_seasons`	number
Default view for Episodes	`viewmode_episodes`	number
Default view for menus in Movies	`viewmode_menus_movies`	number
Default view for menus in TV Shows	`viewmode_menus_tvshows`	number
Default view for movie genres	`viewmode_menus_movies_genres`	number
Default view for TV show genres	`viewmode_menus_tvshows_genres`	number

BitTorrent

Setting	ID	Type	Default	Values
Pre-Play Buffering
Beginning of file Buffer size, MB	`buffer_size`	number	20
End of file Buffer size, MB	`end_buffer_size`	number	4
Adjust buffer according to Kodi advancedsettings.xml, if set	`auto_kodi_buffer_size`	bool	true
Initial buffering timeout, seconds	`buffer_timeout`	slider	60	10 – 600
Speed limiting
Max upload rate, kB/s	`max_upload_rate`	number
Max download rate, kB/s	`max_download_rate`	number
Limit rates after initial buffering only	`limit_after_buffering`	bool	false
Torrents autoload on addon startup
Load torrents from torrents folder on startup	`autoload_torrents`	bool	true
Load torrents from torrents folder paused	`autoload_torrents_paused`	bool	true
Limits for connections
Connections limit	`connections_limit`	number
Automatic concurrent connections limit per second	`conntracker_limit_auto`	bool	true
Concurrent connections limit per second	`conntracker_limit`	number
Seeding
Seed forever	`seed_forever`	bool	false
Share ratio limit, percentage	`share_ratio_limit`	number	200
Seed time ratio limit, percentage	`seed_time_ratio_limit`	number	700
Seed time limit, hours	`seed_time_limit`	number	24
Network
Disable DHT	`disable_dht`	bool	false
Disable LSD	`disable_lsd`	bool	false
Disable TCP	`disable_tcp`	bool	false
Disable UTP	`disable_utp`	bool	false
Disable UPNP	`disable_upnp`	bool	false
Disable NATPMP	`disable_natpmp`	bool	false
Auto-assign network IP	`listen_autodetect_ip`	bool	true
Listen interfaces	`listen_interfaces`	text
Select network interface	`action_cmd_select_interface_listen`	action
Outgoing interfaces	`outgoing_interfaces`	text
Select network interface	`action_cmd_select_interface_outgoing`	action
Auto-assign network ports	`listen_autodetect_port`	bool	true
Listen port, min	`listen_port_min`	number	6891
Listen port, max	`listen_port_max`	number	6899
Magnet resolve timeout, seconds	`magnet_resolve_timeout`	slider	60	1 – 600
Storage
Enable caching if using File storage and have speed problems. Will use more memory, but can improve the speed.
Enable tuned storage settings	`tuned_storage`	bool	true
Cache size, MB	`disk_cache_size`	number	12
Miscellaneous
Session saving frequency, seconds	`session_save`	slider	15	5 – 60
Encryption policy	`encryption_policy`	enum	Enabled	Enabled / Disabled / Forced
Spoof user agent (highly inadvisable)	`spoof_user_agent`	enum	Disabled	Disabled / Default advisable (acceptable) / libtorrent (Rasterbar) 1.1.0 / BitTorrent 7.5.0 / BitTorrent 7.9.9 / µTorrent 3.5.5 / µTorrent 3.6.0 / µTorrent 2.2.1 / Transmission 2.92 / Deluge 1.3.6 / Deluge 2.1.1 / Vuze 5.7.3.0 / Transmission 4.05 / qBittorrent 3.3.9 / qBittorrent 4.6.4
Use libtorrent.config to override torrent engine settings	`use_libtorrent_config`	bool	true
Located at USERDATA/plugin.video.elementum/libtorrent.config file Settings apply automatically. Visit https://libtorrent.org for info.
Remove original trackers from torrent	`remove_original_trackers`	bool	false
Add extra trackers	`add_extra_trackers`	enum	All known trackers	None / All known trackers / Best trackers / Minimum set
Modify trackers in torrent	`modify_trackers_strategy`	enum	At the time of adding	At the time of adding / Every time
Enable libtorrent logging	`use_libtorrent_logging`	bool	false
Libtorrent settings profile	`libtorrent_profile`	enum	Default	Default / Minimal memory / High speed
Use libtorrent pause/resume trick for added torrents	`use_libtorrent_pauseresume`	bool	false

Tracking

Setting	ID	Type	Default	Values
Authorization
Tracking service	`tracker_provider`	enum	Trakt	None / Trakt / Simkl / MDBList
Authorize Elementum on Trakt.tv	`action_trakt_authorize`	action
Cancel Authorization for Elementum on Trakt.tv	`action_trakt_deauthorize`	action
Username
Authorize Elementum on Simkl	`action_simkl_authorize`	action
Cancel authorization for Elementum on Simkl	`action_simkl_deauthorize`	action
Username
Simkl has no collection: library additions go to Plan to Watch. Custom lists need Simkl PRO or VIP.
Authorize Elementum on MDBList	`action_mdblist_authorize`	action
Cancel authorization for Elementum on MDBList	`action_mdblist_deauthorize`	action
Username
MDBList API key (optional, used instead of authorization)	`mdblist_api_key`	text
An API key from mdblist.com preferences can be used instead of authorization. Free accounts allow 1000 requests a day.
Appearance
Use Trakt information in Trakt lists	`force_use_trakt`	bool	false
General
Scrobble	`trakt_scrobble`	bool	false
Enable synchronization	`trakt_sync_enabled`	bool	true
Enable synchronization while playback	`trakt_sync_playback_enabled`	bool	true
Synchronization frequency, minutes	`trakt_sync_frequency_min`	slider	5	0 – 300
Simkl and MDBList are synchronized at most every 15 minutes.
Update from tracking service	`action_trakt_update`	action
Synchronization
Sync items from collections into Kodi library	`trakt_sync_collections`	bool	true
Sync items from watchlist into Kodi library	`trakt_sync_watchlist`	bool	true
Sync items from user lists into Kodi library	`trakt_sync_userlists`	bool	true
Select userlists to sync	`action_trakt_select_sync_userlists`	action
Selected userlists (all, if empty)
Sync watched states from tracking service into Kodi library	`trakt_sync_watched`	bool	true
Sync back Kodi watched states into tracking service	`trakt_sync_watchedback`	bool	true
Sync playback progress into Kodi library	`trakt_sync_playback_progress`	bool	true
Sync hidden items	`trakt_sync_hidden`	bool	true
Add to tracking service, when movie is added to Kodi library	`trakt_sync_added_movies`	bool	true
Userlist for movies	`trakt_sync_added_movies_location`	enum	My Collection	My Collection / My Watchlist / Userlist
Select userlist for movies	`action_trakt_select_list_added_movies`	action
Selected userlist for movies
ID of selected userlist for movies	`trakt_sync_added_movies_list`	number
Add to tracking service, when show is added to Kodi library	`trakt_sync_added_shows`	bool	true
Userlist for shows	`trakt_sync_added_shows_location`	enum	My Collection	My Collection / My Watchlist / Userlist
Select userlist for shows	`action_trakt_select_list_added_shows`	action
Selected userlist for shows
ID of selected userlist for shows	`trakt_sync_added_shows_list`	number
Remove from Kodi library, when movie is deleted from tracking service	`trakt_sync_removed_movies_back`	bool	true
Remove from tracking service, when movie is deleted from Kodi library	`trakt_sync_removed_movies`	bool	true
Userlist for movies	`trakt_sync_removed_movies_location`	enum	My Collection	My Collection / My Watchlist / Userlist
Select userlist for movies	`action_trakt_select_list_removed_movies`	action
Selected userlist for movies
ID of selected userlist for movies	`trakt_sync_removed_movies_list`	number
Remove from Kodi library, when show is deleted from tracking service	`trakt_sync_removed_shows_back`	bool	true
Remove from tracking service, when show is deleted from Kodi library	`trakt_sync_removed_shows`	bool	true
Userlist for shows	`trakt_sync_removed_shows_location`	enum	My Collection	My Collection / My Watchlist / Userlist
Select userlist for shows	`action_trakt_select_list_removed_shows`	action
Selected userlist for shows
ID of selected userlist for shows	`trakt_sync_removed_shows_list`	number
Progress
Sort shows in the list	`trakt_progress_sort`	enum	By latest watched	By latest watched / By show name / By air date (newer) / By air date (older)
Hide unaired episodes	`trakt_progress_hide_unaired`	bool	true
Use earliest release date for progress and calendars	`trakt_use_lowest_release_date`	bool	true
Color of an air date	`trakt_progress_color_date`	text	yellow
Color of a show name	`trakt_progress_color_show`	text	none
Color of an episode name	`trakt_progress_color_episode`	text	skyblue
Color of an unaired episode name	`trakt_progress_color_unaired`	text	deeppink
Date format	`trakt_progress_date_format`	text	yyyy-mm-dd
Calendars
Hide watched	`trakt_calendars_hide_watched`	bool	false
Color of an air date	`trakt_calendars_color_date`	text	yellow
Color of a show name	`trakt_calendars_color_show`	text	none
Color of an episode name	`trakt_calendars_color_episode`	text	skyblue
Color of an unaired episode name	`trakt_calendars_color_unaired`	text	deeppink
Date format	`trakt_calendars_date_format`	text	yyyy-mm-dd

Providers

Setting	ID	Type	Default	Values
Searching
Use earliest release date as basic for searching	`provider_use_lowest_release_date`	bool	true
Minimum file size
Minimum file size for Movies, MB	`min_candidate_size`	slider	100	0 – 1000
Minimum file size for Shows, MB per minute	`min_candidate_show_size`	slider	4	0 – 1000
Stream sorting
Sorting mode for Movies	`sorting_mode_movies`	enum	Balanced	By seeders / By resolution / Balanced / By size
Sorting mode for TV Shows	`sorting_mode_shows`	enum	Balanced	By seeders / By resolution / Balanced / By size
Resolution preference for Movies	`resolution_preference_movies`	enum	4K / 1080p / 720p / 480p	4K / 1080p / 720p / 480p / 720p / 1080p / 480p / 4K / 720p / 480p / 1080p / 4K / 480p / 720p / 1080p / 4K
Resolution preference for TV Shows	`resolution_preference_shows`	enum	4K / 1080p / 720p / 480p	4K / 1080p / 720p / 480p / 720p / 1080p / 480p / 4K / 720p / 480p / 1080p / 4K / 480p / 720p / 1080p / 4K
Percentage of additional seeders required before choosing next resolution	`percentage_additional_seeders`	number	25
Caching
Cache stream selection	`use_cache_selection`	bool	true
Cache stream search results	`use_cache_search`	bool	false
Cache search results duration, seconds	`cache_search_duration`	number	180
Providers
Disable providers that failed health check	`provider_disable_failing`	bool	false
Allowed failures before provider is disabled	`provider_allowed_failures`	slider	3	0 – 10
Redefine providers timeout
Enabled (might lead to slow speed)	`custom_provider_timeout_enabled`	bool	false
Timeout, seconds	`custom_provider_timeout`	slider	30	7 – 180

Proxy

Setting	ID	Type	Default	Values
Internal DNS client
Use built-in DNS resolver	`internal_dns_enabled`	bool	false
Turn off if you use Tor addresses, or you want to use DNS settings from OS
Skip IPv6 addresses resolving	`internal_dns_skip_ipv6`	bool	true
DNS over HTTPS Server	`internal_dns_server`	select	Cloudflare + Google + Quad9 + OpenNameServer.org	Cloudflare + Google + Quad9 + OpenNameServer.org / Cloudflare / Google / Quad9 / OpenNameServer.org / Custom
Custom DNS over HTTPS Server	`internal_dns_server_custom`	text
Use OpenNIC DNS Servers	`internal_dns_opennic_use`	bool	false
Use OpenNIC DNS Servers for regular domains	`internal_dns_opennic_regular`	bool	false
Proxy
Enabled	`proxy_enabled`	bool	false
Proxy type	`proxy_type`	enum	SOCKS5	SOCKS4 / SOCKS5 / HTTP / i2p
Host	`proxy_host`	text
Port	`proxy_port`	number	1080
Login	`proxy_login`	text
Password	`proxy_password`	text
Use Proxy for downloading .torrent files	`use_proxy_http`	bool	true
Use Proxy for trackers	`use_proxy_tracker`	bool	true
Use Proxy for torrent downloading	`use_proxy_download`	bool	true
Force to always use proxy, can break download in some cases	`proxy_force`	bool	false
Use Antizapret proxy (only for Russia)	`antizapret_enabled`	bool	false
Antizapret PAC file URL	`antizapret_pac_url`	text	https://p.thenewone.lol:8443/proxy.pac
Internal HTTP proxy
Can be used by search providers or for debugging
Enable built-in HTTP proxy	`internal_proxy_enabled`	bool	false
Use built-in proxy for Elementum requests	`internal_proxy_app_requests`	bool	true
Log Internal proxy requests	`internal_proxy_logging`	bool	false
Log server's response body	`internal_proxy_logging_body`	bool	false

Subtitles

Setting	ID	Type	Default	Values
OpenSubtitles.com
Username	`opensubtitles_user`	text
Password	`opensubtitles_pass`	text
Use Kodi language for subtitles search	`osdb_auto_language`	bool	true
Language code for subtitles (example: en, it, es)	`osdb_language`	text
Automatic Subtitles Search
Automatically load first found subtitles	`osdb_auto_load`	bool	false
Number of subtitles to load automatically	`osdb_auto_load_count`	slider	1	1 – 20
Delete autoloaded subtitles on player stop	`osdb_auto_load_delete`	bool	true
Disable if subtitles are available in player	`osdb_auto_load_skipexists`	bool	true
Subtitles included in torrent
Enabled	`osdb_included_enabled`	bool	true
Disable if subtitles are available in player	`osdb_included_skipexists`	bool	true

Addon Startup

Setting	ID	Type	Default
Addon Startup
Restart Elementum addon	`action_restart_2`	action
Do not start binary (client mode)	`local_only_client`	bool	false
Force start as a library	`local_force_library`	bool	false
Addon Connectivity
Local port	`local_port`	number	65221
Local host (empty - automatic)	`local_host`	text
Remote host	`remote_host`	text	127.0.0.1
Remote port	`remote_port`	number	65220
Authorization
Remote host login	`remote_login`	text
Remote host password	`remote_password`	text

Advanced

Setting	ID	Type	Default	Values
Download path
Storage statistics	`action_cmd_storage`	action
Clean up leftover files	`action_cmd_leftovers`	action
Database
Show information	`action_status`	action
Remove movies from Elementum database	`action_cmd_database_clear_movies`	action
Remove shows from Elementum database	`action_cmd_database_clear_shows`	action
Clear deleted movies	`action_cmd_database_clear_deleted_movies`	action
Clear deleted shows	`action_cmd_database_clear_deleted_shows`	action
Clear torrents history	`action_cmd_database_clear_torrent_history`	action
Clear search history	`action_cmd_database_clear_search_history`	action
Clear the database	`action_cmd_database_clear_database`	action
Compact database	`action_cmd_database_compact_database`	action
Cache
Clear TMDB cache	`action_cmd_cache_clear_tmdb`	action
Clear Trakt cache	`action_cmd_cache_clear_trakt`	action
Clear the cache	`action_cmd_cache_clear_cache`	action
Compact cache database	`action_cmd_cache_compact_cache`	action
Logging
Upload /debug/bundle (with kodi.log) to pastebin	`action_cmd_paste_bundle`	action
Upload /debug/all (no kodi.log) to pastebin	`action_cmd_paste_all`	action
Log level	`log_level`	enum	Info	None / Error / Info / Debug
TheMovieDB
API key	`tmdb_api_key`	text