-
Notifications
You must be signed in to change notification settings - Fork 1
Migration Guide
Upgrade notes and breaking changes for major EasyTV releases. Check this page when updating to ensure a smooth transition.
Released: 2026-02
Positioned specials support — Some shows (like SpongeBob SquarePants) have specials that are plot-relevant and should be watched between specific episodes. TVDB provides positioning data for these specials, and Kodi stores it in episode metadata. EasyTV can now include these positioned specials in the watch order.
None — This is an opt-in feature with no breaking changes.
To enable positioned specials:
- Go to Settings → Shows → Show Filter
- Enable Include positioned specials in watch order
- Default is Off (existing behavior preserved)
Multi-instance sync users: If you enable this setting, enable it on all devices sharing the same database. Different settings will cause devices to disagree on the next episode.
- Silent service crash during overnight library scans with multi-instance sync is now fixed (v1.4.0-alpha2). If you experienced the service stopping after idle periods, this update resolves it.
- Batch write performance improved significantly for large libraries with sync enabled.
Released: 2026-01
Multi-instance sync — Share watch progress across multiple Kodi devices using a shared MySQL/MariaDB database. See Multi-Instance Sync for full documentation.
None — Sync is disabled by default. Your existing single-device setup continues to work unchanged.
If you have multiple Kodi devices with a shared MySQL/MariaDB video database:
- Go to Settings → Advanced → Multi-Instance Sync
- Enable Multi-instance sync
- Repeat on each device
- See Multi-Instance Sync for detailed setup instructions
- Shared MySQL/MariaDB video database (configured in
advancedsettings.xml) -
script.module.pymysqladdon (bundled with EasyTV) - EasyTV v1.3.0+ on all devices
Released: 2026-01-25
- TVShow smart playlists — Browse your next episodes by show (great for skin widgets)
- Show Premieres / Season Premieres — Two new playlist categories
- Show filter for playlists — Apply your show filter to auto-created playlists
Smart playlist filenames have changed. If you have skin widgets or menu entries pointing to EasyTV playlists, you must update them.
| Old Filename | New Filename |
|---|---|
EasyTV - All Shows.xsp |
EasyTV - Episode - All Shows.xsp |
EasyTV - Continue Watching.xsp |
EasyTV - Episode - Continue Watching.xsp |
EasyTV - Start Fresh.xsp |
EasyTV - Episode - Start Fresh.xsp |
Old playlist files are automatically deleted on upgrade. Settings migrate automatically.
Only if you use EasyTV playlists in skin widgets or PseudoTV Live:
- Open your skin settings or PseudoTV Live configuration
- Find any references to old EasyTV playlist filenames
- Update them to the new filenames (see table above)
- If using TVShow playlists for widgets, configure those separately — they are a new feature
If you don't use auto-created playlists, no action is needed.
Two new Episode and TVShow playlist variants were added:
| Category | Contents |
|---|---|
| Show Premieres | Shows at S01E01 (brand new shows to discover) |
| Season Premieres | Shows at S02E01+ (new seasons of shows you've watched) |
- Download the new version from GitHub Releases
- Install via Settings → Add-ons → Install from zip file
- Restart Kodi (recommended after major version updates)
After updating the main addon, each clone needs updating:
- Launch the clone
- Accept the update prompt
- A progress dialog shows the update steps
- Restart Kodi when prompted
EasyTV maintains settings compatibility within major versions (1.x.x). New settings always have sensible defaults for existing users. You should never lose your configuration during a minor version update.
- Installation — Fresh installation guide
- Multi-Instance Sync — Full sync documentation
- Advanced Features — Clone management, smart playlists
- Settings Reference — All settings explained
EasyTV — No scrolling. No deciding. Just watching.
Home • Installation • Settings • Troubleshooting • GitHub