Par Lucas, fondateur de FixMyVideos · Mis à jour le

Impossible de décoder du H.265 / HEVC sur Mac : trouver la vraie cause

Quand QuickTime refuse d'ouvrir un fichier HEVC, ou l'ouvre sur une image noire, on vous conseille en général d'accuser le codec et de tout réencoder. Parfois c'est le bon réflexe. Mais sur plusieurs fichiers que nous avons disséqués, les données HEVC étaient intactes : le problème se trouvait dans les quelques octets qui expliquent au lecteur d'Apple comment les lire. Ces cas-là se règlent vite, parfois avec une seule commande ffmpeg.

Un piège à connaître avant de commencer : ffmpeg, VLC et les autres outils bâtis sur ffmpeg lisent plusieurs formes de HEVC abîmé sans broncher, alors que le décodeur d'Apple les rejette. « Ça marche dans VLC » prouve donc moins qu'on ne le croit. Voici les causes que nous avons réellement rencontrées, dans l'ordre où il vaut mieux les écarter.

D'abord, inspectez le fichier

Lancez cette commande (ffmpeg s'installe avec Homebrew si besoin) :

ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,codec_tag_string,profile,pix_fmt -of default=nw=1 votrefichier.mov

Vous obtenez quatre lignes. codec_name doit indiquer hevc. Celles qui comptent vraiment ici sont codec_tag_string et profile.

Si ffprobe affiche plutôt moov atom not found ou Invalid data found when processing input, inutile d'aller plus loin sur cette page. L'index du fichier manque ou est endommagé, et c'est un autre problème, traité dans moov atom not found.

Cause 1 : la piste est étiquetée hev1 au lieu de hvc1

Un MP4 ou un MOV désigne sa piste HEVC par l'un de deux codes de quatre lettres. hvc1 signifie que les réglages du décodeur sont rangés dans l'en-tête du fichier, hev1 qu'ils peuvent être répétés dans le flux lui-même. Les deux sont conformes à la norme. QuickTime, iOS et Safari n'acceptent que hvc1.

Le hic, c'est que ffmpeg écrit hev1 par défaut lorsqu'il assemble du HEVC. N'importe quel outil construit sur ffmpeg peut donc vous rendre un fichier hev1, et toutes les vérifications basées sur ffmpeg le jugeront en parfait état, puisque ffmpeg lit les deux. C'est précisément pour cela que nous imposons hvc1 sur chaque fichier HEVC que nous livrons.

Si votre codec_tag_string affiche hev1, cette commande règle généralement le problème sans aucune perte de qualité, car elle ne touche qu'à l'étiquette :

ffmpeg -i votrefichier.mp4 -c copy -tag:v hvc1 corrige.mp4

Cause 2 : le profil n'est pas pris en charge par votre Mac

Si l'étiquette est déjà hvc1, regardez profile et pix_fmt. macOS décode le HEVC depuis High Sierra (10.13), mais les profils acceptés dépendent du matériel et de la version du système. Les profils Main (8 bits) et Main 10 (10 bits) sont les plus sûrs. Les modes professionnels comme le 4:2:2 10 bits (un pix_fmt qui se termine par 422p10le) ne passent pas sur tous les Mac.

Pour obtenir un fichier lisible partout, réencodez-le en H.264 :

ffmpeg -i votrefichier.mov -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy lisible.mov

Le résultat est plus lourd et perd la couleur 10 bits, alors gardez l'original. Si un Mac plus récent ou un macOS à jour l'ouvre, c'est qu'il n'avait rien.

Cause 3 : les images défilent dans le désordre (« ça tremble »)

On confond facilement ce cas avec un souci de décodeur. Le fichier s'ouvre, mais le mouvement saccade d'avant en arrière, comme si les images étaient inversées deux par deux.

Le HEVC des téléphones et des caméras utilise des images B, stockées dans un ordre et affichées dans un autre. Le conteneur porte une table (ctts, les décalages de composition) qui indique au lecteur quand montrer chaque image. Si un outil de réparation a reconstruit le fichier à partir du flux brut sans écrire cette table, ou en l'écrivant mal, le lecteur affiche les images dans l'ordre de stockage. ffmpeg, lui, les remet en ordre en interne grâce au compteur d'ordre d'affichage présent dans chaque slice : tout contrôle fondé sur son décodeur laisse passer le fichier.

Nous sommes tombés dessus avec trois enregistrements HEVC 4:2:2 sortis d'un logiciel de récupération de carte. En lisant les fichiers réparés sur un Mac, notre fondateur a vu l'image trembler, alors que tous nos contrôles étaient au vert. Comparé à une copie saine du même clip, 142 images sur 610 partageaient le même horodatage d'affichage et 158 intervalles duraient le double. Notre reconstructeur de timing n'avait pas d'analyseur de slices HEVC : il se rabattait sur le filtre dts2pts de ffmpeg, et c'est lui qui a produit les collisions. L'écriture de cet analyseur cachait elle aussi un piège. En HEVC, slice_type vient après l'identifiant du jeu de paramètres, et deux champs placés avant le compteur d'ordre dépendent du PPS. Une première version qui les sautait lisait donc ce compteur avec un bit de retard et obtenait de petites valeurs plausibles, mais fausses. Avec l'analyseur terminé, le timing de ce clip (base de temps, durée de chaque échantillon, histogramme ctts) est ressorti identique à celui du jumeau, et les 610 images identiques à l'octet près.

Il n'existe pas de correctif fiable en une ligne pour ce cas. ffmpeg propose bien un filtre dts2pts prévu pour cela, mais sur les fichiers ci-dessus, c'est justement lui qui a produit les collisions. Si votre vidéo tremble sur Mac alors que ffmpeg la décode sans erreur, la table de timing doit être reconstruite à partir des en-têtes de slice.

Cause 4 : des images de référence manquent

Chaque image P ou B s'appuie sur des images précédentes. Si une réparation ou une extraction en a perdu, le flux reste lisible au sens strict : ffmpeg bouche les trous avec le contenu voisin sans afficher le moindre message. VideoToolbox, le décodeur d'Apple, refuse le fichier en bloc, et QuickTime annonce qu'il ne peut pas le décoder.

Nous l'avons appris à nos dépens, deux fois. Sur un plan fixe au trépied, de vraies images de référence pesaient moins de 1 Ko, et un filtre de taille dans notre propre extracteur les jetait comme du bruit. La seconde fois, il s'agissait d'un enregistrement de DJI Osmo Pocket 3 arrivé sans son index. Notre réparation se décodait « proprement » dans ffmpeg, mais l'image paraissait délavée, avec une couture au milieu, et le Mac refusait de la lire. Une dominante verte s'y ajoutait, en partie à cause d'un profil de décodage emprunté à une autre caméra DJI. Pour mesurer le problème, nous avons coupé un clip Pocket 3 sain à 250 Mo et l'avons passé dans le moteur : l'extracteur avait perdu 216 images sur 722. Après correction, les 722 sont revenues identiques à l'octet près à l'original, avec un son calé à 0,0 ms.

Un cas voisin concerne la vidéo HDR de l'iPhone. Quand la vidéo HDR est activée, l'iPhone ajoute à chaque image une unité de métadonnées Dolby Vision (NAL de type 62). Notre extracteur rejetait ce type, ce qui lui faisait perdre 426 octets par image sur un fichier de test d'iPhone 13 Pro. Avant la correction, l'extraction trouvait 294 images sur 314, dont aucune complète. En acceptant toute la plage réservée aux fabricants, elle les a retrouvées toutes les 314, identiques à l'octet près.

Ce que vous pouvez faire vous-même : si ffmpeg ou VLC lit le fichier et que QuickTime le refuse, un réencodage complet avec la commande H.264 ci-dessus donne en général un fichier que le Mac accepte, puisque l'encodeur écrit un flux neuf et complet. Ce que ffmpeg a masqué restera visible sous forme de bavures. Si ces images comptent pour vous, il faut retrouver les images manquantes dans les octets d'origine.

Cause 5 : une partie de l'image est vert vif

Une image d'un vert saturé sous une certaine ligne n'est pas un problème de couleur. Quand ce sont les données d'une image elle-même qui se cassent, le décodeur HEVC de ffmpeg, contrairement à son décodeur H.264, ne camoufle rien : il arrête d'écrire et laisse le reste à zéro. Or un zéro sur les trois canaux YUV s'affiche en vert saturé. Toutes les images qui dépendent de cette image clé héritent du défaut jusqu'à la suivante.

Sur un MOV HEVC de 552 Mo issu d'un logiciel de récupération, 55,4 % de la première image clé n'avaient jamais été écrits, et l'image était verte de l'horizon jusqu'en bas pendant tout ce groupe d'images. Le journal de ffmpeg ne montrait qu'une erreur d'analyse, sans aucun avertissement de masquage. Nous mesurons désormais directement les pixels décodés (la part de l'image où Y, U et V valent exactement zéro) plutôt que de croire le journal, et l'aperçu démarre sur la première image clé qui se décode proprement, celle de l'image 30 sur ce fichier.

Si le vert n'apparaît qu'au début puis disparaît, les dégâts sont localisés et le reste de l'enregistrement est probablement intact.

Quand personne ne pourra le décoder

Certains fichiers ne peuvent être sauvés par aucun lecteur ni aucun service, et nous préférons vous le dire plutôt que de vous faire attendre un aperçu impossible. En voici trois que nous avons rencontrées :

  • Que des zéros. Le fichier a sa taille normale, mais chaque octet vaut 0x00. Il ne contient aucune donnée vidéo.
  • L'en-tête seul. Nous avons reçu un fichier de 24 octets qui n'était qu'une boîte ftyp isolée, sans rien derrière.
  • Un bloc répété. Un fichier de 20 Mo qui ne contenait que 12 288 octets de données distinctes : les mêmes quelques secteurs répétés en boucle. Un maillon de la lecture a lâché (carte, lecteur, câble ou adaptateur USB), et le fichier seul ne dit pas lequel.

Les deux premiers cas se vérifient facilement : xxd votrefichier.mov | head n'affiche que des zéros, ou le fichier pèse quelques kilo-octets là où il devrait peser des gigaoctets. Si le fichier réduit à son en-tête sort d'un logiciel de récupération, regardez d'abord les autres fichiers, plus gros, issus de la même analyse : la vidéo se trouve souvent dans l'un d'eux. Sinon, la seule vraie solution est de recopier le fichier depuis la carte ou le téléphone d'origine, de préférence avec un autre lecteur.

Ce que nous faisons d'un fichier HEVC endommagé

Une fois le fichier envoyé, le moteur le lit octet par octet. Il parcourt les unités HEVC et reconstruit l'index et le timing manquants à partir des en-têtes de slice. Chaque fichier HEVC que nous livrons est étiqueté hvc1, le timing est reconstruit à partir des en-têtes de slice quand le flux en a besoin, et l'aperçu démarre sur une image clé dont les pixels décodés ont été vérifiés (pas de zone verte non écrite). Dans les cas décrits plus haut, les données HEVC ont été reprises telles quelles, sans réencodage.

Vous recevez gratuitement un aperçu de 5 secondes, converti en H.264 pour qu'il se lise dans n'importe quel navigateur, quelles que soient les capacités de votre Mac. Si vous y reconnaissez votre vidéo, vous payez pour télécharger le fichier complet : 6 € en dessous de 2 Go, 18 € de 2 à 20 Go, 35 € de 20 à 50 Go et 59 € au-delà, TVA comprise. Les fichiers sont acceptés jusqu'à 150 Go et tout est supprimé automatiquement au bout de 48 heures.

Si votre fichier relevait de la cause 1 ou 2, vous n'avez pas besoin de nous : corrigez-le sur votre machine avec la commande correspondante.

Envoyer votre fichier HEVC

FAQ

VLC lit mon fichier HEVC mais pas QuickTime. Est-il corrompu ? Pas forcément. Regardez d'abord codec_tag_string. Une étiquette hev1 se corrige avec une simple commande de copie, alors écartez-la avant tout le reste. Si l'étiquette est hvc1, restent un profil non pris en charge, une table de timing absente ou des images de référence manquantes, et seules les deux dernières signalent de vrais dégâts.

Puis-je empêcher mon iPhone d'enregistrer en HEVC ? Oui. Dans Réglages, puis Appareil photo, puis Formats, choisissez « Le plus compatible » : les nouvelles vidéos seront enregistrées en H.264. Les fichiers seront plus lourds, et les vidéos déjà tournées restent en HEVC.

Un réencodage répare-t-il un fichier HEVC corrompu ? Il rétablit la lecture, pas les dégâts. ffmpeg masque ce qu'il ne parvient pas à décoder et l'encodeur grave ces images masquées dans le nouveau fichier. Si les bavures ou les zones vertes vous gênent, il faut d'abord récupérer les octets d'origine.

Pourquoi mon fichier récupéré se lit-il sur PC mais pas sur Mac ? Le décodeur d'Apple est plus strict que celui de ffmpeg. Un fichier étiqueté hev1, sans décalages de composition ou privé d'images de référence passe sur presque tout ce qui repose sur ffmpeg, et QuickTime le refuse. Un outil de réparation testé uniquement avec ffmpeg ne s'en serait pas aperçu.

Mes images sont-elles en sécurité ? Les fichiers sont traités sur des serveurs situés dans l'UE et supprimés automatiquement au bout de 48 heures. Personne ne les ouvre, sauf si vous nous le demandez ou si la réparation automatique échoue, et alors uniquement pour les récupérer et corriger notre logiciel de réparation, afin que le prochain fichier du même type se répare tout seul. Ils ne sont jamais partagés ni utilisés pour entraîner une IA. Voir la politique de confidentialité.

Articles connexes

Aperçu gratuit · Sans engagement

Prêt(e) à récupérer votre vidéo ?

Importez votre fichier : obtenez gratuitement un aperçu de 5 secondes en environ une minute. Payez uniquement si l'aperçu vous semble correct.

Importez votre fichier →