Aller au contenu principal

Compresser un GIF pour GitHub README et PR

Gardez vos captures de terminal et d’interface nettes dans vos README et PR GitHub, sous 10 Mo et 1 Mo pour l’aperçu social.

Mis à jour le:

Déposez des GIF ou choisissez des fichiers

Collez une URL d’image HTTPS

Préparer un GIF pour votre plateforme

Les limites des plateformes et les objectifs de compression recommandés sont distincts. Vérifiez la limite affichée dans votre compte avant l’envoi.

GitHub

GitHub distingue la limite des pièces jointes d’issues/PR de celle de l’aperçu social du dépôt.

  • Les images et GIF joints aux issues, pull requests et commentaires sont limités à 10 Mo.
  • L’image d’aperçu social du dépôt (PNG, JPG ou GIF) doit rester sous 1 Mo (1280×640 px recommandé).
  • Évitez de commiter de gros GIF dans l’historique Git : compressez à 1–2 Mo et hébergez-les via un glisser-déposer d’issue/PR.

Dernière vérification:

Comment utiliser cet outil

  1. Ajoutez votre GIF de démo avec la cible 2 Mo.
  2. Vérifiez la lisibilité du code après compression locale.
  3. Recadrez les marges inutiles plutôt que de rétrécir le texte.
  4. Glissez le GIF dans une issue/PR GitHub pour obtenir son lien hébergé.

Limites GitHub et bonnes pratiques README

Les pièces jointes d’issues/PR montent à 10 Mo et l’aperçu social reste sous 1 Mo (1280×640 px). Évitez de commiter de gros GIF qui ralentissent git clone.

1 — Pièce jointe issue/PR 10 Mo max, README 1–2 Mo · 2 — Aperçu social 1280×640 sous 1 Mo
1 — Pièce jointe issue/PR (10 Mo max ; 1–2 Mo conseillé) · 2 — Aperçu social (1280×640 px, <1 Mo)

Exemples mesurés

Exemples créés par nos soins et traités avec le même moteur de compression que cet outil. Les résultats dépendent de la source et ne constituent pas une promesse pour vos fichiers.

Données de mesure (JSON)
ObjectifOriginalTaille réelle
Objectif: 1000 KB1 141 589 Octets903 284 OctetsObjectif atteint
Tutoriel recadré et raccourci · Objectif: 1000 KB560 904 Octets531 027 OctetsObjectif atteint

Objectif: 1000 KB

Original · 1 141 589 Octets

Objectif: 1000 KB: Original

Résultat · 903 284 Octets

Objectif: 1000 KB: Résultat

Dimensions: 640 × 360px
Images: 40 · Durée: 4 secondes

Réglages appliqués: 256 Nombre maximal de couleurs · Niveau de compression avec perte 20

Examiner le détail

Original

Objectif: 1000 KB: Original

Résultat

Objectif: 1000 KB: Résultat

Tutoriel recadré et raccourci · Objectif: 1000 KB

Source recadrée et raccourcie · 560 904 Octets

Tutoriel recadré et raccourci · Objectif: 1000 KB: Source recadrée et raccourcie

Résultat · 531 027 Octets

Tutoriel recadré et raccourci · Objectif: 1000 KB: Résultat

Dimensions: 420 × 182px
Images: 20 · Durée: 2 secondes

Réglages appliqués: 256 Nombre maximal de couleurs · Niveau de compression avec perte 0

Source recadrée et raccourcie: 640 × 360px · 40 Images · 4 secondes → 420 × 182px · 20 Images · 2 secondes

Examiner le détail

Original

Tutoriel recadré et raccourci · Objectif: 1000 KB: Original

Résultat

Tutoriel recadré et raccourci · Objectif: 1000 KB: Résultat

Questions fréquentes

Quelle est la taille maximale d’un GIF sur GitHub ?

10 Mo pour les images et GIF joints aux issues, PR et commentaires.

Puis-je automatiser la compression dans GitHub Actions ?

Oui, grâce à notre API REST (500 crédits gratuits/mois) ou notre serveur MCP.