Как установить плагины Plex вручную

Кратко

Важное замечание: Plex отключил официальный каталог плагинов в октябре 2018 года, но поддержка сторонних плагинов по-прежнему доступна в клиенте и на сервере.

О чём эта статья

Это подробное руководство объясняет, почему Plex закрыл официальный каталог плагинов, как вручную (sideload) устанавливать плагины, как использовать неофициальный Unsupported App Store, где в интерфейсе Plex найти установленные дополнения, как удалять плагины и как безопасно управлять ими в домашней сети. Включены чек‑листы, пошаговый плейбук, сценарии отказа и краткий словарь терминов.

Почему Plex закрыл каталог плагинов

Plex официально убрал Plugin Directory в октябре 2018 года. В объяснении компании говорится о двух причинах: небольшая доля пользователей (по их оценке — менее 2% базы) и устаревший протокол, который сложно поддерживать в новых клиентах. Plex рекомендовал развивать отдельные утилиты (standalone apps) вместо продолжения работы с плагинами внутри экосистемы.

Тем не менее компания подтвердила, что ручная установка плагинов останется возможной “в обозримом будущем” — то есть функциональность не отключена полностью, просто убран официальный каталог и автоматический репозиторий.

Краткая схема: когда вручную, а когда нет

• Если вам нужно одно‑две специфические функции (скрейперы, TV‑каналы, мета‑плейлисты) — удобнее вручную установить конкретный .bundle.
• Если вы хотите централизованное управление и автоматические обновления — рассмотрите Unsupported App Store (неофициально).
• Если плагин давно не обновлялся и использует устаревший API — он может работать нестабильно или не работать вовсе.

Что такое плагин Plex (одним предложением)

Плагин Plex — это пакет с расширением .bundle, который добавляет источник контента или утилиту в интерфейс Plex Media Server/Player.

Подготовка: что нужно знать заранее

• Вам нужен доступ к компьютеру/диску, на котором работает Plex Media Server. На устройствах, где запущен только Plex Media Player (клиент), нельзя разместить плагины для сервера.
• Плагин должен быть в виде .bundle (чаще всего упакован в ZIP или tar). Вам нужно извлечь .bundle из архива.
• Источники: форум Plex (раздел Plugins), GitHub, Reddit и специализированные репозитории пользовательских плагинов.

Как вручную установить (sideload) плагин в Plex — подробный плейбук

1. Найдите плагин и скачайте архив. Убедитесь, что в нём есть файл или папка с расширением .bundle.
2. Распакуйте архив на своей машине. Оставьте только папку .bundle — остальные файлы, как правило, не нужны.
3. Откройте папку плагинов Plex:
   • На Windows: %LOCALAPPDATA%\Plex Media Server\Plug-ins
   • На macOS: ~/Library/Application Support/Plex Media Server/Plug-ins
   • На Linux: $PLEX_HOME/Library/Application Support/Plex Media Server/Plug-ins
   • Альтернатива: в некоторых сборках можно щёлкнуть правой кнопкой по иконке Plex в трее и выбрать Открыть папку плагинов (Open Plugins Folder).
4. Скопируйте или перетащите распакованную папку .bundle в эту директорию.
5. Перезапустите Plex Media Server (рекомендуется) или дождитесь, пока сервер обнаружит новый плагин автоматически.
6. Откройте Plex Web/десктопную версию и найдите плагин в разделе “Онлайн‑контент” (Online Content) или в панели слева на рабочем столе.

Примечания по правам доступа

• На Linux/UNIX убедитесь, что владелец и права доступа у .bundle совпадают с пользователем Plex (обычно plex, plexmedia или тот, под кем запущен сервис).
• Если Plex не видит плагин — проверьте логи Plex Media Server на предмет ошибок парсинга или проблем с правами.

Как установить Unsupported App Store (альтернатива ручной установке)

Unsupported App Store — неофициальный магазин плагинов, который долгие годы используют пользователи Plex. После закрытия официального каталога он стал одним из главных способов найти и управлять плагинами.

Преимущества Unsupported App Store:

• Централизованное управление плагинами.
• Поддержка автоматических обновлений плагинов (если авторы выпускают их в совместимом формате).
• Каталог популярных пользовательских плагинов.

Ограничения и риски:

• Это неофициальный проект; разработка замедлилась после ухода официального каталога.
• Обновления и безопасность зависят от сообщества и поддержки автора магазина.

Чтобы использовать Unsupported App Store, сначала его нужно загружать и поместить как обычный .bundle в папку Plug-ins (см. плейбук выше). После установки магазин управляет списком доступных плагинов и обновлений.

Примечание: Unsupported App Store не разрабатывается официально Plex и может содержать плагины с разной степенью поддержки.

Как пользоваться установленными плагинами в Plex

• На десктопе/в веб‑интерфейсе установленные плагины обычно отображаются в левой панели или в разделе “Онлайн‑контент”.
• На мобильных устройствах, Smart TV или стриминговых приставках расположение может отличаться: ищите раздел с внешним/онлайн контентом.
• Чтобы открыть плагин — нажмите на его плитку; управление контентом (поиск, плейлисты) работает как у любого источника в Plex.

Что работает, а что может не работать

• Плагины, которые получают контент с сайтов, требующих аутентификацию или изменённых API, могут перестать работать при изменении сайта.
• Старые плагины, использующие устаревшие протоколы клиента, могут некорректно отображать контент или вовсе не запускаться.

Как удалить установленный вручную плагин

1. Откройте папку Plug-ins на том же сервере, куда вы помещали .bundle.
2. Найдите папку с именем плагина и удалите её стандартным способом (правой кнопкой — Удалить, Delete или переместить в корзину).
3. Перезапустите Plex Media Server, чтобы приложение пересканировало список плагинов.

Важно: удалить плагин из интерфейса Plex нельзя; нужно удалять сам .bundle в файловой системе.

Чек‑листы по ролям

Администратор домашнего сервера

• Имеет доступ к серверной машине и правам на папку Plug-ins.
• Делает резервную копию текущей папки Plug-ins перед массовыми изменениями.
• Проверяет права и владельца у .bundle после копирования.
• Перезапускает Plex Media Server после установки/удаления.

Обычный пользователь / домохозяйство

• Просит администратора установить плагин.
• Проверяет работоспособность из клиентского приложения.
• Сообщает об ошибках и логах админу, если плагин не запускается.

Power user / тестировщик

• Тестирует новый плагин в отдельной среде (отдельная папка сервера) прежде чем развернуть.
• Ведёт заметки о версиях и совместимости с текущей версией Plex.

Сценарии отказа и способы их устранения

1. Плагин не отображается:
   • Проверьте, действительно ли это папка .bundle, а не zip-файл.
   • Проверьте права доступа и владельца.
   • Перезапустите Plex Media Server и очистите кэш браузера.
2. Плагин запускается, но не возвращает контент:
   • Проверьте, не изменился ли внешний API ресурса, с которого берётся контент.
   • Попробуйте найти форк плагина на GitHub, где исправлены новые условия сайта.
3. Plex ругается на синтаксис или структуру плагина:
   • Изучите логи Plex (Plex Media Server Logs) — там обычно есть подсказки.

Матрица рисков и рекомендации по смягчению

Когда ручная установка не решит задачу (контрпримеры)

• Если вам нужен полностью интегрированный сервис с автоматическими обновлениями и поддержкой со стороны Plex — плагины не лучшая опция.
• Если плагин зависит от стороннего сайта, который закрыл доступ по API или требует браузерного рендеринга — плагин может перестать работать.
• Если вы используете аппаратный медиасервер с сильно урезанным доступом к файловой системе (некоторые NAS/коробочные решения), ручная установка может быть недоступна.

Топ‑альтернативы и подходы

• Unsupported App Store — для централизованного управления и обновлений.
• Отдельные standalone‑приложения (например, Tautulli для статистики) — работают вне Plex и часто безопаснее.
• Использование внешних медиасерверов/агрегаторов и интеграция их в Plex через URL/DLNA, если плагин не поддерживается.

Критерии приёмки (как понять, что установка успешна)

• Плагин отображается в интерфейсе Plex в разделе Онлайн‑контент или в левой панели.
• При открытии плагина виден список контента или интерфейс плагина без ошибок.
• Контент воспроизводится и метаданные корректно отображаются.

Короткий чек лист тестирования

• Установить .bundle в папку Plug-ins.
• Перезапустить сервер.
• Открыть плагин в веб‑интерфейсе и проверить списки контента.
• Воспроизвести 2–3 элемента контента.
• Проверить логи на наличие предупреждений/ошибок.

Краткий словарь (1‑строчные определения)

• .bundle — формат папки/пакета плагина Plex.
• Sideload — ручная установка пакета в систему без официального магазина.
• Unsupported App Store — неофициальный менеджер плагинов для Plex.
• Plug-ins (папка) — директория Plex Media Server, где хранятся плагины.

Безопасность и приватность

• Остерегайтесь плагинов из неизвестных источников — в них может быть вредоносный код.
• Не храните в плагинах пароли или чувствительную информацию в открытом виде.
• В корпоративных или публичных сетях рассматривайте изоляцию медиасервера за VLAN или дополнительным файерволом.

Примеры конфликтов и как их решать

• Конфликт версий: при установке нескольких версий одного плагина удалите старую версию перед копированием новой.
• Проблемы с зависимостями Python (если плагин использует встроенный интерпретатор): изучите README на странице проекта и установите отсутствующие библиотеки в среду, где запускается Plex (только при понимании рисков).

Диагностическая таблица и шаги восстановления

1. Плагин пропал — проверьте корзину, права, логи.
2. Контент не грузится — проверьте, доступен ли исходный ресурс в браузере сервера.
3. Сервер падает при загрузке плагина — временно переместите .bundle в другую папку и перезапустите Plex.

Decision flow (помогает выбрать стратегию установки)

flowchart TD
  A[Нужен плагин] --> B{Есть он в Unsupported App Store?}
  B -- Да --> C[Установить через Unsupported App Store]
  B -- Нет --> D{Доступен .bundle на GitHub/форуме?}
  D -- Да --> E[Скачать, распаковать, поместить в Plug-ins]
  D -- Нет --> F[Рассмотреть альтернативу: standalone app или другой источник]
  C --> G[Проверить работу и обновления]
  E --> G
  F --> H[Оценить расходы/возможности замены]

Куда смотреть дальше — дополнительные ресурсы

• Форум Plex, раздел Plugins — основной источник пользовательских сборок.
• GitHub — форки и исправления популярных плагинов.
• Reddit (r/PleX) — обсуждения работоспособности и фичей.

Социальный анонс (100–200 слов)

Короткое объявление: Plex отключил официальный каталог плагинов, но вы по‑прежнему можете устанавливать пользовательские плагины вручную. Это руководство объясняет, как найти .bundle, куда его поместить и как использовать неофициальный Unsupported App Store для удобного управления и обновлений. Включены чек‑листы, сценарии отказа и рекомендации по безопасности. Подходит как для обычных пользователей, так и для домашних администраторов.

Краткое резюме

• Официальный каталог плагинов Plex закрыт, но ручная установка работает.
• Плагин — это .bundle: распакуйте и поместите в папку Plug-ins на сервере.
• Unsupported App Store упрощает управление и обновления, но он неофициальен.
• Всегда делайте резервные копии и проверяйте права доступа; осторожно относитесь к источникам плагинов.

Если нужно, могу подготовить компактную чек‑форму для печати (PDF) с шагами установки и проверками для вашей домашней сети.