FFmpeg
조회 및 검사
# 모든 스트림 정보 표시 (코덱, 해상도, 비트레이트, 길이)
ffprobe -v error -show_format -show_streams input.mp4
# 한 줄 요약: 길이, 크기, 비트레이트
ffprobe -v error -show_entries format=duration,size,bit_rate -of default=noprint_wrappers=1 input.mp4
# 비디오 해상도 및 프레임레이트 표시
ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,codec_name -of csv=p=0 input.mp4
# 지원되는 모든 코덱 목록
ffmpeg -codecs
# 지원되는 모든 포맷 목록
ffmpeg -formats
# 사용 가능한 인코더 목록
ffmpeg -encoders
포맷 변환
# MP4를 MKV로 (스트림 복사, 재인코딩 없음 -- 빠름)
ffmpeg -i input.mp4 -c copy output.mkv
# MKV를 MP4로 (컨테이너와 호환되지 않는 코덱이면 재인코딩)
ffmpeg -i input.mkv -c:v libx264 -c:a aac output.mp4
# AVI를 MP4로
ffmpeg -i input.avi -c:v libx264 -c:a aac output.mp4
# MOV를 MP4로 (iPhone 동영상에 흔함)
ffmpeg -i input.mov -c:v libx264 -c:a aac -movflags +faststart output.mp4
# MP4를 WebM으로 (VP9 + Opus, 웹용)
ffmpeg -i input.mp4 -c:v libvpx-vp9 -crf 30 -b:v 0 -c:a libopus output.webm
# 모든 포맷, 대상 컨테이너에 맞게 FFmpeg가 코덱 선택
ffmpeg -i input.avi output.mp4
비디오 압축
# CRF 모드 (일정 품질). 낮은 CRF = 더 나은 품질, 더 큰 파일.
# CRF 18 = 시각적 무손실, 23 = 기본값, 28 = 더 작지만 눈에 띄는 손실.
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4
# 더 빠른 인코딩, 더 큰 파일
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset fast -c:a copy output.mp4
# 더 느린 인코딩, 더 작은 파일 (보관용)
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset slow -c:a aac output.mp4
# H.265, 동일 품질에서 약 50% 더 작은 파일 (인코딩은 느림)
ffmpeg -i input.mp4 -c:v libx265 -crf 28 -preset medium -c:a aac output.mp4
# 특정 파일 크기 목표 (예: 60초 동영상을 25MB로)
# 비트레이트 계산: (25 * 8192) / 60 = ~3413 kbps 총합. 오디오 약 128k 감안.
ffmpeg -i input.mp4 -c:v libx264 -b:v 3285k -pass 1 -an -f null /dev/null && \
ffmpeg -i input.mp4 -c:v libx264 -b:v 3285k -pass 2 -c:a aac -b:a 128k output.mp4
오디오 추출
# MP3로 오디오 추출
ffmpeg -i input.mp4 -vn -c:a libmp3lame -q:a 2 output.mp3
# AAC로 오디오 추출 (이미 AAC면 복사)
ffmpeg -i input.mp4 -vn -c:a copy output.aac
# WAV로 오디오 추출 (무압축)
ffmpeg -i input.mp4 -vn -c:a pcm_s16le output.wav
# FLAC으로 오디오 추출 (무손실)
ffmpeg -i input.mp4 -vn -c:a flac output.flac
오디오 포맷 변환
# WAV를 MP3로 (VBR 품질 2, 약 190 kbps)
ffmpeg -i input.wav -c:a libmp3lame -q:a 2 output.mp3
# MP3를 AAC로
ffmpeg -i input.mp3 -c:a aac -b:a 192k output.m4a
# FLAC을 MP3로
ffmpeg -i input.flac -c:a libmp3lame -q:a 0 output.mp3
# WAV를 OGG Vorbis로
ffmpeg -i input.wav -c:a libvorbis -q:a 5 output.ogg
# WAV를 Opus로 (최고의 품질 대비 크기 비율)
ffmpeg -i input.wav -c:a libopus -b:a 128k output.opus
# 모든 오디오를 WAV로 (편집 또는 호환성 목적)
ffmpeg -i input.mp3 -c:a pcm_s16le -ar 44100 output.wav
자르기 및 컷
# 00:01:30부터 00:03:00까지 재인코딩 없이 자르기 (빠름, 키프레임 문제 가능)
ffmpeg -ss 00:01:30 -to 00:03:00 -i input.mp4 -c copy output.mp4
# 재인코딩하여 자르기 (프레임 정확)
ffmpeg -ss 00:01:30 -to 00:03:00 -i input.mp4 -c:v libx264 -c:a aac output.mp4
# 처음 30초 자르기
ffmpeg -ss 0 -t 30 -i input.mp4 -c copy output.mp4
# 마지막 30초 자르기 (길이를 알아야 하거나 음수 시작 사용)
ffmpeg -sseof -30 -i input.mp4 -c copy output.mp4
# 처음 10초 제거
ffmpeg -ss 10 -i input.mp4 -c copy output.mp4
GIF 생성
# 기본 GIF (낮은 품질, 단순)
ffmpeg -i input.mp4 -vf "fps=10,scale=480:-1" output.gif
# 팔레트 생성으로 고품질 GIF (2패스)
ffmpeg -i input.mp4 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png && \
ffmpeg -i input.mp4 -i palette.png -lavfi "fps=15,scale=480:-1:flags=lanczos [x]; [x][1:v] paletteuse" output.gif
# 특정 구간에서 GIF (00:00:30부터 5초)
ffmpeg -ss 00:00:30 -t 5 -i input.mp4 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png && \
ffmpeg -ss 00:00:30 -t 5 -i input.mp4 -i palette.png -lavfi "fps=15,scale=480:-1:flags=lanczos [x]; [x][1:v] paletteuse" output.gif
크기 조절
# 1280x720으로 크기 조절
ffmpeg -i input.mp4 -vf "scale=1280:720" -c:a copy output.mp4
# 너비를 1280으로, 종횡비 유지 (-1은 자동 계산, -2는 짝수 보장)
ffmpeg -i input.mp4 -vf "scale=1280:-2" -c:a copy output.mp4
# 원본 크기의 50%로 축소
ffmpeg -i input.mp4 -vf "scale=iw/2:ih/2" -c:a copy output.mp4
# 1920x1080 이내로 맞추면서 종횡비 유지 (업스케일 없음)
ffmpeg -i input.mp4 -vf "scale='min(1920,iw)':'min(1080,ih)':force_original_aspect_ratio=decrease" -c:a copy output.mp4
자막
# 하드코딩 자막 (비디오에 굽기, 항상 표시)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4
# 사용자 정의 스타일로 하드코딩
ffmpeg -i input.mp4 -vf "subtitles=subs.srt:force_style='FontSize=24,PrimaryColour=&HFFFFFF'" output.mp4
# 소프트 자막 (사용자가 켜고 끌 수 있음, MP4)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
# 소프트 자막 (MKV, ASS 등 더 많은 포맷 지원)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s srt output.mkv
# 비디오에서 자막 추출
ffmpeg -i input.mkv -map 0:s:0 output.srt
병합 및 연결
# 동영상 연결 (동일 코덱, 해상도, 프레임레이트)
# 먼저 파일 목록을 생성:
# file 'part1.mp4'
# file 'part2.mp4'
# file 'part3.mp4'
ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4
# 셸에서 파일 목록 생성
for f in part*.mp4; do echo "file '$f'"; done > filelist.txt
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
# 별도 파일의 비디오와 오디오 결합
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -shortest output.mp4
# 동영상의 오디오 트랙 교체
ffmpeg -i video.mp4 -i newaudio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4
프레임 추출
# 특정 시간에 한 프레임 추출
ffmpeg -ss 00:01:30 -i input.mp4 -frames:v 1 frame.png
# 1초마다 한 프레임 추출
ffmpeg -i input.mp4 -vf "fps=1" frames_%04d.png
# 10초마다 한 프레임 추출
ffmpeg -i input.mp4 -vf "fps=1/10" frames_%04d.png
# 모든 프레임 추출 (주의: 많은 파일 생성)
ffmpeg -i input.mp4 frames_%06d.png
# 썸네일 시트 생성 (4x4 격자)
ffmpeg -i input.mp4 -vf "select='not(mod(n\,100))',scale=320:180,tile=4x4" -frames:v 1 thumbnails.png
화면 녹화
# macOS - 전체 화면 녹화
ffmpeg -f avfoundation -framerate 30 -i "1:0" -c:v libx264 -preset ultrafast -crf 18 output.mp4
# macOS - 사용 가능한 장치 목록
ffmpeg -f avfoundation -list_devices true -i ""
# macOS - 오디오와 함께 화면 녹화
ffmpeg -f avfoundation -framerate 30 -i "1:0" -c:v libx264 -preset ultrafast -c:a aac output.mp4
# Linux (X11) - 전체 화면 녹화
ffmpeg -f x11grab -framerate 30 -video_size 1920x1080 -i :0.0 -c:v libx264 -preset ultrafast -crf 18 output.mp4
# Linux (X11) - 영역 녹화 (오프셋 x=100,y=200, 크기 1280x720)
ffmpeg -f x11grab -framerate 30 -video_size 1280x720 -i :0.0+100,200 -c:v libx264 -preset ultrafast output.mp4
# Linux (PipeWire/Wayland) - pipewire 화면 캡처 사용
# Wayland는 x11grab을 지원하지 않습니다. pw-record 또는 OBS + pipewire를 사용하세요.
속도 조절
# 비디오 2배속 (오디오 제거)
ffmpeg -i input.mp4 -vf "setpts=0.5*PTS" -an output.mp4
# 비디오 2배속 및 오디오 2배속
ffmpeg -i input.mp4 -vf "setpts=0.5*PTS" -af "atempo=2.0" output.mp4
# 비디오 0.5배속 (슬로우) 및 오디오
ffmpeg -i input.mp4 -vf "setpts=2.0*PTS" -af "atempo=0.5" output.mp4
# 4배속 (atempo 필터 체인, 각 atempo는 0.5-2.0 범위 지원)
ffmpeg -i input.mp4 -vf "setpts=0.25*PTS" -af "atempo=2.0,atempo=2.0" output.mp4
오디오 제거
# 오디오 트랙 제거, 비디오는 그대로 유지
ffmpeg -i input.mp4 -an -c:v copy output.mp4
코덱 참조
| 코덱 | 사용 사례 | 인코딩 플래그 | 비고 |
|---|---|---|---|
| H.264 | 범용, 가장 넓은 호환성 | -c:v libx264 | 기본 선택. 어디서나 작동. |
| H.265 | 보관, 스트리밍, 4K 콘텐츠 | -c:v libx265 | H.264보다 약 50% 작음. 인코딩 느림. |
| VP9 | 웹 전송, YouTube 스타일 호스팅 | -c:v libvpx-vp9 | 로열티 프리. 브라우저 지원 좋음. |
| AV1 | 차세대 웹/스트리밍 (등장 중) | -c:v libaom-av1 | 최고 압축률. 인코딩 매우 느림. |
| AAC | MP4 컨테이너의 오디오 | -c:a aac | 좋은 품질, 보편적 지원. |
| Opus | 저비트레이트 음성, 음악, 스트리밍 | -c:a libopus | 비트당 최고 품질. WebM/OGG 컨테이너. |
| MP3 | 레거시 오디오 호환성 | -c:a libmp3lame | AAC/Opus가 허용되지 않을 때 사용. |
빠른 결정 가이드:
- 웹에 공유하거나 광범위한 재생이 필요하신가요? H.264 + AAC in MP4.
- 더 작은 파일이 필요하고 인코딩 시간을 더 기다릴 수 있나요? H.265.
- 특별히 브라우저를 대상으로 하나요? VP9 + Opus in WebM.
- 보관 및 저장 공간이 걱정되나요? H.265 or AV1.
유용한 플래그
-y 확인 없이 출력 파일 덮어쓰기
-n 출력 파일을 절대 덮어쓰지 않음
-hide_banner FFmpeg 빌드 정보 표시 안 함
-v error 오류만 표시 (출력 간소화)
-movflags +faststart MP4 메타데이터를 파일 앞부분으로 이동 (스트리밍에 더 좋음)
-map 0 입력의 모든 스트림 복사
-shortest 가장 짧은 스트림이 끝나면 인코딩 중지
-threads 0 사용 가능한 모든 CPU 스레드 사용