Skip to content

Kodi addon for TV show tracking and random playlist generation. Picks random shows, plays next unwatched episode.

License

Notifications You must be signed in to change notification settings

Rouzax/script.easytv

Repository files navigation

EasyTV

No scrolling. No deciding. Just watching.

EasyTV transforms your Kodi library into a personal TV channel. It tracks the next episode for every TV show and lets you dive right in — or creates randomized playlists for lean-back viewing.

Built for Kodi 21+ (Omega and newer).


What is EasyTV?

EasyTV maintains a list of the next episode to watch for every TV show in your library. Not just the first unwatched episode, but the first unwatched episode after the last one you watched.

Two Ways to Watch

Mode Experience
Browse Mode See all your shows with their next episode. Pick what you're in the mood for.
Random Playlist One click starts a shuffled playlist. Sit back and let EasyTV decide.

Key Features

  • Smart Episode Tracking — Always knows your next episode, even with gaps in watch history
  • Mix in Movies — Add movies to your random playlists
  • Smart Playlist Filtering — Use Kodi smart playlists to filter content
  • Duration Filtering — Only shows with episodes under 30 minutes? Done.
  • Random-Order Shows — Shuffle-friendly content like sitcoms and cartoons
  • Partial Prioritization — Unfinished content plays first
  • Clone Support — Multiple EasyTV instances with different configurations

Requirements

  • Kodi 21 (Omega) or Kodi 22 (Piers) or later
  • A TV library with watched/unwatched episodes

⚠️ Not compatible with Kodi 20 or earlier versions.


Installation

  1. Download the latest release from Releases
  2. In Kodi: Settings → Add-ons → Install from zip file
  3. Select the downloaded zip file
  4. Wait for the "Database analysis complete" notification
  5. Launch EasyTV from Add-ons → Program add-ons

📖 Documentation

Full documentation is available on the Wiki:

Page Description
Installation Setup and first run
Browse Mode Episode list guide
Random Playlist Mode Shuffled playlists
Settings Reference All settings explained
Smart Playlist Integration Advanced filtering
Smart Playlist Examples Ready-to-use playlist files
Random-Order Shows Shuffle-friendly content
Advanced Features Clones, exporter, more
Troubleshooting & FAQ Common issues

Quick Links


Credits & License

Original Author

KODeKarnage — Created LazyTV in 2013

Current Maintainer

Rouzax — Modernized for Kodi 21+ (2024-2026)

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0-or-later).

See LICENSE.txt for the full license text.


EasyTV — Because your library should work for you, not the other way around.

About

Kodi addon for TV show tracking and random playlist generation. Picks random shows, plays next unwatched episode.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Languages