Skip to content

Advanced Features

EasyMovie includes several features for power users: clone instances, movie pool filtering, smart re-suggestion, and debug logging.

Clone Feature

Create multiple EasyMovie instances with completely independent settings. Each clone is a separate addon that shares the core code but maintains its own configuration.

Why Clone?

Use Case Main EasyMovie Clone
Different genres All movies Only action movies
Different audiences Adult content Kids-only content
Different modes Browse mode Playlist mode
Different rooms Living room setup Bedroom setup

Creating a Clone

  1. Go to Settings > Advanced > Tools
  2. Click Create EasyMovie copy...
  3. Confirm the creation dialog
  4. Enter a name for the clone (e.g., "Kids Movies", "Action Night")
  5. A progress dialog shows the creation steps
  6. Restart Kodi when prompted

What Gets Created

A new addon appears in Add-ons > Program add-ons: - Named "EasyMovie - [Your Name]" (e.g., "EasyMovie - Kids Movies") - Completely separate settings - Can be added to your home screen independently

Clone Settings

Each clone has its own: - Launch behavior (Browse vs Playlist vs Ask) - All filter presets and modes - Movie set settings - View style and theme - Playback settings - Movie pool and re-suggestion settings

Custom Icons for Clones

Each clone can have its own custom icon:

  1. Open the clone's settings
  2. Go to EasyMovie > Appearance
  3. Click Set custom icon
  4. Choose an image file

This makes it easy to identify different clones at a glance.

Updating Clones

When you update EasyMovie (install a new version), clones need to be updated too:

  1. Launch a clone after updating the main addon
  2. EasyMovie detects the version mismatch
  3. A dialog appears: "A new version of EasyMovie is available"
  4. Click Update to proceed
  5. Restart Kodi when prompted

The update preserves all clone settings and only updates the code files.

Removing a Clone

  1. Go to Settings > Add-ons > My add-ons > Program add-ons
  2. Find the clone (e.g., "EasyMovie - Kids Movies")
  3. Click Uninstall

This removes only the clone, not the main EasyMovie addon.

Movie Pool

Limit the movies EasyMovie draws from to a Kodi smart playlist. This lets you create themed movie nights, family-friendly pools, or seasonal collections.

Setting Up a Movie Pool

  1. Create a smart playlist in Kodi (.xsp file with type="movies")
  2. Go to Settings > Advanced > Movie Pool
  3. Enable Limit to smart playlist
  4. Click Select playlist...
  5. Choose your .xsp file

Use Cases

Movie Pool Smart Playlist Rule
Family night Rating is "G" or "PG"
Holiday movies Genre is "Holiday"
Sci-fi collection Genre is "Science Fiction"
High-quality only Rating > 7.0
Recent additions Date added in the last 30 days

The wizard filters stack on top of the movie pool. So if your pool is "Family movies" and you filter by "Comedy" in the wizard, you get family comedies.

Smart Re-suggestion

EasyMovie tracks which movies it has recently suggested to avoid showing the same titles repeatedly.

How It Works

When a movie appears in your results, EasyMovie records the timestamp. That movie won't appear again until the re-suggestion window expires.

Setting Description
Avoid re-suggesting recent movies Enable/disable the feature
Re-suggestion window How long to wait: 4, 8, 12, 24, 48, or 72 hours

Default: Enabled with a 24-hour window.

Tips

  • Re-roll multiple times and the system prevents repeats
  • Works across sessions — close and reopen EasyMovie and it still remembers
  • If your library is small, a shorter window prevents running out of movies
  • Disable entirely if you don't mind seeing repeat suggestions

Debug Logging

For troubleshooting issues, EasyMovie can write detailed logs to a separate file (not Kodi's main log).

Enabling Debug Logging

  1. Go to Settings > Advanced > Debugging
  2. Enable Enable debug logging

Log Location

Platform Path
Windows %APPDATA%\Kodi\userdata\addon_data\script.easymovie\logs\easymovie.log
Linux ~/.kodi/userdata/addon_data/script.easymovie/logs/easymovie.log
macOS ~/Library/Application Support/Kodi/userdata/addon_data/script.easymovie/logs/easymovie.log
LibreELEC /storage/.kodi/userdata/addon_data/script.easymovie/logs/easymovie.log
OSMC /home/osmc/.kodi/userdata/addon_data/script.easymovie/logs/easymovie.log

What Gets Logged

Level Content Always Logged
ERROR Operation failures, exceptions Yes (Kodi + EasyMovie log)
WARNING Recoverable issues Yes (Kodi + EasyMovie log)
INFO Lifecycle events (start, stop) Yes (Kodi + EasyMovie log)
DEBUG Detailed diagnostics Only when debug enabled (EasyMovie log only)

Log Format

2026-03-24 20:15:30.123 [EasyMovie.ui] INFO: Addon launched, version=1.0.0
2026-03-24 20:15:31.456 [EasyMovie.data] DEBUG: Fetching movies, total=247
2026-03-24 20:15:32.789 [EasyMovie.data] DEBUG: Filtered to 42 movies

Keyboard Shortcuts

Key Context Action
Enter Browse Mode Play selected movie
C / Menu Browse Mode Context menu
T / Blue button Browse Mode Cycle theme preview
Backspace / Esc Browse Mode Close EasyMovie
Arrow keys Browse Mode Navigate results