Settings Reference

Settings Reference

Complete reference for all EasyTV settings. Open settings via Add-ons → EasyTV → Configure (or highlight EasyTV and press C).

Note: Some settings only appear when relevant. For example, movie settings are hidden when "Playlist content" is set to "TV episodes only".

---

Settings Categories

EasyTV organizes settings into six categories:

Category	Purpose
EasyTV	Launch behavior
Shows	Which shows and episodes to include
Browse Mode	Episode list appearance and behavior
Random Playlist	Shuffled playlist configuration
Playback	What happens during/after watching
Advanced	Technical settings and tools

---

EasyTV (Main)

The fundamental choice: what happens when you launch EasyTV.

On Launch

Setting	Options	Default	Description
When I open EasyTV	Show episode list / Play random playlist / Ask me	Ask me	Choose what happens when you launch EasyTV

Options explained:

Option	Behavior
Show episode list	Opens Browse Mode immediately
Play random playlist	Starts playing a Random Playlist immediately
Ask me	Shows a dialog: "Show me" (browse) or "Surprise me" (random)

Appearance

Setting	Options	Default	Description
Theme	Golden Hour / Ultraviolet / Ember / Nightfall	Golden Hour	Accent color theme for all EasyTV windows and dialogs
Set custom icon	(button)	—	Choose an icon image for EasyTV. Replaces the addon icon in Kodi menus and notifications
Reset to default icon	(button)	—	Restore the original EasyTV icon

Themes:

Theme	Accent
Golden Hour	Warm orange/golden tones (default)
Ultraviolet	Purple tones
Ember	Red tones
Nightfall	Blue tones

Custom icons: Changes may require a Kodi restart to appear everywhere. Each clone can have its own icon.

---

Shows

Control which TV shows and episodes EasyTV uses. These settings apply to both Browse Mode and Random Playlist.

Show Filter

Setting	Options	Default	Description
Use only selected shows	On / Off	Off	Limit EasyTV to specific shows instead of entire library
Selection method	Pick shows manually / Use a smart playlist	Pick shows manually	How to choose which shows to include
Select shows...	(button)	—	Opens dialog to manually pick shows
Smart playlist	Ask each time / Use default	Ask each time	Whether to prompt for playlist or use a saved one
Choose playlist file...	(button)	—	Select a Kodi smart playlist (.xsp) file

Visibility rules:

• "Selection method" only appears when "Use only selected shows" is On
• "Select shows..." only appears when method is "Pick shows manually"
• "Smart playlist" and "Choose playlist file..." only appear when method is "Use a smart playlist"

Episode Duration

Setting	Options	Default	Description
Enable duration filter	On / Off	Off	Filter shows by typical episode length
Minimum episode length	0-120 minutes (slider)	0	Only include shows with episodes at least this long
Maximum episode length	0-120 minutes (slider)	0	Only include shows with episodes no longer than this

How duration is calculated:

• EasyTV samples episodes from each show
• Calculates the median duration (robust to outliers like double-length finales)
• Uses stream metadata from video files
• Shows without duration data are excluded when filter is active

Setting values:

• 0 = No limit (disabled)
• Both at 0 = Filter disabled (all shows included)

⚠️ If minimum > maximum, EasyTV shows a warning and disables the filter.

Random Episode Order

Setting	Options	Default	Description
Select shows for random order...	(button)	—	Choose shows that don't require sequential viewing

Opens a selection dialog. Shows marked here will:

• Pick any random unwatched episode instead of the "next" one
• Work differently in "Both" episode selection mode

See Random-Order Shows for full details.

Episode Options

Setting	Options	Default	Description
Series premieres	Skip / Mix in / Only	Mix in	Controls whether S01E01 episodes from unstarted shows appear
Season premieres	Skip / Mix in / Only	Mix in	Controls whether SxxE01 episodes (first episode of each season) appear
Include positioned specials in watch order	On / Off	Off	Insert TVDB-positioned specials at their designated place in the episode sequence

Series premieres — controls S01E01 from shows you haven't started:

• Skip: Only shows you've already begun watching appear.
• Mix in: Series premieres appear alongside regular episodes (default).
• Only: Restricts the list to premiere episodes only — useful for discovering new shows to start.

Season premieres — controls SxxE01 episodes (new seasons):

• Skip: Shows only appear when you're mid-season. Useful if you prefer to continue from where you left off.
• Mix in: Season premieres appear alongside regular episodes (default).
• Only: Restricts the list to premiere episodes only.

When either setting is Only, the entire list becomes premieres-only. The other setting then controls which premiere types appear:

Series premieres	Season premieres	Result
Mix in	Mix in	All episodes (default)
Skip	Mix in	No S01E01 — only shows already started
Mix in	Skip	No season premieres — only mid-season shows
Skip	Skip	Only mid-season episodes
Only	Mix in	Premieres only: both S01E01 and season premieres
Only	Skip	Premieres only: S01E01 only (no season premieres)
Mix in	Only	Premieres only: both S01E01 and season premieres
Skip	Only	Premieres only: season premieres only (no S01E01)
Only	Only	Premieres only: both types

Positioned specials: Some shows have specials that TVDB marks as belonging between specific episodes (e.g., a special that should be watched between S10E55 and S10E56). When enabled, these specials appear at their designated position in the watch order. Specials without TVDB positioning data remain excluded. (Added in v1.4.0)

Multi-instance sync users: Configure this setting identically on all devices. Different values will cause devices to disagree on the next episode. See Multi-Instance Sync.

---

Browse Mode

Settings for "Show episode list" mode. These apply when browsing your next episodes.

Appearance

Setting	Options	Default	Description
View style	Card List / Posters / Big Screen / Split View	Card List	Visual layout for the episode list
Return to EasyTV after playback	On / Off	On	Come back to episode list after watching
Hide random-order shows	On / Off	Off	Don't show random-order shows in the list

View styles:

Style	Description
Card List	Data-dense rows with poster, show/episode info, and stats
Posters	Visual grid with show artwork and episode details
Big Screen	Large artwork optimized for 10-foot viewing
Split View	Two-column layout: show list on the left, detail panel on the right

Sorting

Setting	Options	Default	Description
Sort by	Show Name / Last Watched / # Unwatched Episodes / # Watched Episodes / Season	Last Watched	How to order shows in the list
Reverse sort order	On / Off	Off	Flip the sort direction

Sort methods:

Method	Default Order	Reversed
Show Name	A → Z	Z → A
Last Watched	Most recent first	Oldest first
# Unwatched	Most unwatched first	Fewest first
# Watched	Most watched first	Fewest first
Season	Highest season first	Lowest first

Performance

Setting	Options	Default	Description
Limit shows displayed	On / Off	Off	Cap the number of shows in the list
Maximum shows	1-30 (slider)	10	How many shows when limited

Enable these on low-power devices (Raspberry Pi, older Fire TV) for better responsiveness.

---

Random Playlist

Settings for "Play random playlist" mode. These apply when creating shuffled playlists.

Basics

Setting	Options	Default	Description
Playlist content	TV episodes only / TV and movies / Movies only	TV episodes only	What to include in the playlist
Playlist length	1-50 (slider)	5	Number of items in the playlist
Allow multiple episodes of same TV Show	On / Off	Off	Let the same show appear multiple times

Visibility: "Allow multiple episodes" is hidden when content is "Movies only".

Content Options

Settings that depend on your Playlist content selection:

TV Episode Settings

Visible when TV episodes are included

Setting	Options	Default	Description
Episode selection	Unwatched only / Watched only / Both	Unwatched only	Which episodes to include
Unwatched episode chance	0-100% (slider)	50%	In "Both" mode, how often to pick unwatched
Start playlist with unfinished episodes	On / Off	On	Prioritize partially watched episodes
Seek to resume point for episodes	Auto-skip to where you left off in partial episodes (seeks 10 seconds before)	On	TV episodes included

Movie Settings

Visible when movies are included

Setting	Options	Default	Description
Movie selection	Unwatched only / Watched only / Both	Unwatched only	Which movies to include
Start playlist with unfinished movies	On / Off	On	Prioritize partially watched movies
Seek to resume point for movies	Auto-skip to where you left off in partial movies (seeks 10 seconds before)	On	Movies included
Start watched movies at random point	On / Off	Off	Start 5-75% through watched movies
Filter movies by playlist...	(button)	All movies	Limit movies using a smart playlist

Mixed Content Settings

Visible when "TV and movies" is selected

Setting	Options	Default	Description
Movie chance	0-100% (slider, step 5)	25%	How much of the playlist should be movies

Movie chance values:

• 0% = No movies (TV only)
• 25% = About a quarter movies (default)
• 50% = Equal mix of movies and TV
• 100% = All movies

Notifications

Setting	Options	Default	Description
Show info when playing	On / Off	On	Display notification when each item starts

Playlist Continuation

Setting	Options	Default	Description
Prompt to continue playlist	On / Off	Off	Ask to generate another playlist when finished
Countdown duration	0-60 seconds (slider)	20	Seconds before prompt auto-dismisses

Countdown values:

• 0 = Wait indefinitely (no auto-dismiss)
• 1-60 = Auto-dismiss after this many seconds

Default action when countdown expires: Stop (don't generate).

---

Playback

These settings work for all TV shows in Kodi, not just EasyTV playback.

Next Episode Prompt

Setting	Options	Default	Description
Ask to watch next episode	On / Off	Off	Show prompt after an episode ends
Prompt timeout (seconds)	0-60 (slider)	5	How long the prompt stays on screen
If prompt times out	Don't play / Play next episode	Don't play	Default action when timeout expires
Also prompt during random playlists	On / Off	Off	Show prompt even during EasyTV playlists

Timeout values:

• 0-59 = Auto-act after this many seconds
• 60 = Wait indefinitely

Warnings

Setting	Options	Default	Description
Warn about earlier unwatched episodes	On / Off	On	Alert if skipping an unwatched episode

When enabled, if you're about to play S02E05 but S02E03 is unwatched, EasyTV asks if you want to watch the earlier episode instead.

---

Advanced

Technical settings and utilities.

Background Service

Setting	Options	Default	Description
Show notification when ready	On / Off	On	Notify when library scan completes on startup
Export Episode smart playlists	On / Off	Off	Create Episode-type playlists for channel surfing
Export TVShow smart playlists	On / Off	Off	Create TVShow-type playlists for skin widgets
Apply show filter to smart playlists	On / Off	Off	Only include shows matching your show filter

Episode playlists point to specific episode files and are ordered randomly — ideal for channel surfing or PseudoTV Live.

TVShow playlists point to shows (not episodes) and are ordered alphabetically — ideal for skin widgets that browse by show artwork.

Apply show filter: When enabled, the auto-created playlists respect your TV show filter (Settings → Shows). This only works on the main addon, not clones.

When enabled, EasyTV maintains ten .xsp files (five Episode, five TVShow):

• All Shows
• Continue Watching
• Start Fresh
• Show Premieres (S01E01 — brand new shows)
• Season Premieres (S02E01+ — new seasons)

See Advanced Features for details.

Multi-Instance Sync

Setting	Options	Default	Description
Multi-instance sync	On / Off	Off	Share watch progress across multiple Kodi devices via shared MySQL/MariaDB
Clear sync data	(button)	—	Delete all shared sync data and reset revision counter

Visibility: "Clear sync data" only appears when "Multi-instance sync" is On.

Requirements: A shared MySQL/MariaDB video database (configured in advancedsettings.xml) and the script.module.pymysql addon.

See Multi-Instance Sync for full setup and usage documentation. (Added in v1.3.0)

Debugging

Setting	Options	Default	Description
Enable debug logging	On / Off	Off	Write detailed diagnostics to a separate log file

Log location: special://profile/addon_data/script.easytv/logs/easytv.log

See Troubleshooting for log file paths.

Tools

Setting	Options	Default	Description
Create EasyTV copy...	(button)	—	Create a clone with separate settings
Export episodes to folder...	(button)	—	Copy next episodes for offline viewing

See Advanced Features for details on these tools.

---

Settings Dependencies Summary

Some settings only appear based on other settings:

Setting	Appears When
Selection method options	"Use only selected shows" is On
Episode selection, TV partial settings	Playlist content includes TV
Movie selection, movie partial settings	Playlist content includes movies
Movie chance	Playlist content is "TV and movies"
Unwatched episode chance	Episode selection is "Both"
Start watched movies at random point	Movie selection includes watched
Allow multiple episodes	Playlist content is not "Movies only"
Countdown duration	"Prompt to continue playlist" is On
Prompt timeout, default action	"Ask to watch next episode" is On
Maximum shows	"Limit shows displayed" is On
Duration min/max	"Enable duration filter" is On
Apply show filter to smart playlists	Episode or TVShow playlists enabled
Clear sync data	"Multi-instance sync" is On

---

Related Pages

• Browse Mode — How browse settings work in practice
• Random Playlist Mode — How playlist settings work in practice
• Smart Playlist Integration — Using smart playlists for filtering
• Advanced Features — Clone and exporter details
• Troubleshooting — Debug logging explained