본문으로 건너뛰기

GitHub README 및 PR용 GIF 압축

GitHub README와 Pull Request 데모 GIF를 선명하고 가볍게 최적화하세요. 10MB 첨부 한도와 1MB 소셜 미리보기 기준을 충족합니다.

업데이트:

GIF를 놓거나 파일 선택

HTTPS 이미지 URL 붙여넣기

플랫폼별 압축

제한은 변경되거나 계정별로 다를 수 있습니다. 플랫폼의 업로드 화면에 표시되는 안내도 확인하세요.

GitHub

GitHub는 이슈/PR 첨부 GIF와 저장소 소셜 미리보기 이미지에 서로 다른 한도를 둡니다.

  • 이슈, PR, 댓글에 첨부하는 이미지와 GIF 최대 용량은 10MB입니다.
  • 저장소 소셜 미리보기(PNG/JPG/GIF)는 1MB 미만(권장 1280×640px)이어야 합니다.
  • 대용량 GIF를 Git 기록에 직접 커밋하지 말고 1–2MB로 압축해 이슈/PR 업로드 링크로 README에 삽입하세요.

확인일:

GIF 압축 방법

  1. 2MB 프리셋으로 터미널 또는 UI 녹화 GIF를 불러오세요.
  2. 압축 후 코드와 버튼 텍스트가 선명한지 확인하세요.
  3. 글자가 흐리면 전체 축소 대신 불필요한 배경을 크롭하세요.
  4. 다운로드한 GIF를 GitHub 이슈/PR 창에 끌어다 놓아 링크를 얻으세요.

GitHub GIF 업로드 한도 및 README 모범 사례

이슈·PR·댓글 첨부 GIF는 최대 10MB, 저장소 소셜 미리보기는 1MB 미만(1280×640px 권장)입니다. 대용량 GIF를 직접 커밋하면 git clone이 느려지므로 외부 첨부 호스팅이나 CI API 자동화를 활용하세요.

1 — PR/이슈 첨부 최대 10MB, README 1~2MB 권장 · 2 — 소셜 미리보기 1280×640 1MB 미만
1 — 이슈/PR 첨부(최대 10MB, README는 1–2MB 권장) · 2 — 소셜 미리보기(1280×640px, 1MB 미만)

실측 압축 예시

이 도구와 같은 압축 엔진으로 처리한 자체 제작 예시입니다. 결과는 원본 내용에 따라 달라지며, 사용자의 파일에서 같은 결과를 보장하지 않습니다.

실측 데이터 (JSON)
목표원본실제 크기
목표: 1000 KB1,141,589 바이트903,284 바이트목표 충족
자르고 길이를 줄인 사용 안내 · 목표: 1000 KB560,904 바이트531,027 바이트목표 충족

목표: 1000 KB

원본 · 1,141,589 바이트

목표: 1000 KB: 원본

출력 · 903,284 바이트

목표: 1000 KB: 출력

이미지 크기: 640 × 360px
프레임 수: 40 · 재생 시간: 4 초

적용한 설정: 256 최대 색상 수 · 손실 압축 수준 20

세부 비교

원본

목표: 1000 KB: 원본

출력

목표: 1000 KB: 출력

자르고 길이를 줄인 사용 안내 · 목표: 1000 KB

편집한 원본 · 560,904 바이트

자르고 길이를 줄인 사용 안내 · 목표: 1000 KB: 편집한 원본

출력 · 531,027 바이트

자르고 길이를 줄인 사용 안내 · 목표: 1000 KB: 출력

이미지 크기: 420 × 182px
프레임 수: 20 · 재생 시간: 2 초

적용한 설정: 256 최대 색상 수 · 손실 압축 수준 0

편집한 원본: 640 × 360px · 40 프레임 수 · 4 초 → 420 × 182px · 20 프레임 수 · 2 초

세부 비교

원본

자르고 길이를 줄인 사용 안내 · 목표: 1000 KB: 원본

출력

자르고 길이를 줄인 사용 안내 · 목표: 1000 KB: 출력

자주 묻는 질문

GitHub 이슈와 PR 최대 GIF 크기는?

이미지 및 GIF 첨부는 최대 10MB까지 지원합니다.

GitHub Actions에서 자동 압축이 가능한가요?

네. 무료 월 500 크레딧 REST API 및 MCP 서버를 CI 워크플로에 연동할 수 있습니다.