용어 · 도구·코드

ffmpeg 필터 모음

FFmpeg Filters

ffmpeg 는 명령어로 영상을 다루는 도구다. -vf 뒤에 ‘필터=옵션’을 적으면 전환(xfade), 글자(drawtext), 확대(zoompan), 섞기(blend), 색 보정(curves) 같은 가공을 한 줄로 걸 수 있다.

고급설명장면 연결

01직접 돌려 보기

‘연출 전’은 대충 시켰을 때를 가정해 만든 화면이고 실제 AI 결과와 다를 수 있다.

연출 전흔한 첫 결과
연출 후완성본
0.00초 / 4.0초

02이름으로 시키는 지시문

대충 시킴영상을 멋있게 편집해줘→ 어떤 가공을 어떤 필터로 할지 빠져 있어서, 대개 다시 만들 수 없는 명령어가 돌아온다
이름으로 시킴ffmpeg 의 xfade 로 두 영상을 transition=fade, duration=2, offset=5 로 이어 붙이고, 마지막에 curves=preset=vintage 를 걸어줘→ xfade 2초 크로스 페이드(offset=5)로 이은 뒤 curves=preset=vintage 까지 걸린 ffmpeg 명령 한 줄
Claude Code · Codex에 그대로 붙여 넣기

ffmpeg 필터 10개가 같은 장면에 하는 일을 칸마다 보여주는 애니메이션을 만들어줘(실제 ffmpeg 출력이 아니라 효과를 흉내 낸 그림). 화면을 5칸 × 2줄 격자로 나누고, 칸 크기는 가로 118 × 세로 140. 칸 위쪽에 110×62 미리보기, 아래에 필터 이름(영문, 굵게), 문서에서 확인한 옵션 이름(노랗게), 한국어 두 줄 설명. 화면 맨 아래에 ‘ffmpeg -i in.mp4 -vf "필터=옵션" out.mp4’ 한 줄.

  • 같은 장면노을 하늘과 해, 산 두 겹(A). 두 번째 장면: 별과 달이 있는 밤하늘(B).
  • 합치기·그리기xfade(A에서 B로 부드럽게 전환, transition=fade), drawtext(가운데 ‘hello world’ 글자), blend(두 장면을 all_mode=difference 로 섞기), tblend(움직이는 공의 앞뒤 프레임을 all_mode=average 로 섞어 잔상).
  • 움직임·시간zoompan(장면이 1배에서 1.5배까지 중앙 확대), minterpolate(원본 프레임 둘 사이의 새 프레임을 mi_mode=dup → blend → mci 순서로 보여줌), perspective(위쪽 두 모서리를 안으로 모아 사다리꼴로).
  • 색·수식geq(r='X/W*r(X,Y)' 식으로 픽셀마다 계산), lut3d(file=grade.cube 로 색 입히기), curves(preset=vintage). 세 칸은 흰 세로선이 왼쪽에서 오른쪽으로 지나가며 왼쪽이 처리된 모습.
  • 타이밍xfade 전환 시간은 2초(0.4초에 시작). zoompan 은 최대 1.5배까지 확대하는 데 4.2초(0.4~4.6초). 모든 움직임은 inOutCubic 으로.
  • 단계1단계는 합치기·그리기 4개만, 2단계에 움직임·시간 3개, 3단계에 색·수식 3개를 더한다. 아직 나오지 않은 칸은 점선 칸에 ‘N단계에서’.
  • 연출 전열 칸 모두 필터 없이 같은 장면(A)만 보이고 옵션 자리에는 ‘(필터 없음)’.
  • 금지필터 이름이나 옵션 이름을 지어내는 것, 실제 ffmpeg 결과와 똑같다고 단정하는 것.

구현에 쓰이는 기술: ffmpeg -i in.mp4 -vf "필터=옵션" out.mp4 (한 입력), -filter_complex (입력 여러 개)xfade: 두 영상을 같은 해상도·프레임레이트로 맞춘 뒤 전환(transition=fade, duration, offset)zoompan · minterpolate · perspective: 확대·프레임 보간·원근 보정curves · lut3d · geq: 색 곡선, 3D LUT(.cube 등), 픽셀별 수식

03응용 팁

팁은 데모에서 값만 바꿔 같은 장면과 비교한 것이다. AI가 같은 결과를 내는지는 직접 해 봐야 안다.

1

확대가 너무 약하다

줌 효과가 밋밋해 보일 때

지시문에서
zoompan 은 최대 1.5배까지 확대
이렇게 바꾸세요
zoompan 은 최대 4배까지 확대
그러면
zoompan 칸의 장면이 끝에서 4배까지 확대되어 가운데의 해와 하늘만 크게 남고, 옵션 줄도 z=min(zoom+…,4) 로 바뀐다. 많이 확대할수록 원본 화소가 늘어나 화질이 거칠어 보일 수 있다.
확인
2

전환이 너무 느리다

두 영상이 섞여 있는 시간이 길어 답답할 때

지시문에서
xfade 전환 시간은 2초
이렇게 바꾸세요
xfade 전환 시간은 0.5초
그러면
1.4초에 xfade 칸이 이미 밤 장면으로 완전히 바뀌어 있고(기존에는 절반쯤 섞인 상태), 옵션 줄은 fade:duration=0.5 가 된다.
확인
3

전환이 너무 일찍 시작된다

화면이 열리자마자 전환이 시작돼 첫 장면을 볼 틈이 없을 때

지시문에서
0.4초에 시작
이렇게 바꾸세요
2.0초에 시작
그러면
2.4초에도 xfade 칸이 노을 장면에 가깝게 남아 있다(기존에는 이미 밤 장면으로 끝까지 바뀐 상태). 전환은 2.0초에 시작해 4.0초에 끝난다.
확인

04만드는 순서

각 단계의 버튼을 누르면 위의 데모가 그 단계까지의 모습으로 바뀝니다.

  1. 잇고 얹는 필터 4개

    ffmpeg 는 -vf 뒤에 ‘필터=옵션’을 적어 영상을 가공한다. xfade 는 두 영상을 지정한 시간(duration) 동안 부드럽게 전환하고, drawtext 는 글자를 그리며, blend 와 tblend 는 두 장면(또는 앞뒤 프레임)을 섞는다. 필터를 걸지 않은 장면과 견주어 보면 차이가 보인다.

    ffmpeg -i first.mp4 -i second.mp4 -filter_complex xfade=transition=fade:duration=2:offset=5 output.mp4
    drawtext=fontsize=30:text='hello world':x=(w-text_w)/2:y=(h-text_h)/2
  2. 움직임과 시간 필터

    zoompan 은 사진 한 장을 천천히 확대한다. minterpolate 는 원본 프레임 사이에 새 프레임을 끼워 프레임레이트를 높이고(dup, blend, mci 세 방식), perspective 는 네 모서리를 옮겨 기울어진 영상을 바로잡는다.

    zoompan=z='min(zoom+0.0015,1.5)':d=700:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
    minterpolate=fps=60:mi_mode=mci
  3. 색과 수식으로 픽셀 바꾸기

    geq 는 픽셀마다 수식을, lut3d 는 .cube 같은 3D LUT 파일을, curves 는 곡선(preset=vintage 같은 프리셋 포함)을 적용한다. 셋 다 색을 바꾸는 일이라 흰 선이 지나가며 전과 후를 비교해 보인다.

    geq=r='X/W*r(X,Y)':g='(1-X/W)*g(X,Y)':b='(H-Y)/H*b(X,Y)'
    lut3d=file=grade.cube
    curves=preset=vintage

05전문용어 풀이

필터Filter

ffmpeg 에서 영상과 소리를 가공하는 단위로, -vf 뒤에 ‘이름=옵션’으로 적고 쉼표로 이어 붙인다.

AI에게“-vf 로 zoompan 필터를 걸어줘”
필터그래프Filtergraph

필터를 이어 놓은 가공 경로. 입력이 여럿이면 -filter_complex 를 쓴다.

AI에게두 영상을 xfade 로 잇는 filter_complex
프레임 보간Frame interpolation

원본 프레임 사이에 새 프레임을 만들어 움직임을 매끄럽게 하는 일이며 minterpolate 가 맡는다.

AI에게“minterpolate 로 60fps 로 늘려줘”
LUTLookup table

입력 색을 출력 색으로 바꾸는 색 변환표. lut3d 가 .cube 같은 파일로 적용한다.

AI에게grade.cube 를 lut3d 로 입히기

06결과를 받으면 이것부터 확인

  • 연출 전에는 열 칸 모두 같은 노을 장면이고 옵션 자리에 ‘(필터 없음)’이 적혀 있다
  • 1단계에서 xfade 칸의 노을이 0.4초부터 2초에 걸쳐 밤 장면으로 바뀌고, blend 칸은 두 장면이 겹쳐 색이 뒤섞인다
  • 2단계: zoompan 칸이 1배에서 1.5배로 확대되고, minterpolate 칸 가운데 프레임이 dup → blend → mci 로 바뀌며, perspective 칸의 위쪽이 좁아지는가?
  • 3단계에서 geq, lut3d, curves 칸의 흰 세로선이 왼쪽에서 오른쪽으로 지나가고 선 왼쪽의 색이 달라진다
  • 칸마다 필터 이름 아래에 문서에서 확인한 옵션 이름(duration, text, all_mode, mi_mode, preset 등)이 적혀 있다

07이럴 때 쓰세요

  • 편집 프로그램 없이 두 영상을 부드럽게 이어 붙이고 글자를 얹는 일
  • 사진 한 장을 천천히 확대하는 줌 효과를 명령어로 만들 때
  • AI에게 영상 가공 명령어를 시킬 때 어떤 필터 이름을 말할지 알아 두기
  • 촬영 영상에 색 입히기(LUT)나 곡선 보정을 한 번에 걸어야 하는 상황

08같이 쓰는 용어

09근거와 확인 범위

‘확인’은 출처 문서에서 사실로 확인한 내용, ‘추정’은 결과물을 보고 추론한 내용, ‘원본 없음’은 흔히 쓰이지만 대표 원본 사례를 확인하지 못해 성공 사례로 제시하지 않은 기법이다.

  • 확인xfade 는 한 입력 영상에서 다른 입력 영상으로 크로스 페이드를 지정한 시간 동안 적용한다. 두 입력은 프레임레이트가 일정해야 하고 해상도, 픽셀 포맷, 프레임레이트, 타임베이스가 같아야 한다. transition 값에는 fade, wipeleft, slideleft, circlecrop, fadeblack, radial 등이 있으며 예시 명령은 ffmpeg -i first.mp4 -i second.mp4 -filter_complex xfade=transition=fade:duration=2:offset=5 output.mp4. FFmpeg Filters Documentation — xfade
  • 확인drawtext 는 libfreetype 로 영상 위에 글자를 그린다(빌드에 libfreetype, harfbuzz 가 필요). 예시 drawtext="fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=(w-text_w)/2:y=(h-text_h)/2" 는 글자를 화면 가운데에 둔다. box=1:boxcolor=red@0.2 로 글자 뒤 상자도 둘 수 있다. FFmpeg Filters Documentation — drawtext
  • 확인blend 는 두 영상 프레임을 섞는다(첫 입력이 위, 둘째가 아래 층). all_mode 에는 addition, average, burn, darken, difference, divide, dodge, exclusion 등이 있다. tblend 는 한 영상의 연속한 두 프레임을 새 프레임이 옛 프레임 위에 오도록 섞고, 예시는 tblend=all_mode=grainextract. FFmpeg Filters Documentation — blend · tblend
  • 확인zoompan 이 줌·팬 효과를 준다. zoom(z)은 범위 1~10(기본 1), x 와 y 는 위치 식, d 는 한 입력 이미지에 효과가 지속될 프레임 수(기본 90), s 는 출력 크기(기본 hd720), fps 기본 25. 예시 zoompan=z='min(zoom+0.0015,1.5)':d=700:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)' 는 1.5배까지 중앙을 확대한다. FFmpeg Filters Documentation — zoompan
  • 확인minterpolate 는 움직임 보간으로 지정한 프레임레이트(fps, 기본 60)로 바꾼다. mi_mode 는 dup(앞이나 뒤 프레임을 복제), blend(앞뒤 프레임의 평균), mci(움직임 보상 보간). FFmpeg Filters Documentation — minterpolate
  • 확인perspective 는 화면과 수직이 아니게 찍은 영상의 원근을 바로잡는다. x0:y0:x1:y1:x2:y2:x3:y3 는 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래 모서리 좌표이고 기본값 0:0:W:0:0:H:W:H 는 영상을 바꾸지 않는다. FFmpeg Filters Documentation — perspective
  • 확인geq 는 모든 픽셀에 일반 수식을 적용하며(lum_expr, cb_expr, cr_expr 또는 r, g, b) 예시는 geq=r='X/W*r(X,Y)':g='(1-X/W)*g(X,Y)':b='(H-Y)/H*b(X,Y)'. lut3d 는 3D LUT 를 적용하고 3dl(AfterEffects), cube(Iridas), dat(DaVinci), m3d(Pandora), csp(cineSpace) 형식을 지원한다. FFmpeg Filters Documentation — geq · lut3d
  • 확인curves: 포토샵이나 GIMP 의 곡선 도구와 비슷하게 R, G, B 마다 key point 를 부드러운 곡선으로 이어 색을 조정한다(기본은 (0;0)과 (1;1)을 잇는 직선). 예시 curves=blue='0/0 0.5/0.58 1/1', curves=preset=vintage. FFmpeg Filters Documentation — curves
  • 확인-vf 는 -filter:v 의 별칭으로 입력과 출력이 하나인 필터그래프를 만들고, -filter_complex 는 입력이나 출력이 여러 개인 필터그래프에 쓴다. 쉼표가 필터를 잇고 세미콜론이 체인을 나눈다. FFmpeg 는 스스로를 ‘디코딩·인코딩·변환·스트리밍·필터링·재생을 하는 멀티미디어 프레임워크’라고 소개한다. FFmpeg Documentation — ffmpeg · About