Linux, Windows, macOS 및 가상머신(VM) 환경에서 설치·운영할 수 있는 크로스 플랫폼 셀프 호스팅(Self-hosted) 영상 편집 Utility, Video Editor를 공개합니다.
별도의 데스크톱 편집 프로그램 없이 브라우저에서 영상을 편집·병합할 수 있습니다.
로컬 환경에서는 http://127.0.0.1:8011로 접속하며, Nginx 등의 리버스 프록시와 HTTPS를 구성하면 자체 도메인으로 운영할 수도 있습니다.
VM 외부 접속에는 네트워크, 서버 바인딩, 방화벽 및 허용 호스트 설정이 필요합니다.
v1.0.0은 기존 v0.1.0 이후 개발된 영상 편집 기능과 프로젝트 관리, 출력 해상도 개선, Windows 자동 시작 지원 등을 반영한 첫 번째 정식 공개 버전입니다.
※ 주요 기능
-
기본 편집: Trim, Remove Segments, Crop, Scale, 재생 속도 조절(0.25~4배)
-
영상 효과: Fade In/Out, Crossfade, Fade Through Black, Wipe Left/Right
-
색상 보정: 밝기, 대비, 채도, 감마 조정 및 미리보기
-
오버레이: 텍스트·이미지 삽입, 위치·크기·투명도 조정, Motion Keyframes
-
자막: Subtitle Editor, SRT/WebVTT 가져오기, 자막 스타일 설정
-
영상 병합: 다중 파일 선택, 순서 변경, 클립별 전환 효과 및 시각적 미리보기
-
Timeline: 썸네일, 재생 위치 이동, 확대·축소, 구간 탐색
-
오디오: 유지·음소거·추출, 배경 음악 믹싱, Fade In/Out, Audio Keyframes
-
이미지: 특정 프레임 PNG 캡처
-
출력: 형식·비트레이트·FPS 설정, 진행 상태, 결과 미리보기 및 다운로드
-
편의 기능: Undo/Redo, 단축키, 프리셋, 한국어·영어 전환, Light/Dark 테마
-
프로젝트 관리: 프로젝트 저장·불러오기·삭제, 최근 작업 저장 및 복원
-
프로젝트 내보내기·가져오기: 편집 설정을 JSON 파일로 저장·불러오기, 필요 시 원본 영상 재선택
v1.0.0에서 보완된 기능
-
간편 해상도 설정: 원본 영상 방향과 종횡비를 고려한 480p·720p·1080p 출력 해상도 추천
-
가로·세로 영상 대응: 가로형과 세로형 영상에 맞는 출력 크기 계산
-
종횡비 유지: 원본 비율을 유지하면서 지정한 Scale 범위 안에 맞춰 출력
-
Crop·Scale 보정: 화면 자르기와 크기 변경 시 FFmpeg 처리 규칙에 맞게 출력 크기 계산
-
짝수 해상도 처리: H.264 인코딩 호환성을 고려한 출력 가로·세로 크기 보정
-
예상 출력 크기 표시: 사용자가 지정한 Scale 목표 크기와 실제 예상 출력 크기를 구분
-
이미지 오버레이 보정: Crop 및 Scale 이후의 출력 화면 크기를 기준으로 이미지 배치 계산
-
프로젝트 관리 개선: 저장된 프로젝트 삭제와 현재 편집 작업을 구분하고, 최근 작업 복원 및 저장 순서 처리 보완
-
Windows 자동 시작: PowerShell 시작 스크립트와 Windows 작업 스케줄러를 이용한 사용자 로그인 시 자동 실행 지원
-
AI 에이전트 운영 안내: 운영체제별 설치·실행 및 기존 설정 보존을 위한 AGENTS.md 지침 보완
종횡비를 유지하는 Scale 설정은 지정한 크기에 영상을 맞추는 방식이며, 빈 공간을 채워 강제로 해당 해상도를 만드는 방식은 아닙니다.
예를 들어 7680×4320 가로 영상을 720×1280 범위로 설정하면, 종횡비 유지 시 예상 출력은 720×406입니다.
이 결과는 정적 계산 기준이며, 이전에 발생했던 홀수 높이 인코딩 오류의 수정 효과는 동일 조건의 실제 브라우저 출력으로 추가 확인이 필요합니다.
Motion Keyframes, Audio Keyframes 및 영상 병합 전환 미리보기는 구현되었으나 일부 실제 출력·동작 검증이 남아 있습니다.
※ 기술 및 운영 특징
-
Backend: Python 3.11+, FastAPI, Uvicorn
-
Frontend: HTML5, CSS3, Vanilla JavaScript, Canvas API, WebGL
-
영상 처리: FFmpeg WebAssembly(WASM)
-
Database: SQLite
-
브라우저 저장소: IndexedDB 기반 프로젝트·미디어 저장 및 최근 작업 복원
-
서버 역할: 편집 설정(Recipe) 검증, FFmpeg 처리 계획 생성, 프리셋 관리
-
브라우저 역할: 영상 편집·병합, 인코딩, 결과 다운로드
현재 구현에서는 원본 영상과 배경 음악을 서버에 업로드하지 않고 브라우저 내부에서 처리합니다.
영상 처리 성능은 기기 사양, 브라우저, 파일 크기 및 코덱에 따라 달라집니다.
브라우저에 저장된 프로젝트와 최근 작업은 사이트 데이터 삭제 또는 브라우저 저장소 정리 시 사라질 수 있습니다.
프로젝트 JSON 파일에는 편집 설정과 미디어 정보가 저장되며, 원본 영상·오디오·이미지 파일 자체는 포함되지 않습니다. - 프로젝트 내보내기
※ 경량 설계 방향
Vanilla JavaScript와 SQLite를 사용하고 서버 측 인코딩을 브라우저 처리로 분리하여 운영 구조의 복잡성을 줄이는 것을 목표로 합니다.
별도의 서버 측 영상 인코딩 시스템이나 독립적인 데이터베이스 서버를 필수로 요구하지 않습니다.
경량 설계가 빠른 인코딩이나 낮은 메모리 사용량을 보장하는 것은 아닙니다.
※ 설치 및 실행 환경
-
Linux: 개인 서버, 홈서버, VM
-
Windows: Windows 10·11, VM
-
macOS: Intel 및 Apple Silicon
Python 3.11 이상과 프로젝트 의존성을 설치한 뒤 Uvicorn으로 실행합니다.
Windows에서는 별도의 WSL2나 Docker 없이 Python과 PowerShell을 이용하여 직접 실행할 수 있도록 구성했습니다.
v1.0.0에는 Windows 사용자 로그인 시 Video Editor를 실행하기 위한 PowerShell 스크립트와 작업 스케줄러 설정 안내도 포함했습니다.
단, 이 자동 시작 방식은 사용자 로그인 시 실행하는 방식으로, 로그인하지 않아도 시스템 부팅 직후 실행되는 Windows 서비스와는 다릅니다.
운영체제별 전체 기능의 호환성 검증과 Windows 자동 시작의 실제 환경 검증은 완료되지 않았으며, 환경에 따라 추가 설정이 필요할 수 있습니다.
※ 데모 및 소스 다운로드
-
라이선스: MIT License
배포 압축 파일은 Python 기반 웹 애플리케이션의 소스 배포본입니다.
Windows나 macOS에서 별도의 설치 과정 없이 실행되는 데스크톱 실행 파일은 아니며, Python 환경과 필요한 의존성을 구성한 후 실행하는 방식입니다.
Video Editor v1.0.0은 브라우저 기반 영상 편집·병합 기능에 프로젝트 관리, 출력 해상도 개선 및 크로스 플랫폼 설치·운영 지원을 반영한 정식 공개 버전입니다.
브라우저 호환성, 영상 처리 성능 및 일부 고급 기능에 대한 검증은 계속 보완할 예정입니다.
사용 후기, 오류 제보 및 기능 개선 제안, 환영합니다.
○ 참고 : 해당 포트폴리오
댓글 2개
6이 부활하려나 ,,,,,