IINA Plugin — MyShows

English | Русский

Automatically marks TV show episodes and movies as watched in MyShows as you watch them in IINA.

Features

• Detects the currently playing episode by sending the filename to the MyShows API
• Falls back to parsing the filename (show name + season/episode numbers) when the direct lookup fails
• Marks the episode as watched once playback reaches a configurable progress threshold (default: 70%)
• Shows an OSD confirmation when an episode is marked as watched

Requirements

• IINA 1.3.0 or later with plugin support enabled
• A MyShows account

Installation

1. Open IINA → Settings → Plugins and click Install from GitHub
2. Paste amiv1/iina-plugin-myshows to the input and click Install
3. It will show what permissions the plugin requests, click Install again
4. MyShows should appear in the list of installed plugins, click on it
5. Open Preferences tab and enter your MyShows credentials
6. If you have video opened, reopen it or restart IINA

Requested permissions

• Network Request: Used to make requests towards authentication proxy (configurable) and MyShows API
• Show OSD: To show when an episode has been marked as watched, if enabled in the preferences

How It Works

1. First, the plugin uses authentication proxy by https://github.com/Igorek1986 to authenticate using provided MyShows credentials, the proxy encapsulates Client ID which is required for authentication to work but can't be exposed publicly
2. When a video file is loaded, the plugin extracts the filename and sends it to the MyShows API (shows.SearchByFile)
3. If the API cannot identify the episode, the plugin parses the filename for a show name and season/episode pattern (e.g. S01E03 or 1x03) and searches via shows.Search + shows.GetById
4. Once an episode is identified, playback progress is polled every 5 seconds during video playback
5. When progress reaches the configured threshold, manage.CheckEpisode is called to mark the episode as watched

sequenceDiagram
    participant IINA
    participant Player as Plugin (player)
    participant Global as Plugin (global)
    participant Proxy as Auth Proxy
    participant API as MyShows API

    IINA->>Player: File loaded
    Player->>Global: Search for episode by filename

    alt Not authenticated yet
        Global->>Proxy: Authenticate with username & password
        Proxy-->>Global: Bearer token
    end

    Global->>API: Look up episode by filename
    API-->>Global: Episode ID or empty

    alt Episode not found by filename
        Global->>Global: Parse show name, season & episode from filename
        Global->>API: Search show by name
        API-->>Global: List of matching shows
        Global->>API: Get full episode list for best match
        API-->>Global: Show with all episodes
        Global->>Global: Match by season & episode number
    end

    alt Episode identified
        Global-->>Player: Episode found
        loop Every N seconds while playing
            Player->>Player: Check playback progress
        end
        Player->>Global: Mark as watched
        Global->>API: Mark episode as watched
        API-->>Global: OK
        Global-->>Player: Marked successfully
        Player->>IINA: Show OSD confirmation
    else Episode not identified
        Global-->>Player: Episode not found, do nothing
    end

Loading

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Write a conventional commit (used for automatic versioning)
npm run commit

Releases

Releases are automated via semantic-release. Commits to main that follow the Conventional Commits format will automatically trigger a version bump, build, plugin packaging, and GitHub release.

Commit type	Version bump
fix:	Patch (1.0.x)
feat:	Minor (1.x.0)
feat!: / BREAKING CHANGE	Major (x.0.0)