Ez FFmpeg – 평문 영어로 하는 비디오 편집

1 month ago 11

ffmpeg 명령어를 평문 영어로 실행할 수 있게 만든 Node.js 기반 CLI 도구로, 복잡한 옵션 없이 간단한 문장으로 영상 편집 가능
ff convert video.mp4 to gif처럼 명령어를 문장 형태로 입력하면 자동으로 ffmpeg 명령으로 변환해 실행
형식 변환, 압축, 자르기, 오디오 추출, 리사이즈, 속도 조절, 회전, 병합 등 다양한 작업을 지원
--dry-run 옵션으로 실제 실행 없이 ffmpeg 명령을 미리 확인 가능
인터넷 연결이나 AI 없이 오프라인에서 빠르게 동작하며, ffmpeg가 설치된 환경에서 Node.js 16 이상으로 사용 가능

개요

ezff는 ffmpeg를 쉽게 사용할 수 있도록 만든 평문 영어 기반 래퍼(wrapper)
- 사용자는 복잡한 ffmpeg 플래그나 매뉴얼을 외울 필요 없이 자연어 형태로 명령 입력
- 예: ff convert video.mp4 to gif → 자동으로 ffmpeg 명령 생성 및 실행
Node.js 16 이상과 ffmpeg 설치가 필요하며, npm을 통해 npm install -g ezff로 설치 가능

대화형 프롬프트 모드 제공
- ff 명령만 입력하면 파일 경로, 작업 종류, 출력 형식 등을 순차적으로 질문
- 예시: ? File path: video.mp4 ? What do you want to do? › Convert format ? Convert to: › GIF
- 선택 후 ffmpeg 명령이 자동 생성되어 실행됨
직접 명령 입력 모드 지원
- 사용자가 원하는 작업을 한 줄로 입력 가능
- 예:
  - ff convert video.mp4 to mp3
  - ff compress video.mp4 to 10mb
  - ff trim video.mp4 from 0:30 to 1:00
  - ff resize video.mp4 to 1280x720
  - ff speed up video.mp4 by 2x

변환(Convert) : 형식 변경 (mp4 → gif, mp4 → mp3)
압축(Compress) : 파일 크기 제한 설정 (10mb 등)
자르기(Trim) : 특정 구간 추출 (from 0:30 to 1:00)
오디오 추출(Extract audio) : 영상에서 오디오만 분리
리사이즈(Resize/Scale) : 해상도 변경 (1280x720, 720p)
속도 조절(Speed up / Slow down) : 재생 속도 변경 (2x)
반전(Reverse) , 음소거(Mute) , 회전(Rotate) , 뒤집기(Flip) , 썸네일 추출(Thumbnail) , 병합(Merge) , 그레이스케일(Grayscale) , 노이즈 제거(Denoise) , 영상 안정화(Stabilize) 등 다양한 작업 지원

--dry-run 옵션으로 실제 실행 없이 ffmpeg 명령만 출력 가능
- 예: ff convert video.mp4 to gif --dry-run → ffmpeg -i video.mp4 -vf fps=15,scale=480:-1:flags=lanczos -loop 0 -y video_output.gif
결과 파일은 원본과 같은 폴더에 _output 접미사로 저장 (video_output.gif)

Node.js 16 이상 필요
ffmpeg가 시스템 PATH에 설치되어 있어야 함
- macOS: brew install ffmpeg
- Ubuntu/Debian: sudo apt install ffmpeg
- Windows: choco install ffmpeg
MIT 라이선스로 공개되어 있으며, Pull Request 환영