leamsigc/ShortsGenerator
Automate the creation of Shorts content locally with a couple simple steps.
ShortsGenerator – 자동화된 YouTube Shorts 제작 도구
기능 설명
- 텍스트 프롬프트에서 AI로 작성된 스크립트, 스톡 영상, 텍스트 음성 변환(TTS), 자막, 배경 음악 및 선택적 이미지 합성을 사용하여 짧은 형식의 비디오를 생성합니다.
- Flask 백엔드와 통신하는 웹 UI(Nuxt 3)를 제공합니다. 백엔드는 전체 파이프라인을 실행하고 일련의 REST 엔드포인트를 노출합니다.
- 비디오가 생성된 후 MagicSync 통합을 통해 여러 소셜 플랫폼(Instagram, TikTok, Facebook, LinkedIn, YouTube)에 게시를 예약할 수 있습니다.
주요 구성 요소
| 계층 | 기술 / 역할 |
|---|---|
| 백엔드 | Python 3.11, Flask, ffmpeg, Torch(Qwen-3 TTS용), g4f/Gemini(스크립트 생성용). 스톡 비디오 검색(Pexels API), TTS(Supertonic, TikTok, KittenTTS, Qwen-3), 자막 렌더링, 비디오 합성 및 MagicSync API 호출을 처리합니다. |
| 프론트엔드 | Nuxt 3(Vue) UI, localhost:3000에서 실행됩니다. 주제를 입력하고, 생성된 스크립트를 편집하고, 음성, 자막, 화면 비율, 음악 등을 선택한 다음 문서화된 API를 통해 백엔드를 트리거할 수 있습니다. |
| AI 모델 | • 스크립트: 무료 g4f(브라우저 쿠키 기반) 또는 Gemini(GOOGLE_API_KEY 사용). |
| • TTS: 로컬 Supertonic(10개 음성, 33개 언어), TikTok TTS(대체), KittenTTS, Qwen-3-TTS(9가지 사전 설정 음색, 음성 디자인, 음성 복제 지원 로컬 모델). | |
| 미디어 소스 | Pexels의 스톡 클립, 사용자 제공 음악 파일, 비디오 시작 부분의 선택적 이미지 합성. |
| 게시 예약 | MagicSync – 여러 비즈니스 계정(API URL + 토큰)을 저장하고 게시 시 사용할 계정을 선택할 수 있습니다. |
사용 방법
- 저장소를 클론하고
.env.example을.env로 복사한 후 최소한PEXELS_API_KEY와IMAGEMAGICK_BINARY를 입력합니다. - 백엔드(
python Backend/main.py)와 Nuxt UI(cd UI && pnpm i && npx nuxt dev --tunnel)를 실행합니다. Docker도docker compose up -d를 통해 지원됩니다. - 웹 UI에서 비디오 주제를 입력하고, 스크립트를 생성하고, 수정하고, 음성과 자막 스타일을 선택하고, 선택적 이미지나 음악을 추가한 다음 생성을 클릭합니다.
- 비디오가 완성되면 썸네일을 추출하고 미리 본 다음 MagicSync를 통해 업로드를 예약할 수 있습니다.
주요 기능
- 로컬 고품질 모델(Qwen-3) 및 대체 모델을 사용한 다중 음성 TTS.
- 자동으로 생성되는 자막 템플릿(10가지 시각적 스타일).
- 세로형 Shorts(9:16) 또는 기타 형식을 위한 화면 비율 유연성.
- 하드웨어 가속 – GPU를 감지하여 더 빠른 인코딩을 위해 ffmpeg/Torch에 전달합니다.
- 다중 비즈니스 MagicSync – 클라이언트별로 별도의 API 자격 증명을 저장하고 예약 시 올바른 자격 증명을 선택합니다.
유용한 대상
- 비디오를 수동으로 편집하지 않고 YouTube Shorts를 대량 생산하려는 콘텐츠 제작자.
- 여러 브랜드 계정을 관리하고 반복 가능한 파이프라인이 필요한 소규모 에이전시.
- 엔드투엔드 짧은 형식 비디오 생성 스택의 오픈 소스 참조 구현을 찾는 개발자.
제한 사항
- Python 3.11과 상당히 무거운 종속성 스택(Torch, Qwen-3 가중치 ≈ 3GB)이 필요합니다.
- 일부 AI 서비스(Gemini, OpenAI)는 API 키가 필요하며, 무료
g4f경로는 브라우저 쿠키에 의존합니다. - 게시 예약은 독점 MagicSync 서비스에서만 작동하며, 저장소는 일반적인 소셜 미디어 API를 제공하지 않습니다.
라이선스
- 이 프로젝트는
LICENSE파일에 있는 라이선스에 따라 배포됩니다(여기에 재현되지 않음).
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트