설치와 실행

사전 요구사항, 저장소 클론, FFmpeg 경로 지정, 소스에서 빌드 검증까지.

사전 요구사항

• Node.js 22 이상, npm 10 이상
• FFmpeg — MP4 내보내기에 필요합니다
• macOS 한정: 창 캡처를 쓴다면 OpenVideo를 실행하는 터미널에 화면 기록 권한이 필요합니다

클론과 실행

git clone https://github.com/Theorvane/openvideo.git
cd openvideo
npm install
npm run dev

npm run dev는 렌더러를 개발 모드로 두고 Electron 앱을 실행합니다. 첫 실행에서는 시작 페이지가 열리고, 여기서 첫 프로젝트로 열 폴더를 선택합니다.

FFmpeg 지정하기

OpenVideo는 자체 FFmpeg를 포함하지 않고 사용자가 설치한 FFmpeg를 구동합니다. PATH의 절대 경로 디렉터리를 통해 ffmpeg를 찾을 수 있게 하거나, 바이너리를 명시적으로 지정하세요.

VIDEO_TOOL_FFMPEG_PATH=/absolute/path/to/ffmpeg npm run dev

클라우드 계정 없이 에이전트 쓰기

로컬 Ollama 엔진은 키도, 계정도, 네트워크 호출도 필요하지 않습니다.

ollama pull qwen2.5-coder
ollama serve

그다음 채팅 패널의 모델 선택기에서 로컬 모델을 고르세요. 다만 영상을 보고 판단하는 기능에는 비전 지원 모델이 필요합니다. 프로바이더와 모델을 참고하세요.

소스에서 검증

npm run typecheck
npm test
npm run build

npm run build는 main, preload, 렌더러 번들을 out/으로 컴파일합니다. 설치 파일을 패키징하지는 않습니다. 운영체제 권한, 실제 프로바이더 호출, 최종 렌더 품질처럼 수동으로만 확인할 수 있는 동작도 있습니다.