Skip to content

Rouzax/script.easymovie

Repository files navigation

EasyMovie

Simplify movie night.

EasyMovie helps you pick movies for movie night. Answer a few questions (genre, rating, runtime) and get a curated random selection from your library. Supports movie set awareness, multiple viewing modes, and playlist generation.

EasyMovie Showcase View

Built for Kodi 21+ (Omega and newer).


What is EasyMovie?

EasyMovie presents a quick wizard to filter your movie library, then shows you a curated selection of random movies that match your mood. No more scrolling through hundreds of titles trying to decide what to watch.

Two Ways to Watch

Mode Experience
Browse Mode See your curated selection in a visual grid. Pick what catches your eye.
Playlist Mode One click starts a movie marathon. Sit back and enjoy.

Key Features

  • Filter Wizard — Quick questions for genre, rating, runtime, year, and more
  • 5 Viewing Modes — Showcase (default), Card List, Posters, Big Screen, Split View
  • Movie Set Awareness — Automatically suggests the next unwatched movie in a collection
  • Set Continuation — After finishing a set movie, get prompted to watch the next one
  • Playlist Mode — Build and play movie marathons automatically
  • 4 Color Themes — Golden Hour, Ultraviolet, Ember, Nightfall
  • Re-roll — Don't like the selection? Get a fresh set of suggestions
  • Surprise Me — Pick a random movie from the results
  • Smart Re-suggestion — Avoids suggesting the same movies too frequently
  • Clone Support — Multiple EasyMovie instances with different filter presets

Requirements

  • Kodi 21 (Omega) or Kodi 22 (Piers) or later
  • A movie library

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. Launch EasyMovie from Add-ons → Program add-ons

Documentation

Full documentation is available on the Wiki:

Page Description
Installation Setup and first run
Filter Wizard The filter flow explained
Browse Mode View styles and browsing guide
Playlist Mode Movie marathon playlists
Movie Sets Collection awareness and continuation
Settings Reference All settings explained
Advanced Features Clones, debugging, more
Troubleshooting & FAQ Common issues

Quick Links


Credits & License

Author

Rouzax — Created for Kodi 21+ (2026)

License

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

See LICENSE.txt for the full license text.


EasyMovie — Because choosing what to watch shouldn't take longer than watching it.

About

Kodi addon that simplifies movie night. Filter wizard narrows your library by genre, rating, runtime — then presents a curated random selection.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages