masihsultani/whiteboard-animator

어떤 프로젝트인가요?

핵심 기능

• 01텍스트를 단어별로 쓰고 윤곽선을 자동으로 따라 그립니다.
• 02도형 크기에 따라 붓질이나 쓸기 방식으로 채웁니다.
• 03텍스트 감지 모델이 함께 제공되어 GPU나 API 키 없이 CPU에서 실행됩니다.
• 04내레이션 파일의 길이에 맞춰 그리는 시간을 조정합니다.
• 05FFmpeg를 사용해 여러 장면을 하나의 MP4로 이어 붙입니다.
• 06매개변수를 조정할 수 있는 CLI와 Python API를 모두 제공합니다.

활용 사례

• 강의 또는 설명 영상에 사용할 다이어그램이나 화이트보드 스케치를 애니메이션으로 만듭니다.
• 내레이션이 포함된 교육 콘텐츠에 손으로 그려지는 효과를 더합니다.
• 명령줄에서 여러 일러스트 장면을 하나의 영상으로 일괄 렌더링합니다.

빠른 시작

1. 1

   FFmpeg 설치(macOS에서는 Homebrew 사용)

   brew install ffmpeg
2. 2

   PyPI에서 패키지 설치

   pip install whiteboard-animator
3. 3

   화이트보드 이미지를 8초 길이의 MP4로 렌더링

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

사용 전 알아둘 점

• !FFmpeg와 ffprobe를 별도로 설치하고 PATH에 추가해야 합니다.
• !흰 배경에 마커로 그린 듯한 그림에서 가장 잘 작동합니다. 사진이나 색상이 있는 배경은 애니메이션이 잘 되지 않습니다.
• !내레이션 속도는 텍스트를 기준으로 추정하며 음성과 동기화되지 않으므로, 음성과 타이밍이 어긋날 수 있습니다.

토픽

자주 묻는 질문

whiteboard-animator은(는) 무엇인가요?

화이트보드 스타일 이미지를 CPU로 렌더링해 손으로 그리는 효과의 MP4로 변환하는 CLI 및 Python 라이브러리 whiteboard-animator는 흰 배경에 잉크로 그린 완성된 이미지를 손으로 그려 나가는 영상으로 만들어 줍니다. 텍스트는 단어별로 써 내려가고, 윤곽선은 따라 그리며, 도형은 붓질이나 비스듬한 쓸기 방식으로 채우고, 가지가 뻗은 선화는 펜 경로를 하나씩 그립니다. 렌더링에 학습이나 API 키가 필요하지 않으며 CPU에서 실행됩니다. 함께 제공되는 ONNX CRAFT 텍스트 감지기를 사용해 텍스트와 도형을 구분합니다.

whiteboard-animator은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

whiteboard-animator은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

whiteboard-animator은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. whiteboard-animator의 마지막 커밋은 2026년 9월 8일입니다.

whiteboard-animator은(는) 어디에 사용할 수 있나요?

강의 또는 설명 영상에 사용할 다이어그램이나 화이트보드 스케치를 애니메이션으로 만듭니다. 내레이션이 포함된 교육 콘텐츠에 손으로 그려지는 효과를 더합니다. 명령줄에서 여러 일러스트 장면을 하나의 영상으로 일괄 렌더링합니다.

whiteboard-animator는 어떻게 설치하나요?

FFmpeg 설치(macOS에서는 Homebrew 사용): brew install ffmpeg PyPI에서 패키지 설치: pip install whiteboard-animator 화이트보드 이미지를 8초 길이의 MP4로 렌더링: whiteboard-animate sketch.png --duration 8 -o sketch.mp4

whiteboard-animator은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/masihsultani/whiteboard-animator