Cliparr: создание клипов из медиа на твоем сервере
Cliparr — это инструмент для создания клипов из медиа на твоем личном медиа-сервере, поддерживающий Plex и Jellyfin. Он позволяет быстро обрезать и загружать видеофрагменты, которые сейчас воспроизводятся, или работать с локальными файлами.
Проект ориентирован на пользователей, которые хотят просто и без лишних хлопот получить короткие видео из своих медиа коллекций. В отличие от более громоздких решений, Cliparr предлагает интуитивно понятный интерфейс редактирования с функцией автоматического обнаружения воспроизведения. Никаких дополнительных обновлений страницы — всё под рукой. Ты можешь открывать видеофайлы на своем компьютере и сразу же работать с ними, не дожидаясь загрузки на сервер.
Сборка написана на JavaScript и запускается непосредственно в браузере, что делает его доступным для большинства платформ. Cliparr использует браузерное транскодирование для экспорта видео и поддерживает вставку субтитров. Будь внимателен: проект находится на ранней стадии разработки и требует твоего внимания к возможным багам. Индивидуальный опыт может варьироваться в зависимости от конфигурации твоего медиа-сервера.
Cliparr — это инструмент для быстрого создания и загрузки клипов из медиа, которые сейчас воспроизводятся на твоем сервере Plex или Jellyfin, а также из локальных видеофайлов, открываемых прямо в браузере. Он позволяет удобно вырезать отрывки и работать с ними в режиме реального времени.
Среди ключевых особенностей Cliparr:
- Автоматическое обнаружение сессий: обновления о воспроизведении из Plex и Jellyfin происходят в реальном времени без необходимости вручную обновлять страницу.
- Поддержка локальных видео: ты можешь открыть локальный файл или прямую ссылку на медиа перед или после подключения к серверу.
- Интуитивно понятный редактор таймлайна: просто перетаскивай медиа-блок и обрезай клип, регулируй время появления субтитров.
- Браузерное транскодирование: экспорт видеоклипов поддерживает настройки, предлагаемые Mediabunny, с возможностью создания GIF-файлов.
- Поддержка метаданных: в экспортируемые видео могут включаться информация о сезоне, эпизоде и времени из исходного материала.
- Встраивание субтитров: возможно встраивание поддерживаемых субтитров с настроенным стилем и локальным шрифтом.
Установка и запуск
Самый быстрый способ запустить Cliparr — это использование Docker. Вот команды для установки:
docker run -d \
--name cliparr \
-p 7171:7171 \
-e APP_KEY="your-32-char-stable-random-secret" \
-v cliparr-data:/data \
ghcr.io/techsquidtv/cliparr:latest
Для PowerShell команда будет выглядеть так:
docker run -d `
--name cliparr `
-p 7171:7171 `
-e APP_KEY="your-32-char-stable-random-secret" `
-v cliparr-data:/data `
ghcr.io/techsquidtv/cliparr:latest
Ты можешь использовать Docker Compose для постоянной настройки. Пример конфигурации:
services:
cliparr:
image: ghcr.io/techsquidtv/cliparr:latest
container_name: cliparr
ports:
- "7171:7171"
environment:
- APP_KEY=replace-this-with-a-32-character-secure-random-string
volumes:
- cliparr-data:/data
restart: unless-stopped
volumes:
cliparr-data:
Ограничения и важные моменты
Для работы Cliparr требуется надежный APP_KEY длиной не менее 32 символов для шифрования учетных данных. Если ты изменишь его, придется заново аутентифицироваться на медиа-серверах.
Также важно использовать HTTPS для редактирования, так как браузеры требуют защищенный контекст для работы с WebCodecs.
Обратите внимание: если используешь Jellyfin, для неадминистраторских аккаунтов необходима версия Jellyfin 10.11 или выше для поддержки живых сессий. На более старых версиях тебе нужно обновить Jellyfin или подключить аккаунт администратора.
Разработка и участие
Если ты хочешь внести свой вклад в проект, его можно клонировать с GitHub и настроить локальную среду:
git clone https://github.com/techsquidtv/cliparr.git
cp .env.example .env
pnpm install
pnpm dev
Подробные рекомендации по участию доступны в файле CONTRIBUTING.md в репозитории.
Cliparr распространяется под лицензией MIT.
Радар проекта: 70 из 100 — крепкий проект
- Импульс 14 ≈ 1 звезда в день
- Темп разработки 89 160 коммитов за 12 недель
- Зрелость 79 проекту 7 месяцев, 33 релиза
- Сообщество 33 8 участников, 7 форков
- Свежесть 98 последний коммит — 4 дня назад
- Быстрый старт 65 есть: команда установки, сайт/демо
- Готовность к продакшену 80 релиз v3.1.2, автосборка
- Безопасность и доверие 100 лицензия MIT, SECURITY.md, организация
- Документация 98 README 10.1 тыс. знаков, 10 разделов
- Экосистема 44 2 подписчика на обновления, 7 тем
Как считаем
Только открытые данные GitHub на 14.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: TechSquidTV/Cliparr →
RepoRadar