요약
파이썬으로 영상을 자르고 붙이고 자막 · 효과를 넣는 편집 라이브러리. 합성 · 비선형 편집 · 커스텀 효과 지원. MIT
설명
MoviePy
💡 알림 MoviePy가 최근 v2.0으로 올라가면서 큰 호환성 변경이 생겼어요. 마지막 v1 문서는 여기에서 볼 수 있지만, v1은 더 이상 관리되지 않으니 조심하세요. v1 코드를 v2로 바꾸는 방법은 이 안내를 보세요.
MoviePy(온라인 문서)는 영상 편집을 위한 파이썬 라이브러리예요. 자르기, 이어 붙이기, 제목 넣기, 영상 합성(비선형 편집이라고도 해요), 영상 처리, 사용자 정의 효과 만들기를 할 수 있어요.
MoviePy는 GIF를 포함한 거의 모든 일반적인 오디오 · 영상 형식을 읽고 쓸 수 있고, Python 3.9 이상에서 Windows / Mac / Linux로 돌아가요.
예제
이 예제는 영상 파일을 열어 10초에서 20초 사이 구간을 고르고, 화면 가운데에 제목을 넣은 뒤 결과를 새 파일로 저장해요.
from moviepy import VideoFileClip, TextClip, CompositeVideoClip
# example.mp4 파일을 불러와 00:00:10부터 00:00:20까지의 구간만 남긴다
# 오디오 음량은 원래의 80%로 줄인다
clip = (
VideoFileClip("long_examples/example2.mp4")
.subclipped(10, 20)
.with_volume_scaled(0.8)
)
# 텍스트 클립을 만든다. 글꼴, 색 등을 바꿀 수 있다.
txt_clip = TextClip(
font="Arial.ttf",
text="Hello there!",
font_size=70,
color='white'
).with_duration(10).with_position('center')
# 텍스트 클립을 첫 번째 영상 클립 위에 올린다
final_video = CompositeVideoClip([clip, txt_clip])
final_video.write_videofile("result.mp4")
MoviePy는 어떻게 동작하나요
내부적으로 MoviePy는 미디어(영상 프레임, 이미지, 소리)를 가져와 파이썬 객체(numpy 배열)로 바꿔요. 그래서 모든 픽셀에 접근할 수 있고, 영상이나 오디오 효과를 단 몇 줄로 정의할 수 있어요(내장 효과에서 예제를 볼 수 있어요).
라이브러리는 클립을 섞는 방법도 제공해요. 이어 붙이기, 클립을 나란히 놓거나 투명도를 주어 위에 겹쳐 놓기 등이에요. 최종 클립은 다시 mp4 / webm / gif 등으로 인코딩돼요.
그래서 MoviePy는 아주 유연하고 쓰기 쉬운 대신, 데이터를 많이 불러오고 내보내야 해서 ffmpeg을 직접 쓸 때보다는 느려요.
설치
pip install moviepy로 설치하세요. 사용자 지정 FFMPEG이나 미리보기 같은 추가 설치 옵션은 이 절을 보세요. 개발할 때는 저장소를 로컬에 내려받아 pip install -e .로 설치하세요.
문서
온라인 문서(여기)는 master 브랜치에 푸시할 때마다 자동으로 만들어져요. 문서를 로컬에서 빌드하려면 pip install "moviepy[doc]"로 추가 의존성을 설치한 뒤 docs 폴더로 가서 make html을 실행하세요.
기여하기
MoviePy는 Zulko가 처음 만들고 MIT 라이선스로 공개한 오픈소스 소프트웨어예요. 프로젝트는 GitHub에서 관리되고, 누구나 기여하거나 이슈를 열거나 의견을 줄 수 있어요. 기여 안내를 읽어 보세요. 도움이 필요하거나 사용법과 예제를 이야기하고 싶다면 Reddit 채널을 이용하세요.
관리자
현재 관리자
- Zulko (소유자)
- @osaajani가 v2 개발을 이끌었어요(MR)
- @tburrows13
- @keikoro
이전 관리자와 감사 인사
관리자를 찾아요! 이 라이브러리는 관리자들의 참여로 겨우 이어져 왔고, 우리 모두 시간을 내기 어려운 때가 있어요. 이슈를 해결하고(특히 여러분께 영향을 주는 것) 풀 리퀘스트를 검토하는 일을 도와줄 개발자를 기다리고 있어요. 관심이 있다면 이슈를 열거나 우리에게 직접 연락해 주세요. 고맙습니다!
라이선스
MIT 라이선스(LICENCE.txt).
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0