Metadata-Version: 2.4
Name: broadcaster-studio
Version: 0.1.7
Summary: FFmpeg & Pillow based Ultra-fast Broadcast Studio Overlay Tool
Author: KwonPop
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=9.0.0
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🎬 Broadcaster Studio (broadcaster-studio)

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

---

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

---

## 📦 설치 (Installation)

```bash
pip install broadcaster-studio
```

---

## 💡 상세 사용법 (Usage Example)

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

```python
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
