IINA Plugin — MyShows

English | Русский

Автоматически отмечает просмотренные серии сериалов и фильмы в MyShows во время просмотра в IINA.

Возможности

• Определяет текущую серию, отправляя имя файла в MyShows API
• Если прямой поиск не дал результата, парсит имя файла (название сериала + номер сезона/серии)
• Отмечает серию как просмотренную, когда воспроизведение достигает настраиваемого порога (по умолчанию: 70%)
• Показывает сообщение на экране при отметке серии

Требования

• IINA 1.3.0 или новее с включённой поддержкой плагинов
• Аккаунт на MyShows

Установка

1. Откройте IINA → Настройки → Плагины и нажмите Установить с GitHub
2. Введите amiv1/iina-plugin-myshows и нажмите Установить
3. Плагин покажет запрашиваемые разрешения — нажмите Установить ещё раз
4. MyShows появится в списке установленных плагинов — нажмите на него
5. Откройте вкладку Настройки и введите данные вашего аккаунта MyShows
6. Если видео уже открыто, переоткройте его или перезапустите IINA

Запрашиваемые разрешения

• Сеть: для обращений к MyShows API (аутентификация и управление просмотром)
• Показывать сообщения на экране: для отображения уведомления при отметке эпизода, если включено в настройках

Как это работает

1. Плагин аутентифицируется напрямую в MyShows, отправляя учётные данные на https://myshows.me/api/session и получая bearer-токен.
2. При загрузке видеофайла плагин извлекает имя файла и отправляет его в MyShows API (shows.SearchByFile)
3. Если API не смог найти серию, плагин парсит имя файла в поисках названия сериала и номера сезона/серии (например, S01E03 или 1x03) и выполняет поиск через shows.Search + shows.GetById
4. После определения серии, каждые 5 секунд отслеживается прогресс воспроизведения
5. Когда прогресс достигает заданного порога, вызывается manage.CheckEpisode для отметки эпизода как просмотренного

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

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

    alt Not authenticated yet
        Global->>API: Authenticate with username & password (POST /api/session)
        API-->>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

Разработка

# Установить зависимости
npm install

# Собрать проект
npm run build

# Запустить тесты
npm test

# Создать коммит в формате conventional commits (используется для автоматического версионирования)
npm run commit

Релизы

Релизы автоматизированы через semantic-release. Коммиты в ветке main, соответствующие формату Conventional Commits, автоматически запускают обновление версии, сборку, упаковку плагина и создание GitHub-релиза.

Тип коммита	Тип версии
fix:	Патч (1.0.x)
feat:	Минорная (1.x.0)
feat!: / BREAKING CHANGE	Мажорная (x.0.0)