ffmpeg-encode (Install)

프로그램 소개

Video Encoder GUI는 HandBrake와 FFmpeg를 결합하여 비디오 파일을 인코딩하는 그래픽 사용자 인터페이스(GUI) 애플리케이션입니다. Python 기반의 크로스 플랫폼 프로그램으로, Windows, macOS, Linux 환경 모두에서 동작합니다. 자동 트랙 감지, 프리셋 관리, 실시간 진행 상황 추적 등 사용자 편의를 위한 다양한 기능을 제공합니다.

주요 기능

• _dual encoder support_: HandBrake 또는 FFmpeg를 선택하여 인코딩에 사용할 수 있습니다.
• _HandBrake 프리셋 지원_: HandBrake JSON 프리셋 파일을 불러와 인코딩 옵션을 설정할 수 있습니다. 프리셋은 자동으로 저장되며, 마지막에 사용한 프리셋이 시작 시 자동으로 로드됩니다.
• _FFmpeg 명령어 관리_: HandBrake 프리셋에서 변환된 FFmpeg 명령어를 편집하거나, 처음부터 커스텀 명령어를 작성할 수 있습니다. 명령어는 이름을 지정하여 저장 및 로드할 수 있습니다.
• _스마트 트랙 감지_: 영어 오디오 및 자막 트랙을 자동으로 찾는 기능을 제공합니다. 언어 태그, 이름 패턴, 제외 패턴을 사용자 정의하여 감지 방식을 조정할 수 있습니다.
• _실시간 진행 상황 표시_: 인코딩 진행률, ETA, 속도, 기간 등을 실시간으로 확인할 수 있습니다. 내장된 로그 뷰어를 통해 인코딩 출력을 모니터링할 수도 있습니다.
• _인코딩 모드_: 순차적 또는 병렬 인코딩 모드를 선택할 수 있습니다.
• _플레이스홀더 시스템_: FFmpeg 명령어에서 {INPUT}, {OUTPUT}, {AUDIO_TRACK}, {SUBTITLE_TRACK}, {SUBTITLE_FILE}과 같은 동적 플레이스홀더를 사용할 수 있습니다.
• _자동 의존성 설치_: FFmpeg, HandBrake, mkvtoolnix 등 필요한 의존성을 자동으로 설치할 수 있습니다.

다운로드·설치 방법

프로그램은 두 가지 방법으로 설치할 수 있습니다.

소스에서 직접 실행

1. 저장소를 클론합니다: git clone https://github.com/Ryahn/ffmpeg_encode.git
2. Python 의존성을 설치합니다: pip install -r requirements.txt
3. 애플리케이션을 실행합니다: python src/main.py

미리 빌드된 실행 파일 사용

GitHub 릴리즈 페이지에서 최신 릴리즈를 다운로드할 수 있습니다. Windows 사용자는 ffmpeg_encode-portable.exe(포터블) 또는 ffmpeg_encode-Setup.exe(설치 프로그램)를 선택할 수 있습니다. 애플리케이션을 시작하면 누락된 의존성을 자동으로 감지하고 Chocolatey를 통해 설치를 제안합니다.

기본 사용법

1. 파일 탭: 비디오 파일(MKV, MP4, MOV 등)이 있는 폴더를 스캔하도록 선택합니다.
2. HandBrake 탭: HandBrake 프리셋 JSON 파일을 불러오고 인코딩 옵션을 설정합니다.
3. FFmpeg 탭: 변환된 FFmpeg 명령어를 보고 편집한 후 인코딩을 시작합니다.
4. 설정 탭: FFmpeg, HandBrake, mkvinfo의 경로를 설정하고 트랙 감지 패턴을 조정합니다.
5. 디버그 탭: 개별 파일을 분석하여 트랙 정보와 mkvinfo 출력을 확인할 수 있습니다.

이런 경우에 유용합니다

• HandBrake 프리셋을 사용하면서 더 유연한 FFmpeg 명령어 제어가 필요할 때
• 대량의 비디오 파일을 일괄 처리하고 각 파일의 오디오/자막 트랙을 자동으로 선택하고 싶을 때
• FFmpeg 명령어를 처음부터 작성하는 대신 GUI 환경에서 편리하게 인코딩을 관리하고 싶을 때

지원 환경·시스템 요구사항

• 운영체제: Windows, macOS, Linux
• Python: 3.8 이상
• 필수 패키지: PyQt6 (requirements.txt를 통해 설치)
• 추가 의존성: FFmpeg, HandBrake CLI, MKVToolNix. Windows/macOS에서는 Chocolatey/Homebrew를 통해 자동 설치를 지원합니다. Linux에서는 시스템 패키지 매니저를 사용해야 합니다.

제한 사항·확인 사항

• Linux 환경에서 FFmpeg, HandBrake CLI, MKVToolNix는 시스템 패키지 매니저를 통해 별도로 설치해야 합니다.
• 애플리케이션은 인코딩 명령어를 생성하고 실행하지만, 최종 인코딩 결과물의 품질은 설정된 프리셋과 명령어에 따라 다릅니다.