Manpages

NOM

mkvextract - extrait les pistes d'un fichier Matroska vers d'autres fichiers

RÉSUMÉ

DESCRIPTION

Ce logiciel extrait des parties spécifiques d'un fichier Matroska vers d'autres formats utiles. Le premier argument est le nom du fichier source qui doit être un fichier Matroska.

Tous les autres arguments soit basculent vers un mode d'extraction particulier, soit modifient des options pour le mode en cours, soit spécifient quoi extraire vers quel fichier. Plusieurs modes peuvent être utilisés en même temps en invoquant mkvextract, ce qui permet d'extraire plusieurs choses en une seule passe. La plupart des options peuvent seulement être utilisées dans certains modes, avec quelques options qui s'appliquent à tous les modes.

Est actuellement prise en charge l'extraction des pistes, balises, pièces jointes, chapitres, feuilles de montage CUE, horodatages et points de montage.

Options communes
Les options suivantes sont disponibles pour tous les modes et sont seulement décrites une seule fois dans cette section.

-f, --parse-fully

Définit le mode d'analyse à « complet ». Le mode par défaut n'analyse pas entièrement le fichier nais utilise les méta-éléments de recherche pour localiser les éléments requis d'un fichier source. Dans la grand majorité des cas, cela est suffisant. Mais pour les fichiers qui ne contiennent pas ces méta-éléments ou qui sont endommagés, l'utilisateur pourrait utiliser ce mode. L'analyse complète d'un fichier peut prendre plusieurs minutes tandis qu'une analyse rapide ne prend que quelques secondes.

--command-line-charset character-set

Définit le jeu de caractères utilisé pour la conversion des chaînes fournies en ligne de commande. Par défaut, celui-ci correspond à celui donné par la « locale » du système.

--output-charset character-set

Définit le jeu de caractères dans lequel les chaînes en sortie sont converties. Par défaut, celui-ci correspond à celui donné par la « locale » du système.

-r, --redirect-output file-name

Écrit tous les messages dans le fichier file-name plutôt que vers la console. Alors que cela peut être facilement fait avec la redirection de la sortie, il y a des cas pour lesquels cette option est nécessaire : quand le terminal réinterprète la sortie avant de l'écrire dans un fichier. Le jeu de caractères défini avec --output-charset est honoré.

--flush-on-close

Indique au programme d'envoyer toutes les données cachées en mémoire vers le support de stockage lors de la fermeture de fichiers ouverts en écriture. Ceci peut être utilisé pour éviter la perte de données lors de coupures de courant ou pour contourner certains problèmes du système d'exploitation ou de pilotes. L'inconvénient est que le multiplexage sera plus long du fait que mkvmerge devra attendre que toutes les données soient écrites sur le support de stockage avant de quitter. Voir les problèmes #2469 et #2480 sur le suivi des bogues de MKVToolNix pour des discussions approfondies sur les avantages et inconvénients.

--ui-language code

Force les traductions pour la langue code à utiliser (par ex. 'fr_FR' pour les traductions françaises). Saisir 'list' comme code obligera le logiciel à générer la liste des traductions disponibles.

--abort-on-warnings

Demande au programme d'abandonner après le premier avertissement. Le code de fermeture sera égal à 1.

--debug topic

Activer le débogage pour une fonctionnalité spécifique. Cette option est utile uniquement pour les développeurs.

--engage feature

Active les fonctionnalités expérimentales. Une liste des fonctions disponibles peut être demandée avec mkvextract --engage list. Ces fonctionnalités ne devraient pas être utilisées en situations normales.

--gui-mode

Active l'interface graphique utilisateur. Dans ce mode, des lignes spécialement formatées peuvent être générées et informer une GUI de la situation. Ces messages suivent le format '#GUI#message'. Le message peut être suivi d'une paire clé/valeur comme '#GUI#message#key1=value1#key2=value2...'. Ni les messages ni les clés ne sont traduits, et sont toujours générés en anglais.

-v, --verbose

Mode verbeux qui affiche tous les éléments Matroska importants à mesure qu'ils sont lus.

-h, --help

Affiche les informations d'utilisation et quitte.

-V, --version

Affiche les informations de version et quitte.

@options-file.json

Lit des arguments supplémentaires en ligne de commande depuis le fichier options-file. Pour une explication complète sur les formats pris en charge pour de tels fichiers, voir la section nommée « Fichiers d'options » sur la page man de mkvmerge(1).

Mode d'extraction des pistes
Syntaxe : mkvextract source-filename tracks [options] TID1:dest-filename1 [TID2:dest-filename2 ...]

Les options de ligne de commande suivantes sont disponibles pour chaque piste en mode d'extraction de 'tracks'. Elles doivent apparaître avant les spécifications de piste (voir ci-dessous) auxquelles elles devraient s'appliquer.

-c character-set

Définit le jeu caractère pour en convertir la prochaine piste de texte de sous-titres. Seulement valide si l'ID de la nouvelle piste est une piste de texte de sous-titres. Par défaut UTF-8.

--blockadd niveau

Conserve seulement les BlockAdditions jusqu'à ce niveau. Par défaut, tous les niveaux. Cette option affecte seulement certains types de codecs comme WAVPACK4.

--cuesheet

Oblige mkvextract(1) à extraire une feuille de montage CUE à partir des données de balises et des informations de chapitres pour la piste suivante dans le fichier dont le nom est le nom de piste cible terminé par « .cue ».

--raw

Extrait les données brutes dans un fichier sans conteneur de données. À la différence de l'indicateur --fullraw, cet indicateur n'oblige pas les contenus de l'élément CodecPrivate à être écrits vers le fichier. Ce mode fonctionne avec tous les CodecIDs, même ceux que mkvextract(1) ne prend pas en charge, mais les fichiers résultants pourraient ne pas être utilisables.

--fullraw

Extrait les données brutes dans un fichier sans conteneur de données. Les contenus de l'élément CodecPrivate seront écrits vers le fichier en premier si la piste contient un tel élément d'entête. Ce mode fonctionne avec tous les CodecIDs, même ceux que mkvextract(1) ne prend pas en charge, mais les fichiers résultants pourraient ne pas être utilisables.

TID:outname

Oblige l'extraction de la piste avec l'ID TID dans le fichier outname si une telle piste existe dans le fichier source. Cette option peut être donnée plusieurs fois. Les ID de pistes sont les mêmes que celles données par l'option --identify de mkvmerge(1).

Chaque nom cible devrait n'être utilisé qu'une seule fois, à l'exception des pistes RealAudio et RealVideo. Si le même nom est utilisé pour différentes pistes, alors ces pistes seront enregistrées dans le même fichier. Exemple :

$ mkvextract input.mkv tracks 0:video.h264 2:output-two-vobsub-tracks.idx 3:output-two-vobsub-tracks.idx

Mode d'extraction des pièces jointes
Syntaxe : mkvextract source-filename attachments [options] AID1:outname1 [AID2:outname2 ...]

AID:outname

Oblige l'extraction de la pièce jointe avec l'ID AID dans le fichier outname si une telle pièce jointe existe dans le fichier source. Si outname est laissé vide, alors le nom de la pièce jointe du fichier source Matroska est utilisé. Cette option peut être donnée plusieurs fois. Les ID de pistes sont les mêmes que celles données par l'option --identifyde mkvmerge(1).

Mode d'extraction des chapitres
Syntaxe : mkvextract source-filename chapters [options] output-filename.xml

-s, --simple

Exporte les informations de chapitres dans un format simple utilisé dans l'outil OGM (CHAPTER01=..., CHAPTER01NAME=...). Dans ce mode quelques information doivent être mises de côté. Par défaut, les chapitres sont générés en format XML.

--simple-language langue

Si le format simple est activé, alors mkvextract(1) sortira seulement une entrée unique pour chaque atome de chapitre rencontré même si un atome de chapitre contient plus d'un nom de chapitre. Par défaut mkvextract(1) utilisera le premier nom de chapitre trouvé pour chaque atome quelque soit sa langue.

Utiliser cette option permet à l'utilisateur de déterminer quels noms de chapitres sont sortis si les atomes contiennent plus d'un nom de chapitre. Le paramètre language doit être un code ISO 639-1 ou ISO 639-2.

Les chapitres sont écrits vers le fichier spécifié. Par défaut le format XML compris par mkvmerge(1) est utilisé. Si aucun chapitre n'est trouvé dans le fichier, le fichier source n'est pas créé.

Mode d'extraction des balises
Syntaxe : mkvextract source-filename tags [options] output-filename.xml

Les balises sont écrites vers le fichier spécifié dans le format XML compris par mkvmerge(1). Si aucune balise n'est trouvée dans le fichier, le fichier source n'est pas créé.

Mode d'extraction de feuille de montage CUE
Syntaxe : mkvextract source-filename cuesheet [options] output-filename.cue

La feuille de montage est écrite vers le fichier spécifié. Si aucun chapitre ou balise n'est trouvé dans le fichier, le fichier source n'est pas créé.

Mode d'extraction d'horodatage
Syntaxe : mkvextract source-filename timestamps_v2 [options] TID1:dest-filename1 [TID2:dest-filename2 ...]

TID:outname

Oblige l'extraction des horodatages pour la piste avec l'ID TID dans le fichier outnamesi une telle piste existe dans le fichier source. Cette option peut être donnée plusieurs fois. Les ID de pistes sont les mêmes que celles données par l'option --identify de mkvmerge(1).

Exemple :

$ mkvextract input.mkv timestamps_v2 1:ts-track1.txt 2:ts-track2.txt

Mode d'extraction des feuilles de montage CUE
Syntaxe : mkvextract source-filename cues [options] TID1:dest-filename1 [TID2:dest-filename2 ...]

TID:dest-filename

Oblige l'extraction des données de montage pour la piste avec l'ID TID dans le fichier outname si une telle piste existe dans le fichier source. Cette option peut être donnée plusieurs fois. Les ID de pistes sont les mêmes que celles données par l'option --identify de mkvmerge(1) et ne sont pas les numéros contenus dans l'élément CueTrack.

Le format de sortie est un simple format texte : une ligne par élément CuePoint avec des pairs key=value. Si un élément optionnel n'est pas présent dans un CuePoint (par ex. CueDuration), alors un tiret sera inscrit comme valeur.

Exemple :

timestamp=00:00:13.305000000 duration=- cluster_position=757741 relative_position=11

Les clés possibles sont :

horodatage

L'horodatage du point de montage en précision nanoseconde. Le format est HH:MM:SS.nnnnnnnnn. Cet élément est toujours défini.

durée

La durée du point de montage en précision nanoseconde. Le format est HH:MM:SS.nnnnnnnnn.

cluster_position

La position absolue en octets dans le fichier Matroska où la grappe contenant l'élément référencé commence.

Note
Dans un fichier Matroska CueClusterPosition est relatif au décalage du début des données de l'élément. Toutefois, la valeur fournie par le mode d'extraction de données de montage de mkvextract(1) contient déjà ce décalage et est un décalage absolu depuis le début du fichier.

relative_position

La position relative en octets dans la grappe où l'élément BlockGroup ou SimpleBlock auquel le point de montage se réfère commence.

Note
Dans un fichier Matroska 1CueRelativePosition1 est relatif au décalage du début des données de la grappe. Toutefois, la valeur fournie par le mode d'extraction de données de montage de mkvextract(1) est relative à l'ID de la grappe. La position absolue dans le fichier peut être calculée en ajoutant cluster_position et relative_position.

Exemple :

$ mkvextract input.mkv cues 1:cues-track1.txt 2:cues-track2.txt

EXEMPLES

Extraction de chapitres et balises dans leur formats XML respectifs en même temps :

$ mkvextract movie.mkv chapters movie-chapters.xml tags movie-tags.xml

Extraction de quelques piste et leurs horodatages respectifs en même temps :

$ mkvextract "Un autre film.mkv" tracks 0:video.h265 "1:piste audio principale.aac" "2:commentaires du réalisateur.aac" timestamps_v2 "0:horodatages vidéo.txt" "1:horodatages piste audio principale.txt" "2:horodatages des commentaires du réalisateur.txt"

Extraction de chapitres dans le format Ogg/OGM et réencodage d'unepiste de sous-titre texte dans un autre jeu de caractère :

$ mkvextract "Mon film.mkv" chapters --simple "Mes chapitres.txt" tracks -c MS-ANSI "2:Mes sous-titres.srt"

FICHIERS TEXTE ET CONVERSIONS DE JEUX DE CARACTÈRES

Pour une discussion approfondie sur la gestion des conversions de jeux de caractères des outils de la suite MKVToolNix, de l'encodage source/cible, de l'encodage de la ligne de commande, de l'encodage de la console, merci de voir les sections respectives nommées pareillement des pages man de mkvmerge(1).

FORMATS DE FICHIER CIBLE

La décision sur le format de sortie est basée sur le type de piste et non sur l'extension utilisée pour le nom de fichier cible. Les types de pistes suivantes sont prises en charge pour le moment :

A_AAC/MPEG2/*, A_AAC/MPEG4/*, A_AAC

Tous les fichiers AAC seront écrits dans un fichier AAC avec des entêtes ADTS avant chaque paquet. Les entêtes ADTS ne contiendront pas le champ d'accentuation obsolète.

A_AC3, A_EAC3

Celles-ci seront extraites en fichiers bruts AC-3.

A_ALAC

Les pistes ALAC sont écrites en fichiers CAF.

A_DTS

Celles-ci seront extraites en fichiers bruts DTS.

A_FLAC

Les pistes FLAC sont écrits en fichiers RAW FLAC.

A_MPEG/L2

Les flux MPEG-1 Audio Layer II seront extraits vers des fichiers raw MP2.

A_MPEG/L3

Celles-ci seront extraites en fichiers bruts MP3.

A_OPUS

Les pistes Opus sont écrites en fichiers OggOpus.

A_PCM/INT/LIT, A_PCM/INT/BIG

Les données brutes PCM seront écrites en fichier WAV. Le données Big-endian entier seront converties en données little-endian ce faisant.

A_REAL/*

Les pistes RealAudio sont écrites en fichiers RealMedia.

A_TRUEHD, A_MLP

Celles-ci seront extraites en fichiers bruts TrueHD/MLP.

A_TTA1

Les pistes TrueAudio sont écrites en fichiers TTA. Merci de noter que du fait de la précision limitée de l'horodatage Matroska, l'entête extraite du fichier sera différente pour ces deux champs : data_length (le nombre total d'échantillons du fichier) et CRC.

A_VORBIS

Vorbis audio va être écrit dans un fichier OggVorbis .

A_WAVPACK4

Les pistes WavPack sont écrites en fichiers WV.

S_HDMV/PGS

Les sous-titres PGS seront écrits en fichiers SUP.

S_HDMV/TEXTST

Les sous-titres TextST seront écrits en format de fichier spécial inventé pour mkvmerge(1) et mkvextract(1).

S_KATE

Les flux Kate seront écrits en conteneur Ogg.

S_TEXT/SSA, S_TEXT/ASS, S_SSA, S_ASS

Les sous-titres texte SSA et ASS seront respectivement écrits comme fichiers SSA/ASS.

S_TEXT/UTF8, S_TEXT/ASCII

Les sous-titres texte simple seront écrits comme fichiers SRT.

S_VOBSUB

Les sous-titres texte VobSub seront écrits comme fichiers SUB avec les fichiers d'index respectifs, comme fichiers IDX.

S_TEXT/USF

Les sous-titres texte USF seront écrits comme fichiers USF.

S_TEXT/WEBVTT

Les sous-titres texte WebVTT seront écrits comme fichiers WebVTT.

V_MPEG1, V_MPEG2

Les pistes vidéo MPEG-1 and MPEG-2 seront écrites comme flux élémentaires MPEG.

V_MPEG4/ISO/AVC

Les pistes vidéoH.264 / AVC sont écrites comme flux élémentaires H.264 qui peuvent être post-traités avec par ex. MP4Box du paquet GPAC.

V_MPEG4/ISO/HEVC

Les pistes vidéoH.265 / HEVC sont écrites comme flux élémentaires H.265 qui peuvent être post-traités avec par ex. MP4Box du paquet GPAC.

V_MS/VFW/FOURCC

Les pistes vidéo à FPS constant avec ce CodecID sont écrites en fichiers AVI.

V_REAL/*

Les pistes RealVideo sont écrites en fichiers RealMedia.

V_THEORA

Les flux Theora seront écrites en conteneur Ogg

V_VP8, V_VP9

VP8 / VP9 pistes sont écrites pour IVF fichiers.

Balises

Les balises sont converties en format XML. Ce format est le même que mkvmerge(1) gère en lecture.

Pièces jointes

Les pièces jointes sont écrites dans le fichier de sortie telles quelles. Aucune conversion n'est effectuée.

Chapitres

Les chapitres sont convertis en format XML. Ce format est le même que mkvmerge(1) gère pour lire les chapitres. Autrement une version dépouillée peut être produite dans le format simple OGM.

Horodatages

Les codes temporels sont d'abord triés puis produits en fichier conforme avec le format de code temporel v2 prêt à être envoyé à mkvmerge(1). L'extraction vers d'autres formats (v1, v3 et v4) n'est pas prise en charge.

CODES DE FERMETURE

mkvextract(1) ferme avec l'un de ces 3 codes de fermeture :

• 0 -- Ce code de sortie signifie que l'extraction s'est correctement terminée.

• 1 -- Dans ce cas mkvpropedit(1) a émis au moins un avertissement, mais la modification a continué. Un avertissement est préfixé avec le texte 'Avertissement :'. Selon le problème, les fichiers résultants pourront être OK ou pas. L'utilisateur est vivement conseillé de vérifier et l'avertissement et les fichiers résultants.

• 2 -- Ce code de fermeture est utilisé lorsqu'une erreur survient. mkvpropedit(1) abandonne juste après le message d'erreur. Les messages d'erreurs vont des arguments erronés en ligne de commande aux fichiers corrompus en passant par les erreurs en lecture/écriture.

VARIABLES DENVIRONMENT

mkvmerge(1) utilise les variables par défaut qui déterminent la « locale » du système (par ex. LANG et la famille LC_*). Variables additionnelles :

MKVEXTRACT_DEBUG, MKVTOOLNIX_DEBUG et sa forme courte MTX_DEBUG

Le contenu est traité comme s'il a été passé via l'option --debug.

MKVEXTRACT_ENGAGE, MKVTOOLNIX_ENGAGE et sa forme courte MTX_ENGAGE

Le contenu est traité comme s'il a été passé via l'option--engage.

VOIR AUSSI

mkvmerge(1), mkvinfo(1), mkvpropedit(1), mkvtoolnix-gui(1)

WWW

La dernière version peut toujours être trouvée à la page d'accueil de MKVToolNix [1] .

AUTEUR

Moritz Bunkus <moritz [AT] bunkus.org>

Développeur

NOTES

https://mkvtoolnix.download/