JayWebtech/autoshorts

AutoShorts는 긴 형식의 비디오 또는 오디오 녹음을 AI 기반 바이럴 순간 순위 지정 기능을 통해 임팩트 있는 세로형(9:16 포트레이트) 쇼트 클립 후보로 변환하는 로컬 우선 데스크톱 애플리케이션입니다.

이 리포지토리는 Tauri 2 + React + TSX + Rust + SQLite를 사용하여 데스크톱 앱의 기반을 구현합니다.

다이나믹 멀티-LLM 지원: 바이럴 순간 감지 및 후크 분석을 위해 DeepSeek(기본값)와 Claude(anthropic) 모두를 지원합니다.
자동화된 파이프라인: 미디어를 가져오고, 오디오를 추출하며, Deepgram을 사용하여 전사(transcribe)하고, 단일 자동화 체인 내에서 순간들을 자동으로 분석하고 순위 지정합니다.
로컬 SQLite 저장소: 전사본, 후보 클립, 사용자 정의 이름 및 렌더링 데이터를 로컬에 저장합니다.
네이티브 프로젝트 관리자: 대시보드에서 프로젝트를 생성, 열기, 이름 변경 및 삭제할 수 있습니다.
포트레이트 자동 크롭핑: 네이티브 ffmpeg 통합을 사용하여 가로 비디오를 세로 H.264 포트레이트 클립으로 자동으로 중앙 크롭합니다.
주요 경고 사항: 누락된 환경 변수를 식별하고 UI에서 직접 사용자에게 안내하는 내장 시각적 경고가 있습니다.

애플리케이션을 실행하려면, 크롭핑, 오디오 추출 및 동적 자막 기능을 처리하기 위해 FFmpeg & FFprobe이 설치되어 시스템 PATH에 있어야 합니다:

macOS: Homebrew를 사용하여 설치합니다: brew install ffmpeg
참고: 전체 자막 렌더링 지원을 보장하려면, 표준 Homebrew FFmpeg에 drawtext/subtitles 필터가 없는 경우, 다음 명령으로 tap하고 설치하세요: brew tap homebrew-ffmpeg/ffmpeg && brew install homebrew-ffmpeg/ffmpeg/ffmpeg

Windows: PowerShell에서 Winget을 사용하여 설치합니다: winget install Gyan.FFmpeg
(또는 gyan.dev에서 릴리스 빌드를 다운로드하여 시스템 PATH 환경 변수에 추가하세요).
Linux: 네이티브 패키지 관리자를 통해 설치합니다:
sudo apt install ffmpeg # Debian/Ubuntu
sudo pacman -S ffmpeg # Arch Linux
sudo dnf install ffmpeg # Fedora

최신 GitHub 릴리스에서 시스템에 맞는 올바른 패키지를 다운로드하세요.

다운로드: Apple Silicon (M1/M2/M3): aarch64.dmg 패키지를 선택하세요.Intel Mac: x64.dmg 패키지를 선택하세요.설치: .dmg 파일을 더블클릭하고 AutoShorts를 응용 프로그램(Applications) 폴더로 드래그하세요.게이트키퍼 우회(서명되지 않은 로컬 빌드의 경우): Finder에서 AutoShorts.app을 마우스 오른쪽 버튼으로 클릭하고 **열기(Open)**를 선택한 다음, 경고 대화 상자에서 **열기(Open)**를 클릭합니다. 또는, 터미널에서 이 명령어를 실행하세요: xattr -cr /Applications/AutoShorts.app

• 마우스 오른쪽 버튼을 클릭하여 다운로드: .msi (설치 프로그램) 또는 .exe (휴대용 실행 파일) 패키지를 선택하세요.설치: .msi 파일을 더블클릭하여 설정 마법사를 실행합니다.스마트스크린 우회: 이 패키지는 자체 서명되었기 때문에 Windows SmartScreen에서 경고가 표시될 수 있습니다. 창에서 **

자격 증명 업데이트 (Update Credentials): 앱 대시보드의 오른쪽 상단에 있는 API 설정(API Settings) 톱니바퀴 아이콘을 클릭하여 엔진을 전환하거나, 다른 로컬 모델을 선택하거나, API 키를 업데이트할 수 있습니다.온보딩 초기화 (Reset Onboarding): 클라우드에서 오프라인으로(또는 그 반대로) 전환하고 처음부터 설정을 시작하려면, API 설정 패널 하단에 있는 앱 구성 및 온보딩 재설정(Reset App Configuration & Onboarding) 버튼을 클릭하십시오. Tip

LLM 제공업체 추천 (로컬 vs. 클라우드):

로컬 모델 (Ollama): AutoShorts는 로컬 Ollama 모델(예: LLaMA 3.2 3B 또는 Qwen 2.5 3B/7B)을 통해 완전한 오프라인 순간 분석을 지원하지만, 로컬 모델은 일반적으로 바이럴 모멘트 감지에는 권장되지 않습니다. 더 작은 3B/7B 모델은 긴 스크립트를 평가하고 정확한 세그먼트 타임스탬프를 계산하는 데 필요한 컨텍스트 추론 및 수학적 능력이 부족하여 (종종 너무 짧은 조각을 출력합니다).DeepSeek (강력 추천): 모멘트 감지에는 DeepSeek 사용을 강력히 권장합니다. DeepSeek은 최고 수준의 추론 능력(GPT-4/Claude 3.5 Sonnet에 필적)을 제공하면서도 실행당 비용이 매우 저렴합니다(스크립트당 $0.001 미만). platform.deepseek.com에서 즉시 API 키를 받을 수 있습니다.Claude (프리미엄 옵션): Claude 3.5 Sonnet은 최고의 후크 카피라이팅 및 감정적 공명을 제공하지만, DeepSeek보다 약간 더 비쌉니다(일반적으로 실행당 $0.01 – $0.05).

.env.example 파일을 루트 폴더의 .env로 복사하십시오:
cp .env.example .env

API 키를 채우십시오:

DEEPGRAM_API_KEY=your-deepgram-api-key
DEEPSEEK_API_KEY=your-deepseek-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key
...

실시간 리로드되는 프론트엔드 및 백엔드 개발 셸을 시작하려면:

npm install
npm run tauri:dev

네이티브 macOS 앱 번들(.app) 및 .dmg 설치 프로그램을 빌드하고 패키징하려면:
npm run tauri:build

출력되는 설치 프로그램은 src-tauri/target/release/bundle/에 생성됩니다.

AutoShorts가 콘텐츠를 더 빠르게 만드는 데 도움이 되었다면, 개발 지원을 고려해 주십시오.

귀하의 지원은 새로운 기능, 버그 수정 및 지속적인 개선에 자금을 지원하는 데 도움이 됩니다.