Quels sont les formats de fichiers compatibles avec Piwigo ? On vous explique tout !

Clients piwigo.com et auto-hébergement : les différences

Pour commencer, les choses sont légèrement différentes selon que vous ayez un compte sur piwigo.com ou que vous hébergiez vous-même votre Piwigo.

Fichiers images

Piwigo vous permet d'importer des fichiers images, qui sont lisibles dans un navigateur web. Les extensions de fichiers images supportés par Piwigo sont les suivants :

Tous ces formats sont reconnus par Piwigo, qui générera une vignette pour les images visibles dans l'administration de Piwigo ainsi que dans votre galerie.

Précisions sur le format .gif

Piwigo permet également d'importer des GIF animés (extension de fichier .gif). Si le fichier d’origine est plus grand que la taille des miniatures sur votre galerie (par défaut, 144x144) la galerie affichera uniquement une prévisualisation du fichier GIF, créée à partir de la première image composant l'animation. Il faudra afficher l’original pour “jouer” l’animation.

Précisions sur le format .webp

Depuis la version 14 de Piwigo, vous pouvez également importer des fichiers image au format webp.

Si vous hébergez vous-même votre Piwigo, vous pouvez l’ajouter via le plugin LocalFiles Editor, en ajoutant webp au niveau du paramètre $conf['picture_ext'] comme dans l’exemple ci-dessous.

$conf['picture_ext'] = array('jpg','jpeg','png','gif','webp');

<aside> 💡 WebP est le type le plus "supporté par les navigateurs web" pour remplacer le JPEG. WebP est supporté à l'import aussi bien qu'à l'affichage, et Piwigo va générer un fichier webp pour chaque taille affichée dans votre galerie. WebP peut remplacer le JPEG avec une meilleure qualité pour un poids équivalent, remplacer les GIF animés pour une fraction du poids et même remplacer les PNG avec une compression non destructive et de la transparence.

</aside>

<aside> ⚠️ Pour supporter les WebP animés, vous devrez peut-être mettre à jour le système d’exploitation de votre serveur si vous utilisez un Piwigo auto-hébergé.

</aside>

Cas particulier du format HEIC

HEIC est un format d’image supporté dans Piwigo depuis la version 14. C’est le format de fichier généré par défaut sur iOS, et sur certains téléphones Android.

Les fichiers HEIC ne sont pas affichables dans un navigateur web : Piwigo génère donc une prévisualisation du fichier.

Pour activer le support du format HEIC si vous hébergez vous-même votre Piwigo, vous devez l’ajouter via le plugin LocalFiles Editor.

Si ce n’est pas déjà le cas, vous devez d’abord activer le paramètre upload_form_all_types comme ci-dessous.

$conf['upload_form_all_types'] = true;

Ensuite, vous devez ajouter heic au niveau du paramètre $conf['file'] comme dans l’exemple ci-dessous.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('jpg','jpeg','png','gif','heic')
  );

<aside> ⚠️ Pour supporter les fichiers HEIC, vous devrez peut-être mettre à jour le système d’exploitation de votre serveur si vous utilisez un Piwigo auto-hébergé.

</aside>

Fichiers vidéo et audio

Piwigo permet d'importer des fichiers audiovisuels avec les extensions suivantes :

<aside> ℹ️ Si vous hébergez vous-même votre Piwigo, vous devez installer et activer le plugin VideoJS pour accepter ce type de fichier. Si vous êtes client d’une offre piwigo.com, ce plugin est activé par défaut.

</aside>

Lorsque vous importez un fichier vidéo dans Piwigo, une vignette de prévisualisation est créée à partir de la première image de votre vidéo. La vidéo est lisible depuis votre galerie, grâce au lecteur vidéo intégré à Piwigo. Vous pouvez lire la vidéo grâce au gros bouton de lecture.

Lorsque vous importez un fichier audio dans Piwigo, il sera représenté sur votre galerie par l'icône ci-dessous. Le fichier audio peut être écouté depuis votre galerie, grâce au lecteur intégré à Piwigo.

Pour activer le support des vidéos, si vous hébergez vous-même votre Piwigo, vous devez d’abord activer le paramètre upload_form_all_types comme ci-dessous (si ce n’est pas déjà fait) via le plugin LocalFiles Editor.

$conf['upload_form_all_types'] = true;

Vous devez ensuite ajouter les extensions souhaitées au niveau du paramètre $conf['file_ext'] comme dans l’exemple ci-dessous.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('mp4','webmv','m4v','webm')
  );

<aside> ⚠️ Si vous utilisez une galerie auto-hébergée et que vous rencontrez des problèmes avec le téléchargement de vidéos ou la génération de vignettes, consultez cet article.

</aside>

🎦 Cas particulier des vidéos MOV

Si vous enregistrez des vidéos depuis un iPhone, un iPad ou depuis le logiciel Quicktime pour Apple, les fichiers générés ont une extension .mov. Ce format de fichier n'est pas compatible avec Piwigo, car il ne s’affiche pas correctement dans les navigateurs web.

Mais il existe plusieurs moyens de les transférer quand même sur Piwigo.

Depuis l’application mobile Piwigo pour iOS

Depuis l'application mobile Piwigo pour iOS, vous allez pouvoir envoyer des vidéos MOV vers Piwigo. Les vidéos seront converties pendant le transfert en fichier .mp4. Elles seront donc lisibles depuis votre galerie, comme n'importe quelle autre vidéo.

Depuis l’administration Piwigo (vous hébergez Piwigo vous-même)

Si vous avez besoin de transférer des vidéos MOV depuis l'administration de Piwigo, c’est possible, mais par défaut, les vidéos ne sont pas visibles via le lecteur vidéo de votre galerie : il faudra les télécharger pour les visionner.

Pour que votre Piwigo accepte d’importer des fichiers .mov, vous devez modifier le paramètre $conf['file_ext'] et ajouter le format mov comme dans l’exemple ci-dessous avec LocalFiles Editor.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('mp4','webmv','m4v','webm','mov')
  );

Vous pouvez aussi faire le choix de convertir vos fichiers .mov au format MP4 avant de les importer dans Piwigo, ce qui a deux avantages :

Pour savoir comment convertir un fichier, lire le chapitre suivant.

Depuis l’administration Piwigo (clients piwigo.com uniquement)

Si vous êtes client d’une offre d’abonnement piwigo.com, vous pouvez demander au support la mise en place de la conversion automatique des fichiers .mov vers .mp4.

Si nous activons cette option, les fichiers .mov importés dans Piwigo depuis l’administration seront automatiquement convertis en .mp4. Au moment du téléchargement, l’utilisateur choisira si il souhaite télécharger la version .mov ou la version .mp4.

<aside> ⚠️ Attention ! Si vous choisissez d’activer cette option, cela utilise une place plus importante sur votre espace de stockage, car chaque vidéo est stockée en deux versions, et car les fichiers .mov sont très volumineux.

</aside>

Vous pouvez aussi faire le choix de convertir vos fichiers .mov au format MP4 avant de les importer dans Piwigo, ce qui a deux avantages :

Pour savoir comment convertir un fichier, lire le chapitre suivant.

🎦 Convertir vos fichiers vidéo

Si vous souhaitez importer un fichier vidéo non supporté par Piwigo (par exemple, un fichier AVI), il vous suffit de convertir vos fichiers vidéo vers le format MP4 : vous pouvez le faire avec de nombreux logiciels de montage vidéo, ou encore avec des outils gratuits en ligne comme celui-ci.

<aside> ℹ️ Nous conseillons le format de fichier MP4 avec un codec vidéo H.264 et audio AAC. Cela permet de conserver un haut degré de qualité même quand la vidéo est compressée. Les fichiers MP4 encodés de cette façon pèsent moins lourds : ainsi, ils consomment moins d'espace de stockage, et économisent de la bande passante. Enfin, cela garantit la compatibilité avec les lecteurs vidéo.

</aside>

⚙️ Configuration du plugin VideoJS

On l’a vu, c’est le plugin VideoJS qui permet de gérer les fichiers vidéo dans Piwigo. Ce plugin utilise le lecteur vidéo open source VideoJS.

La configuration du plugin VideoJS vous donne accès à un certain nombre d’options.

Vous trouverez une documentation détaillée du plugin VidéoJS sur sa page GitHub.

⭐️ Autres formats de fichiers

Ces formats de fichier sont réservé aux clients d’une offre Équipe, Entreprise ou VIP sur piwigo.com, et aux utilisateurs qui hébergent eux-même leur Piwigo.

Pour ce type de fichiers, Piwigo génère une prévisualisation qui les rend consultables dans l'administration et dans votre galerie.

Pour activer le support de ces fichiers, si vous hébergez vous-même votre Piwigo, vous devez d’abord activer le paramètre upload_form_all_types comme ci-dessous (si ce n’est pas déjà fait) via le plugin LocalFiles Editor.

$conf['upload_form_all_types'] = true;

Vous devez ensuite ajouter les extensions souhaitées au niveau du paramètre $conf['file_ext'] comme dans l’exemple ci-dessous.

$conf['file_ext'] = array_merge(
  $conf['picture_ext'],
  array('pdf','ai','psd','eps')
  );

<aside> ⚠️ Si vous utilisez une galerie auto-hébergée et que vous rencontrez des problèmes avec la génération de vignettes pour les fichiers PDF, ou la visualisation des fichiers AI, PSD, HEIC, TIF ou TIFF, consultez cet article.

</aside>

Cas particulier des fichiers PDF dans Piwigo

Pour les fichiers PDF, Piwigo génère un aperçu en extrayant la première page et en la convertissant en image. Cette image est affichée dans l'album.

Depuis Piwigo 15, sur la page du fichier, Piwigo embarque un lecteur PDF qui permet de lire le fichier.