Animated Image Conversion Guide
영상파일
→ WebP
→ WebP
FFmpeg 기반 애니메이션 WebP 변환 완전 가이드.
설치부터 오류 해결까지 단계별로 안내합니다.
설치부터 오류 해결까지 단계별로 안내합니다.
ES International · JW K
Tech Stack
ffmpeg-full
libwebp codec
macOS · Apple Silicon
Animated WebP
01 / 06
01
Installation
FFmpeg
풀 버전 설치
풀 버전 설치
기본 brew ffmpeg는 libwebp가 없을 수 있어요.
서드파티 tap을 추가해 webp 포함 풀버전을 설치합니다.
서드파티 tap을 추가해 webp 포함 풀버전을 설치합니다.
⚠ 주의
기존에 ffmpeg가 설치되어 있다면
brew uninstall ffmpeg 먼저 실행 필요
brew uninstall ffmpeg 먼저 실행 필요
Terminal
# 기존 ffmpeg 있으면 먼저 제거
$brew uninstall ffmpeg
# 확장 tap 추가
$brew tap homebrew-ffmpeg/ffmpeg
# webp 포함 풀버전 설치
$brew install homebrew-ffmpeg/ffmpeg/ffmpeg --with-webp
📦
homebrew-ffmpeg 서드파티 tap은 webp 등 추가 코덱을 포함한 확장 버전을 제공합니다.
🍎
Apple Silicon(M1/M2/M3) 기준 설치 경로 /opt/homebrew/
📁
cd ~/Downloads 이동 후 파일명만 입력해도 변환 가능
02 / 06
ES International · JW K
Command Anatomy
명령어 구조 설명
ffmpeg -i input.mp4
-c:v libwebp
-quality 90
-loop 0
-an
-vf "fps=24,scale=1280:-1" output.webp
-i input.mp4
Input File
변환할 원본 동영상 파일 경로
변환할 원본 동영상 파일 경로
-c:v libwebp
Video Codec
WebP 인코더. ffmpeg-full에만 포함
WebP 인코더. ffmpeg-full에만 포함
-quality 90
품질 설정
0~100. 높을수록 화질↑ 용량↑
0~100. 높을수록 화질↑ 용량↑
-loop 0
반복 설정
0 = 무한반복
1이상 = 지정 횟수
0 = 무한반복
1이상 = 지정 횟수
-an
Audio Remove
WebP 오디오 미지원
제거 필수
WebP 오디오 미지원
제거 필수
-vf "fps=24,scale=1280:-1"
Video Filter — fps: 초당 프레임 수 · scale: 가로크기, -1은 비율 자동 유지
output.webp
Output File — 저장될 파일명. 확장자 .webp 필수
03 / 06
ES International · JW K
Quality Comparison
화질 설정 비교 100 vs 90
100
최상 화질 버전
아카이브용
아카이브용
ffmpeg -i 1.mp4 \
-c:v libwebp -quality 100 \
-loop 0 -an \
-vf "fps=24,scale=1280:-1" 1.webp
+원본과 동일한 수준의 화질 보존
+세밀한 텍스처, 그라데이션 손실 없음
−파일 용량 매우 큼 — 웹 로딩 느림
−실제 서비스보다 원본 보관용에 적합
90
★ 실무 추천
웹 업로드
최적 설정
최적 설정
ffmpeg -i 1.mp4 \
-c:v libwebp -quality 90 \
-loop 0 -an \
-vf "fps=24,scale=1280:-1" 1-1.webp
+육안으로 100과 거의 차이 없음
+용량이 훨씬 작아 웹 로딩 속도 개선
+SNS, 쇼핑몰, 웹사이트 모든 업로드에 적합
·극단적 확대 시 미세한 차이 있을 수 있음
04 / 06
ES International · JW K
scale
해상도 설정
크기
조정 옵션
조정 옵션
scale=가로:-1 형식으로 입력.-1은 원본 비율을 자동으로 유지합니다.
1280:-1
가로 1280px · 세로 자동 (HD 기본)
1000:-1
★ 웹 최적화 · SNS / 쇼핑몰 추천
800:-1
모바일 최적화 · 가벼운 웹 콘텐츠
-1:-1
원본 크기 유지 (리사이징 없음)
fps
프레임 설정
프레임
속도 설정
속도 설정
fps=15
약간 끊김
용량 최소
약간 끊김
fps=20
선택
균형 잡힌
선택
fps=24
영화적 자연스러움
★ 추천
영화적 자연스러움
fps=30
용량 큼
원본 유지
용량 큼
💡 fps=24가 용량 효율과 시각적 부드러움을 동시에 잡는 황금 비율입니다.
05 / 06
ES International · JW K
Troubleshooting
PATH 오류 문제시
⛔ 오류 메시지
zsh: command not found: ffmpeg
원인: Apple Silicon Mac에서 Homebrew는
/opt/homebrew/에 설치되는데,
이 경로가 $PATH에 등록되지 않은 경우 발생합니다.
1
PATH를 .zshrc에 영구 등록
echo 'export PATH="/opt/homebrew/opt/ffmpeg-full/bin:$PATH"' >> ~/.zshrc
>> ~/.zshrc 반드시 포함 — 없으면 저장 안 됨
2
변경 사항 즉시 적용
source ~/.zshrc
터미널 재시작 없이 PATH 변경이 즉시 반영됩니다.
3
정상 설치 확인
ffmpeg -version # libwebp 포함 여부 확인
출력에 libwebp가 보이면 설치 완료
06 / 06
ES International · JW K
