NOM¶

mkvpropedit - Modifier les propriétés des fichiers Matroska existants sans un remultiplexage complet

RÉSUMɶ

mkvpropedit [options] {source-filename} {actions}

DESCRIPTION¶

Ce logiciel analyse un fichier Matroska existant et modifie quelques unes de ses propriétés. Ensuite, il écrit ces modifications dans le fichier existant. Parmi les propriétés qui peuvent être modifiées figurent les éléments d'informations de segment (par ex. le titre) et les entêtes de piste (par ex. le code langue, l'indicateur « Piste par défaut » ou le nom).

Options :

-l, --list-property-names

-p, --parse-mode mode

Actions relatives aux pistes et propriétés d'informations de segment :

-e, --edit selecteur

-a, --add name=value

-s, --set name=value

-d, --delete name

Actions relatives aux balises et chapitres :

-t, --tags selector:filename

--add-track-statistics-tags

--delete-track-statistics-tags

-c, --chapters filename

Actions sur les pièces jointes :

--add-attachment filename

--replace-attachment selector:filename

--update-attachment selector

--delete-attachment selector

Options pour les actions sur les pièces jointes :

--attachment-name name

--attachment-mime-type mime-type

--attachment-description description

--enable-legacy-font-mime-types

Autres options :

--disable-language-ietf

--normalize-language-ietf mode

--command-line-charset character-set

--output-charset character-set

-r, --redirect-output file-name

--ui-language code

--abort-on-warnings

--debug topic

--engage feature

--gui-mode

-v, --verbose

-h, --help

-V, --version

@options-file.json

SÉLECTEURS DÉDITION¶

L'option --edit définit la section de fichier Matroska (informations de segment ou certaines entêtes de pistes) sur lesquelles opèrent toutes les actions add, set et delete. Ceci reste valide jusqu'à temps que l'option suivante --edit soit trouvée. L'argument de cette option est appelé le sélecteur d'édition.

Par défaut mkvpropedit(1) éditera la section d'informations de segment.

SÉLECTEURS DE PIÈCE JOINTE¶

Un sélecteur de pièce jointe est utilisé avec ces deux actions --replace-attachment et --delete-attachment. Il peut avoir une des quatre formes suivantes :

GESTION DES LANGUES¶

Globalement, mkvpropedit(1) essaie de faire les choses correctement par défaut : lors de modifications de la propriété de langue, mkvpropedit(1) applique les mêmes modifications à l'élément « LanguageIETF » qu'à l'ancien élément « Language », de la même façon que mkvmerge(1) applique la langue à ces deux éléments. Par exemple, avec mkvpropedit movie.mkv --edit track:2 --set language=zh-TW l'élément « LanguageIETF » sera défini en zh-TW et l'ancien élément « Language » en chi.

De plus il existe une nouvelle propriété d'entête de piste nommée language-ietf qui peut être définie ou retirée. Les modifications de cette propriété s'appliquent seulement au nouvel élément d'entête de piste « LanguageIETF ». Il faut noter ici que l'ancien élément d'entête de piste « Language » est un élément requis pour Matroska — ce qui signifie que même absent du fichier, il a une valeur implicite. Quand l'utilisateur définit seulement la propriété language-ietf mais pas la propriété language, mkvpropedit(1) ajoute l'ancien élément « Language » dans certains cas, et la définit à und (« undetermined », c'est-à-dire indéterminé) si l'utilisateur n'en a pas spécifié une valeur.

Lors de la lecture de fichiers XML de balises ou de chapitres, mkvpropedit(1) fonctionne comme mkvmerge(1).

La création des nouveaux éléments peut être complètement désactivée avec l'option en ligne de commande « --disable-language-ietf ». Elle prend effet sur les trois nouveaux éléments.

Il est possible de choisir la méthode de normalisation appliquée aux sous-balises de langue étendue avec le paramètre --normalize-language-ietf.

EXEMPLES¶

L'exemple suivant édite un fichier nommé 'movie.mkv'. Il définit le titre du segment et modifie le code de langue d'une piste audio et d'une piste de sous-titres. Noter que cet exemple peut être simplifié en omettant la 1ère option --edit parce que l'édition de l'élément d'information du segment est dans tous les cas l'action par défaut pour toutes les options trouvées avant la 1ère option --edit.

$ mkvpropedit movie.mkv --edit info --set "title=The movie" --edit track:a1 --set language=fre --edit track:a2 --set language=ita

Le deuxième exemple retire l'indicateur « Piste par défaut » de la 1ère piste de sous-titres et le définit pour la 2nde. Noter que mkvpropedit(1), à la différence de mkvmerge(1), ne définit pas l'indicateur « Piste par défaut » des autres pistes à « 0 » s'il est définit automatiquement à « 1 » pour une autres piste.

$ mkvpropedit movie.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1

Remplacer les balises pour la 2nde piste de sous-titres dans un fichier ressemble à ceci :

$ mkvpropedit movie.mkv --tags track:s2:new-subtitle-tags.xml

Supprimer toutes les balises nécessite d'omettre le nom de fichier :

$ mkvpropedit movie.mkv --tags all:

Remplacer les chapitres dans un fichier ressemble à ceci :

$ mkvpropedit movie.mkv --chapters new-chapters.xml

Suppression de tous les chapitres nécessite d'omettre le nom de fichier :

$ mkvpropedit movie.mkv --chapters ''

Ajout d'un fichier de police (Arial.ttf) en pièce jointe :

$ mkvpropedit movie.mkv --add-attachment Arial.ttf

Ajout d'un fichier de police (89719823.ttf) en pièce jointe et de quelques informations comme quoi ce n'est juste qu'Arial :

$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'La police Arial comme police TrueType' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf

Remplacement d'un fichier de police (Comic.ttf) en pièce jointe avec un autre (Arial.ttf) :

$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'La police Arial comme police TrueType' --replace-attachment name:Comic.ttf:Arial.ttf

Suppression du second fichier en pièce jointe, quel qu'il soit :

$ mkvpropedit movie.mkv --delete-attachment 2

Suppression de toutes les polices en pièces jointes de type MIME :

$ mkvpropedit movie.mkv --delete-attachment mime-type:application/x-truetype-font

CODES DE FERMETURE¶

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

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).

VARIABLES DENVIRONMENT¶

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

MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG

MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE

VOIR AUSSI¶

mkvmerge(1), mkvinfo(1), mkvextract(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@bunkus.org>

NOTES¶

1.

la page d'accueil de MKVToolNix