🎬 Broadcaster Studio (broadcaster-studio)

Broadcaster Studio는 Python과 FFmpeg를 활용하여 고화질 뉴스 방송 자막, 자막 오버레이, 실시간 타임스탬프를 초고속으로 렌더링하는 오픈소스 라이브러리입니다.

🚀 주요 기능 (Features)

• 📰 뉴스 자막 오버레이: 메인 헤드라인, 속보/단독 배지 지원
• 📜 흐르는 자막 (Ticker Text): 하단 스크롤 자막 기능 지원
• ⏱️ 실시간 타임코드: 비디오 PTS 기반 HH:MM:SS 타임스탬프 표시
• 🎨 커스텀 폰트 및 리소스: PNG 이미지 및 TTF/OTF 한글 폰트 완벽 지원
• ⚡ FFmpeg 가속: libx264 기반 초고속 하드웨어/소프트웨어 비디오 렌더링

📦 설치 (Installation)

pip install broadcaster-studio

💡 상세 사용법 (Usage Example)

broadcaster 라이브러리를 활용하여 뉴스 자막 영상을 렌더링하는 기본 코드입니다.

from broadcaster.studio import BroadcasterStudio

# 1. BroadcasterStudio 인스턴스 생성
studio = BroadcasterStudio(
    video_path="test.mp4",                            # 원본 비디오 경로
    font_path="~/.fonts/NotoSansKR-Bold.ttf"          # 사용할 한글 폰트 경로
)

# 2. 방송 오버레이 요소 설정
studio.add_main_overlay("_temp_main_overlay.png")     # 하단 뉴스 자막 틀 이미지
studio.add_badge("_temp_age_badge.png", start=0, end=5) # 연령 고지 등 배지 (0~5초)

# 3. 뉴스 텍스트 설정
studio.set_headline("[단독]")                          # 헤드라인 태그
studio.set_ticker("권팝 개발자, Broadcaster Studio PyPI 공식 배포 성공!") # 하단 스크롤 자막

# 4. 타임코드(시계) 및 오디오 옵션 활성화
studio.enable_timecode(position="bottom-right")       # 오른쪽 하단 타임코드
studio.set_audio("_temp_audio.aac")                   # 배경 오디오 설정

# 5. 최종 영상 렌더링
studio.render("output_news.mp4")
print("✅ 방송 영상 렌더링 완료!")

🛠️ 요구 사항 (Requirements)

• Python: 3.8 이상
• FFmpeg: 시스템 또는 Termux 환경에 ffmpeg 설치 필요
• Pillow: 9.0.0 이상

📄 라이선스 (License)

MIT License