FFmpeg은(는) 무엇을 하나요?
개요
FFmpeg는 미디어 처리의 스위스 아미 나이프입니다. 거의 모든 오디오 및 비디오 포맷, 코덱, 컨테이너를 처리합니다. 이 스킬은 포맷 변환, 코덱 트랜스코딩, 트리밍, 연결, 필터링, 압축, 썸네일 추출, 자막 삽입, 오디오 노멀라이즈, GIF 생성, 워터마킹, yt-dlp 및 gallery-dl과 같은 도구와의 파이프라인 통합을 다룹니다.
지침
1단계: 설치
# Ubuntu/Debian
sudo apt install -y ffmpeg
# macOS
brew install ffmpeg
# 확인
ffmpeg -version
ffprobe -version # 미디어 정보 도구, ffmpeg에 포함됨
2단계: 포맷 변환
가장 일반적인 작업 — 컨테이너 포맷과 코덱 간 변환.
# WebM → MP4 (H.264 + AAC로 재인코딩, 범용 호환성)
ffmpeg -i input.webm -c:v libx264 -c:a aac -movflags +faststart output.mp4
# WebM → MP4 (이미 H.264/AAC인 경우 스트림 복사 — 즉시, 품질 손실 없음)
ffmpeg -i input.webm -c copy output.mp4
# MKV → MP4 (스트림 복사, 재인코딩 없음)
ffmpeg -i input.mkv -c copy output.mp4
# AVI → MP4
ffmpeg -i input.avi -c:v libx264 -crf 23 -c:a aac -b:a 128k output.mp4
# MOV → MP4 (Apple ProRes to H.264)
ffmpeg -i input.mov -c:v libx264 -crf 18 -preset slow -c:a aac output.mp4
# 모든 포맷 → MP4 (웹 최적화 fast start 포함)
ffmpeg -i input.* -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart output.mp4
CRF (Constant Rate Factor): 품질을 제어합니다. 값이 낮을수록 더 나은 품질, 더 큰 파일.
- 18: 시각적 무손실
- 23: 기본값, 좋은 균형
- 28: 더 작은 파일, 일부 품질 손실
- 51: 최악의 품질
3단계: 오디오 작업
# 비디오에서 오디오 추출
ffmpeg -i video.mp4 -vn -c:a copy audio.aac # 코덱 복사 (빠름)
ffmpeg -i video.mp4 -vn -c:a libmp3lame -q:a 2 audio.mp3 # MP3로 변환
ffmpeg -i video.mp4 -vn -c:a flac audio.flac # 무손실 FLAC
# 오디오 포맷 간 변환
ffmpeg -i input.wav -c:a libmp3lame -b:a 320k output.mp3
ffmpeg -i input.mp3 -c:a libopus -b:a 128k output.opus
ffmpeg -i input.flac -c:a aac -b:a 256k output.m4a
# 오디오 볼륨 노멀라이즈
ffmpeg -i input.mp3 -af loudnorm=I=-16:LRA=11:TP=-1.5 output.mp3
# 샘플레이트 변경
ffmpeg -i input.wav -ar 44100 output.wav
# 비디오에 오디오 병합
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
4단계: 자르기, 컷 및 연결
# 타임스탬프부터 지속 시간까지 자르기
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4 # 1:30부터 45초
# 시작부터 끝 타임스탬프까지 자르기
ffmpeg -i input.mp4 -ss 00:05:00 -to 00:10:00 -c copy clip.mp4 # 5:00부터 10:00까지
# 처음 30초
ffmpeg -i input.mp4 -t 30 -c copy first30.mp4
# 파일 연결 (먼저 파일 목록 생성)
cat > filelist.txt << 'EOF'
file 'clip1.mp4'
file 'clip2.mp4'
file 'clip3.mp4'
EOF
ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4
# 재인코딩을 통한 연결 (코덱이 다른 경우)
ffmpeg -f concat -safe 0 -i filelist.txt -c:v libx264 -c:a aac output.mp4
5단계: 해상도 및 압축
# 1080p로 리사이즈 (가로세로비 유지)
ffmpeg -i input.mp4 -vf "scale=-2:1080" -c:v libx264 -crf 23 -c:a copy output.mp4
# 720p로 리사이즈
ffmpeg -i input.mp4 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a copy output.mp4
# 특정 너비로 리사이즈 (높이 자동)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4
# 공격적으로 압축 (더 작은 파일)
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 96k small.mp4
# 대상 파일 크기를 위한 2패스 인코딩
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 1 -an -f null /dev/null
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 2 -c:a aac -b:a 128k output.mp4
# 프레임레이트 변경
ffmpeg -i input.mp4 -r 30 output.mp4
6단계: 썸네일 및 스크린샷
# 타임스탬프에서 단일 스크린샷
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg
# 10초마다 스크린샷
ffmpeg -i input.mp4 -vf "fps=1/10" thumbs/frame_%04d.jpg
# 썸네일 그리드 (4x4 연락처 시트)
ffmpeg -i input.mp4 -vf "select='not(mod(n,300))',scale=320:-1,tile=4x4" -frames:v 1 grid.jpg
# 첫 번째 프레임 추출
ffmpeg -i input.mp4 -frames:v 1 first_frame.png
7단계: 자막
# 비디오에 자막 하드코딩 (하드 서브)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# 스타일이 적용된 ASS/SSA 자막
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4
# 자막 트랙 추가 (소프트 서브, 사용자 전환 가능)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
# 비디오에서 자막 추출
ffmpeg -i input.mkv -map 0:s:0 subs.srt
8단계: 필터 및 효과
# 비디오 세그먼트에서 GIF 생성
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos" output.gif
# 팔레트를 이용한 고품질 GIF
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png
ffmpeg -i input.mp4 -i palette.png -ss 5 -t 3 -lavfi "fps=15,scale=480:-1:flags=lanczos[v];[v][1:v]paletteuse" output.gif
# 워터마크 추가
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" output.mp4
# 속도 증가 / 감소
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" fast.mp4
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" slow.mp4
# 비디오 회전
ffmpeg -i input.mp4 -vf "transpose=1" rotated.mp4 # 90° 시계 방향
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4 # 90° 반시계 방향
# 비디오 자르기 (width:height:x:y)
ffmpeg -i input.mp4 -vf "crop=1280:720:0:180" cropped.mp4
# 페이드 인/아웃
ffmpeg -i input.mp4 -vf "fade=in:0:30,fade=out:870:30" -af "afade=in:0:30,afade=out:870:30" output.mp4
9단계: 미디어 정보
# 전체 미디어 정보
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4
# 지속 시간만
ffprobe -v quiet -show_entries format=duration -of csv=p=0 input.mp4
# 해상도
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4
# 코덱 정보
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 input.mp4
10단계: 배치 처리
# 모든 WebM 파일을 MP4로 변환
for f in *.webm; do
ffmpeg -i "$f" -c:v libx264 -crf 23 -c:a aac "${f%.webm}.mp4"
done
# 디렉터리 내 모든 MP4 파일 압축
for f in *.mp4; do
ffmpeg -i "$f" -c:v libx264 -crf 28 -preset fast -c:a aac "compressed_${f}"
done
# 모든 비디오에서 오디오 추출
for f in *.mp4; do
ffmpeg -i "$f" -vn -c:a libmp3lame -q:a 2 "${f%.mp4}.mp3"
done
예제
예제 1: yt-dlp 다운로드를 WebM에서 MP4로 변환
사용자 프롬프트: "yt-dlp로 비디오를 다운로드했는데 모두 .webm 파일이에요. iPhone에서 재생할 수 있게 MP4로 변환해 주세요."
에이전트는 다음을 수행합니다:
ffprobe를 사용하여 WebM 파일에 H.264+AAC가 포함되어 있는지(스트림 복사 가능) 또는 VP9+Opus(재인코딩 필요)인지 확인합니다.- VP9/Opus 파일의 경우 실행:
for f in *.webm; do ffmpeg -i "$f" -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart "${f%.webm}.mp4"; done -movflags +faststart플래그는 메타데이터를 파일의 시작 부분으로 이동시켜 모바일 장치 및 웹 브라우저에서 즉시 재생할 수 있게 합니다.- 변환 결과를 변환 전후 파일 크기와 함께 보고합니다.
예제 2: 여러 클립에서 하이라이트 릴 만들기
사용자 프롬프트: "컨퍼런스에서 찍은 5개의 비디오 클립이 있어요. 가장 좋은 부분을 잘라서 페이드 전환 효과와 함께 하나의 비디오로 합쳐 주세요."
에이전트는 다음을 수행합니다:
-ss및-to플래그로 각 클립을 지정된 타임스탬프에 맞게 자릅니다.- 모든 클립을 동일한 코덱/해상도로 재인코딩합니다:
ffmpeg -i clip.mp4 -c:v libx264 -crf 23 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:-1:-1,fade=in:0:15,fade=out:st=DURATION:d=0.5" -c:a aac -ar 44100 segment_N.mp4 - concat 파일 목록을 생성하고 병합합니다:
ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4
지침
- yt-dlp 다운로드(보통 WebM/VP9+Opus)를 변환할 때는 최대 장치 호환성을 위해 항상 H.264+AAC로 재인코딩하세요.
-c:v libx264 -crf 23 -c:a aac -movflags +faststart를 사용합니다. - 가능하면 재인코딩을 피하기 위해 스트림 복사(
-c copy)를 사용하세요. 즉시 처리되며 무손실입니다. 코덱을 변경하거나 필터를 적용하거나 소스와 대상 컨테이너가 호환되지 않을 때만 재인코딩하세요. - 웹 또는 모바일 재생을 위해 MP4 파일을 만들 때는 항상
-movflags +faststart를 추가하세요. moov 원자를 파일 시작 부분으로 이동시켜 즉시 스트리밍이 가능합니다. - 처리 전에
ffprobe를 사용하여 입력 포맷을 이해하고 불필요한 재인코딩을 피하세요. - 배치 작업 시에는 전체 디렉터리에서 실행하기 전에 먼저 단일 파일로 명령을 테스트하세요.
- 단일 패스 인코딩의 경우 비트레이트 모드보다 CRF 모드를 선호하세요. 다양한 콘텐츠 유형에서 일관된 품질을 제공합니다.