Архитектура плагина:
Роутер по параметру action: search, search_channels, search_series, search_category, categories, channel, channel_menu, channel_category, channel_playlists, playlist_videos, channel_series, category_browse, feed_tabs, feed_tab, feed_resource, by_id, play, diag.
Ключевые функции:
- http_get_json — повторяет запрос при 429/5xx. HTTP 400 не повторяется.
- fetch_batch — читает страницы по ссылке next из ответа API, пробует запасные URL, дедуплицирует, возвращает continue_page.
- parse_episode_info и group_by_series — парсинг «N серия», «N сезон», «Серия N», «S01E05» из заголовка. Номера серий в API нет.
- get_playlist_index и find_matching_playlists — индекс плейлистов канала, кэш на час в свойстве окна Kodi, нечёткое сопоставление с учётом сезонных плейлистов.
- collect_series_episodes — запасной путь через каталог канала и поиск.
- show_video_list_sorted — серии по возрастанию, фильмы от новых к старым.
- list_feed_resource — разбирает три формы ответа витрины.
- play_video — свойства inputstream.adaptive, настройка quality_mode: 0 = всегда 1080p (fixed-res, по умолчанию), 1 = спросить, 2 = ABR.

Проверенные факты об API RUTUBE:
(неофициальный API, может измениться) - Поиск /api/search/video/ отдаёт максимум 100 результатов без страниц. - /api/video/person/{id}/ отдаёт 40 на страницу, у Фильмача около 6 страниц (≈240 видео) — это лимит Rutube, а не баг. Параметр limit=100 не соблюдается. - /api/playlist/user/{id}/ отдаёт 20 на страницу. - sort=series_d принимается у person, playlist/user и поиска, но у /api/playlist/custom/{id}/videos/ даёт HTTP 400 («invalid value of SortEnum»). Допустимое значение sort для плейлистов не найдено. - Поля видео: id, title, author{id,name}, category{id,name}, publication_ts, created_ts, thumbnail_url, duration, is_paid. - category — всего несколько общих корзин (Сериалы, Фильмы, Разное, Видеоигры, Телепередачи), жанров нет. - В play_options поля episode и season всегда null. Манифест HLS содержит качества до 1080p. - /api/tags/popular/ даёт 404. - Витрина — pangolin/api/web/feed/new_main_page: tabs → resources → абсолютные https-ссылки. Ленты сериалов — /api/metainfo/tv/{id}/video. - Крупные каналы организованы плейлистами. У Фильмача, например, «Все фильмы» — 8658 видео. Основной каталог лежит там, а не в «Все видео». - Эндпоинт поиска каналов /api/v3/search/authors взят из старого плагина и вживую не проверен.
ГРАБЛИ, КОТОРЫЕ УЖЕ ВСТРЕЧАЛИСЬ Zip для Kodi собирать только через Python zipfile: одна корневая папка plugin.video.rutube, без пустых директорий и без записей-папок, затем testzip(). Иначе Kodi пишет «неправильная структура плагина». - Не использовать устаревшее свойство inputstream.adaptive.manifest_type на Kodi 21. Заголовки передавать через inputstream.adaptive.manifest_headers, не через «url|Header=value». - В fetch_batch когда-то была ошибка на единицу в continue_page, из-за которой «Показать ещё» пропускало страницу. Не возвращать её. - Группировка по заголовку — эвристика. Для полноты и порядка серий надёжнее плейлисты.
ИЗВЕСТНЫЕ ОГРАНИЧЕНИЯ И ОТКРЫТЫЕ ВОПРОСЫ - Большие плейлисты показываются порциями по 100. Порядок от новых к старым гарантирован только внутри порции, потому что Rutube отдаёт плейлист в порядке автора. Для сквозной сортировки нужно найти допустимое значение sort — способ: добавить пробу в диагностику. - Возможная настройка «страниц за раз». - Часть контента может быть недоступна из-за региона, платного доступа или возраста — это не баг плагина.
- Признаки смены API: пустые результаты, HTTP 400/404 на ранее рабочих запросах, новые поля в ответах.