ComfyUI MoviePy Adapter (MPA)

MoviePy Adapter - это набор кастомных нод для ComfyUI, которые интегрируют функциональность библиотеки MoviePy для профессиональной работы с видео.

Возможности

🎬 Объединение видео

• MPA Combine Videos - объединяйте до 10 видео в одно последовательное видео
• Автоматическое масштабирование до разрешения первого видео
• Настраиваемая частота кадров (FPS)

✨ Переходы между видео

• MPA Video Transition - создавайте профессиональные переходы:
  • crossfade - плавное затухание и появление
  • fadein - появление из чёрного
  • fadeout - затухание в чёрный
  • fadeinout - комбинированный переход
• Настраиваемая длительность перехода

🎨 Видеоэффекты

MPA Brightness Effect

Изменение яркости видео с точностью до 0.01

MPA Contrast Effect

Регулировка контраста для улучшения визуального восприятия

MPA Speed Effect

Изменение скорости воспроизведения:

• Ускорение (factor > 1.0)
• Замедление/Slow Motion (factor < 1.0)
• Диапазон: от 0.1x до 10x

Установка

Метод 1: Через pip (рекомендуется)

cd ComfyUI/custom_nodes/ComfyUI_MovisAdapter
pip install -e .

Метод 2: Ручная установка зависимостей

pip install moviepy>=1.0.3 numpy>=1.20.0 torch>=1.13.0

Быстрый старт

1. Установите зависимости (см. выше)
2. Перезапустите ComfyUI
3. В меню нод найдите категорию MPA/video
4. Добавьте нужные ноды на рабочее пространство

Архитектура

src/ComfyUI_MovisAdapter/
├── common.py          # Общие функции конвертации IMAGE ↔ MoviePy
├── nodes.py           # Регистрация всех нод
└── node_types/
    ├── CombineVideos/
    ├── VideoTransition/
    ├── BrightnessEffect/
    ├── ContrastEffect/
    └── SpeedEffect/

Примеры использования

Создание видео с переходами

[Видео 1] → [MPA Video Transition] → [Видео 2] → [MPA Video Transition] → [Видео 3]
                  ↓ (crossfade)                        ↓ (fadeinout)
                           [MPA Combine Videos] → [Результат]

Slow Motion с эффектами

[Видео] → [MPA Speed Effect (0.5x)] → [MPA Brightness Effect (1.2)] → [Результат]

Монтаж нескольких клипов

[Клип 1] ──┐
[Клип 2] ──┤
[Клип 3] ──┼─→ [MPA Combine Videos] → [Результат]
[Клип 4] ──┤
[Клип 5] ──┘

Технические детали

Формат данных

• Вход: ComfyUI IMAGE тензор [B, H, W, C]
• Выход: ComfyUI IMAGE тензор [B, H, W, C]
• Значения: автоматическая конвертация между [0, 1] (ComfyUI) и [0, 255] (MoviePy)

FPS (Frames Per Second)

• По умолчанию: 24 fps
• Настраивается для каждой ноды индивидуально
• Диапазон: 1-120 fps

Документация

Подробная документация по реализации доступна в файле IMPLEMENTATION.md.

Требования

• Python >= 3.10
• ComfyUI (установленный)
• moviepy >= 1.0.3
• numpy >= 1.20.0
• torch >= 1.13.0

Roadmap / Будущие улучшения

• Дополнительные эффекты: blur, rotate, scale
• Поддержка аудиодорожек
• Оптимизация производительности для 4K видео
• Кэширование промежуточных результатов
• Батч-обработка
• Предпросмотр в реальном времени

Структура нод

Все ноды имеют префикс MPA (MoviePy Adapter) и находятся в категории MPA/video:

Нода	Назначение	Основные параметры
MPA Combine Videos	Объединение видео	IMAGE1-10, fps
MPA Video Transition	Переходы	IMAGE1, IMAGE2, transition_type, duration, fps
MPA Brightness Effect	Яркость	IMAGE, factor (0-3), fps
MPA Contrast Effect	Контраст	IMAGE, factor (0-3), fps
MPA Speed Effect	Скорость	IMAGE, factor (0.1-10), fps

Вклад в проект

Приветствуются pull requests! Если у вас есть идеи по улучшению или вы нашли баг - создайте issue.

Лицензия

GNU General Public License v3

Автор

nschpy - GitHub

---

Версия: 0.0.1
Дата: 2025

Создано с ❤️ для комьюнити ComfyUI