Shorts Pipeline
영상 업로드, 클립 선택, TTS 대본, 음성, 자막, FFmpeg 합성을 한 프로젝트 흐름으로 묶은 개인 제작 도구입니다.
Editor소스 영상, 클립, 분석 메모, 타임라인을 한 화면에서 봅니다.
TTS대본 생성, 음성 선택, 업로드 흐름을 탭으로 나눴습니다.
Compose마지막 탭에서 자막과 음성 상태를 확인하고 합성으로 넘깁니다.

정보
Repository는 private으로 운영 중입니다. 공개 페이지에는 민감정보, 저작권 이슈, 재사용 가능한 세부 구현을 노출하지 않습니다.
Snapshot
| 구분 | 내용 |
|---|---|
| 상태 | In progress, private repository |
| 문제 | 숏폼 제작 과정에서 파일 관리, 대본 생성, 자막 처리, 렌더링 단계가 분리되어 반복 비용이 큼 |
| 접근 | 프로젝트 단위로 원본, 클립, 대본, 출력물을 관리하고 LLM API와 FFmpeg 처리를 연결 |
| 기술 | FastAPI, Python, LLM API, FFmpeg, yt-dlp, Docker |
| 실행 | Docker 기반 실행과 로컬 업로드/출력 디렉터리 분리를 고려 |
What It Does
- 제작 작업을 프로젝트 단위로 만들고 상태를 관리합니다.
- 업로드 파일과 출력물을 분리해 작업 단계를 추적합니다.
- 데스크톱과 모바일에서 같은 제작 단계를 이어서 볼 수 있 는 탭형 UI를 제공합니다.
- TTS 대본 생성, TTS 음성 생성/업로드, FFmpeg 합성 흐름을 파이프라인에 포함합니다.
- Docker 실행 환경으로 로컬 실행 조건을 일정하게 맞춥니다.
데스크톱/모바일 화면


단계별 탭 화면




화면으로 보는 기능
프로젝트 단위 작업
업로드 파일, 클립, 대본, 출력물을 하나의 프로젝트 상태로 묶어 작업 흐름을 추적합니다.
TTS 대본 생성
클립 길이와 목적에 맞춰 여러 스타일의 대본을 생성하고, 선택한 버전을 직접 편집합니다.
TTS 음성 매칭
대본을 음성으로 만들거나 파일을 업로드하고, 통합/구간별 TTS 흐름을 선택할 수 있게 나눴습니다.
FFmpeg 합성 확인
영상 레이아웃, 오디오 비율, 자막, 오버레이 상태를 마지막 탭에서 검토한 뒤 합성합니다.
동작 흐름
1프로젝트 생성
제작 단위를 만들고 입력 파일을 분리해 저장합니다.
2클립 준비
원본, 선택 구간, 출력 조건을 작업 상태로 관리합니다.
3대본 생성
LLM API로 숏폼용 대본과 자막 초안을 만듭니다.
4렌더링 확인
FFmpeg 결과물을 output 영역에서 검토합니다.
Portfolio Signal
이 프로젝트의 중심은 화면보다 작업 흐름입니다. 파일 업로드, 상태 관리, 외부 API 호출, 렌더링처럼 끊기기 쉬운 단계를 하나의 작업 모델로 묶었습니다.
Implementation Notes
- FastAPI를 사용해 업로드, 프로젝트 조회, 상태 변경, 렌더링 요청을 API로 분리했습니다.
uploads와outputs디렉터리를 분리해 원본과 결과물을 명확히 관리합니다.- Dockerfile에서 FFmpeg와 폰트 의존성을 함께 구성해 렌더링 환경 차이를 줄였습니다.
- API key는 환경변수로 분리해 repository에 저장하지 않는 구조를 전제로 합니다.
Next
- 긴 작업의 진행률, 실패 원인, 재시도 상 태를 더 명확히 노출
- 대본 버전 관리와 렌더링 설정 변경 이력을 정리
- README와 실행 문서를 보강해 프로젝트 설명 가능성 개선