Add-on:TV Maze Integration

From Official Kodi Wiki
Revision as of 20:08, 11 April 2024 by Addonbot (talk | contribs) (Addon-Bot repo category update)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

TV Maze Integration

See this add-on on the showcase

Author: pkscout

Type: Program
Repo: repo v21 repo v20 repo v19

License: GPL-3.0-only
Source: Source code
Summary: Integration between Kodi and TV Maze.
Home icon grey.png   ▶ Add-ons ▶ TV Maze Integration
Attention talk.png Need help with this add-on? See here.

This integration allows you to mark shows as acquired on TV Maze (and add them to your followed shows if needed) when you add them to your library and mark them as watched on TV Maze after you watch them. You can also manually follow, unfollow, tag, and untag shows.


This add-on is installed from the Add-on browser located in Kodi as follows:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. Program Add-ons
  5. TV Maze Integration
  6. Install

Addon settings

API Information

TV Maze User:
Your TV Maze user id. Note that this addon requires features of the TV Maze API that require a paid subscription. The lowest tier will work fine.

TV Maze API Key
This can be found on your TV Maze Dashboard.

TV Maze Action

Add new Kodi shows to follow list: (default False)
If set to True, when you scan a TV show into your library, it is added to your followed shows list on TV Maze.

Mark new Kodi episodes as acquired: (default True)
By default when you add a new TV show episode to your library, is is marked as acquired on TV Maze.

Mark watched Kodi episodes as watched: (default True)
By default when you have watched a certain percentage of an episode, it is marked as watched on TV Maze.
Mark watched afer: (default 85%)
The percentage of the show you need to watch for it to be marked as watched on TV Maze.

Mark deleted Kodi episodes as watched: (default True)
By default when you delete an episode from your Kodi library, it is marked as watched on TV Maze.


Enable debug logging: (default False)
When enabled, if you have Kodi logging set the DEBUG you will get a very verbose set of information in your log file. You should only need to activate this when troubleshooting issues.

Using TV Maze Integration

Once you have all your settings configured, TV Maze works in three ways. As a background service, a context menu item, and run from the Program Addons area.

Background Service

TV Maze runs in the background listening for library additions (to add shows to and mark episodes as acquired on TV Maze), library deletions (to mark episodes as watched on TV Maze), and the playing of episodes (to mark them as watched on TV Maze).

Context Menu

You can use the Kodi context menu on TV shows and episodes. For TV shows you can follow, unfollow, tag, and untag a show. For episodes you can mark as episode as acquired, watched, or skipped. You can also unmark an episode.

Run from Program Addons

TV Maze can add one or more of the TV shows in your Kodi library to your follow list on TV Maze, remove shows from your TV Maze follow list, and add/remove tags from your TV Maze TV shows. You can also open the settings from the menu that is presented when you run the addon.

Getting help

If you need assistance using TV Maze Integration, please see the support thread on the Kodi forums.

Beta Testing

If you are interested in beta testing new versions of this add on (or just like being on the bleeding edge of up to date), you can install beta versions (Leia or later, there will be no more updates for earlier versions) from my addon beta repository - either Kodi 18 (Leia) or Kodi 19 (Matrix) and later (these are zip downloads). Please note that for Matrix you need to set Update Official Addons to ANY REPOSITORY in Settings > System > Addons.