Repolode
Предложить
masihsultani

masihsultani/whiteboard-animator

Утилита командной строки и библиотека Python, которые превращают изображение в стиле доски для рисования в MP4 с прорисовкой от руки, используя CPU и при необходимости синхронизацию с озвучкой.

Открыть на GitHub
Звёзды
242
Форки
27
Открытые issues
3
Последний коммит
в прошлом месяце

Что это?

whiteboard-animator берет готовое изображение с рисунком на белом фоне и создает видео, в котором рисунок появляется как будто его рисуют от руки. Текст выводится слово за словом, контуры обводятся, фигуры заполняются мазками кисти или движением под углом, а разветвленный линейный рисунок прорисовывается по одному пути пера за раз. Рендеринг выполняется на CPU, без обучения и API-ключей; чтобы отличать текст от фигур, используется входящий в комплект детектор текста ONNX CRAFT.

Инструмент устанавливается из PyPI как команда `whiteboard-animate`. Также доступен Python API для рендеринга сцен, объединения нескольких сцен в одно видео и настройки параметров затухания и заливки. Видео создается с помощью FFmpeg, который должен быть доступен в PATH. Для каждой сцены можно задать аудио: тогда время прорисовки подбирается так, чтобы она завершилась к концу озвучки. План областей в формате JSON может оценивать темп по тексту аннотации, а дополнительная функция на базе Gemini может предложить такой план.

Движок лучше всего работает с чистыми рисунками маркером и сплошными цветами. Фотографии, градиенты, текстурированные и цветные фоны не поддерживаются.

Ключевые возможности

  • 01Выводит текст слово за словом и автоматически обводит контуры.
  • 02Заполняет фигуры мазками кисти или движением под углом — в зависимости от размера.
  • 03Работает на CPU со встроенной моделью обнаружения текста; GPU и API-ключ не нужны.
  • 04Синхронизирует прорисовку с длительностью файла озвучки.
  • 05Объединяет несколько сцен в один MP4 с помощью FFmpeg.
  • 06Предоставляет CLI и Python API с настраиваемыми параметрами.

Сценарии использования

  • Создание анимации диаграмм и эскизов на доске для лекций и поясняющих видео.
  • Добавление эффекта прорисовки от руки в озвученный образовательный контент.
  • Пакетный рендеринг серии иллюстрированных сцен в одно видео из командной строки.

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

  1. 1

    Установить FFmpeg (на macOS — через Homebrew)

    brew install ffmpeg
  2. 2

    Установить пакет из PyPI

    pip install whiteboard-animator
  3. 3

    Преобразовать изображение для белой доски в MP4 длительностью 8 секунд

    whiteboard-animate sketch.png --duration 8 -o sketch.mp4

Что важно знать

  • Требуется отдельно установить FFmpeg и ffprobe и добавить их в PATH.
  • Лучше всего подходит для рисунков маркером на белом фоне; фотографии и цветные фоны будут анимироваться плохо.
  • Темп озвучивания рассчитывается по тексту, а не синхронизируется с речью, поэтому тайминг может расходиться с голосом.

Темы

#animation#video#whiteboard#ffmpeg#computer-vision#python#cli

Частые вопросы

Что такое whiteboard-animator?
Утилита командной строки и библиотека Python, которые превращают изображение в стиле доски для рисования в MP4 с прорисовкой от руки, используя CPU и при необходимости синхронизацию с озвучкой. whiteboard-animator берет готовое изображение с рисунком на белом фоне и создает видео, в котором рисунок появляется как будто его рисуют от руки. Текст выводится слово за словом, контуры обводятся, фигуры заполняются мазками кисти или движением под углом, а разветвленный линейный рисунок прорисовывается по одному пути пера за раз. Рендеринг выполняется на CPU, без обучения и API-ключей; чтобы отличать текст от фигур, используется входящий в комплект детектор текста ONNX CRAFT.
whiteboard-animator можно использовать бесплатно? Какая у него лицензия?
whiteboard-animator распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
whiteboard-animator всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в whiteboard-animator — 8 сент. 2026 г..
Для чего можно использовать whiteboard-animator?
Создание анимации диаграмм и эскизов на доске для лекций и поясняющих видео. Добавление эффекта прорисовки от руки в озвученный образовательный контент. Пакетный рендеринг серии иллюстрированных сцен в одно видео из командной строки.
Как установить whiteboard-animator?
Установить FFmpeg (на macOS — через Homebrew): brew install ffmpeg Установить пакет из PyPI: pip install whiteboard-animator Преобразовать изображение для белой доски в MP4 длительностью 8 секунд: whiteboard-animate sketch.png --duration 8 -o sketch.mp4
Где скачать whiteboard-animator?
Исходный код и инструкции по установке — на GitHub: https://github.com/masihsultani/whiteboard-animator

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

3b1b / manim

ManimGL — оригинальный движок 3Blue1Brown для создания точных анимаций на основе кода, используемых в обучающих видео по математике.

Другое#animation#python#math
95,4 тыс.7,8 тыс.PythonMITОбновлён в прошлом месяце