| MKVPROPEDIT(1) | Komendy użytkownika | MKVPROPEDIT(1) |
NAZWA¶
mkvpropedit - Modyfikuj właściwości istniejących plików Matroska bez całkowitego remuxowania
SZABLON LINII KOMEND¶
mkvpropedit [opcje] {źródłowa-nazwapliku} {działania}
OPIS¶
Ten program analizuje istniejący plik Matroska i modyfikuje niektóre jego właściwości. Następnie zapisuje te modyfikacje w istniejącym pliku. Wśród właściwości, które można zmienić, znajdują się elementy informacji o segmencie (np. tytuł) oraz nagłówki ścieżek (np. kod języka, flaga „ścieżka domyślna” lub nazwa).
Opcje:
-l, --list-property-names
-p, --parse-mode tryb
Działania na ścieżkach i właściwościach segmentu:
-e, --edit selektor
Domyślnie mkvpropedit(1) edytuje sekcję informacji o segmencie.
Pełny opis składni znajduje się w sekcji dotyczącej selektorów edycji.
-a, --add nazwa=wartość
-s, --set nazwa=wartość
-d, --delete nazwa
Działania na tagach i rozdziałach:
-t, --tags selektor:nazwa-pliku
Parametr selector musi być jednym ze słów all, global lub track. Dla all mkvpropedit(1) zastąpi lub usunie wszystkie tagi w pliku. W przypadku global zastępowane lub usuwane będą tylko tagi globalne.
W przypadku track mkvpropedit(1) zastąpi tagi dla określonej ścieżki. Dodatkowo tagi odczytane z filename zostaną przypisane do tej samej ścieżki. Ścieżka jest określana w taki sam sposób, jak opisano w selektorach edycji (zobacz poniżej), np. --tags track:a1:new-audio-tags.xml.
--add-track-statistics-tags
--delete-track-statistics-tags
-c, --chapters nazwa-pliku
Działania na załącznikach:
--add-attachment nazwa-pliku
Jeśli przed tą opcją użyto opcji --attachment-name, jej wartość zostanie użyta jako nazwa nowego załącznika. W przeciwnym razie zostanie ona wyprowadzona z filename.
Jeśli przed tą opcją użyto opcji --attachment-mime-type, jej wartość zostanie użyta jako typ MIME nowego załącznika. W przeciwnym razie zostanie on automatycznie wykryty na podstawie zawartości filename.
Jeśli przed tą opcją użyto opcji --attachment-description, jej wartość zostanie użyta jako opis nowego załącznika. W przeciwnym razie opis nie zostanie ustawiony.
Jeśli przed tą opcją użyto opcji --attachment-uid, jej wartość zostanie użyta jako UID nowego załącznika. W przeciwnym razie automatycznie zostanie wygenerowany losowy UID.
--replace-attachment selektor:nazwa-pliku
Parametr selector może mieć jedną z czterech postaci. Są one wyjaśnione poniżej w sekcji dotyczącej selektorów załączników.
Jeśli przed tą opcją użyto opcji --attachment-name, jej wartość zostanie ustawiona jako nowa nazwa każdego zmodyfikowanego załącznika. W przeciwnym razie nazwy nie zostaną zmienione.
Jeśli przed tą opcją użyto opcji --attachment-mime-type, jej wartość zostanie ustawiona jako nowy typ MIME każdego zmodyfikowanego załącznika. W przeciwnym razie typy MIME nie zostaną zmienione.
Jeśli przed tą opcją użyto opcji --attachment-description, jej wartość zostanie ustawiona jako nowy opis każdego zmodyfikowanego załącznika. W przeciwnym razie opisy nie zostaną zmienione.
Jeśli przed tą opcją użyto opcji --attachment-uid, jej wartość zostanie ustawiona jako nowy UID każdego zmodyfikowanego załącznika. W przeciwnym razie identyfikatory UID nie zostaną zmienione.
--update-attachment selector
Parametr selector może mieć jedną z czterech postaci. Są one wyjaśnione poniżej w sekcji dotyczącej selektorów załączników.
Jeśli przed tą opcją użyto opcji --attachment-name, jej wartość zostanie ustawiona jako nowa nazwa każdego zmodyfikowanego załącznika. W przeciwnym razie nazwy nie zostaną zmienione.
Jeśli przed tą opcją użyto opcji --attachment-mime-type, jej wartość zostanie ustawiona jako nowy typ MIME każdego zmodyfikowanego załącznika. W przeciwnym razie typy MIME nie zostaną zmienione.
Jeśli przed tą opcją użyto opcji --attachment-description, jej wartość zostanie ustawiona jako nowy opis każdego zmodyfikowanego załącznika. W przeciwnym razie opisy nie zostaną zmienione.
Jeśli przed tą opcją użyto opcji --attachment-uid, jej wartość zostanie ustawiona jako nowy UID każdego zmodyfikowanego załącznika. W przeciwnym razie identyfikatory UID nie zostaną zmienione.
--delete-attachment selektor
Parametr selector może mieć jedną z czterech postaci. Są one wyjaśnione poniżej w sekcji dotyczącej selektorów załączników.
Opcje dla działań na załącznikach:
--attachment-name nazwa
--attachment-mime-type typ-mime
--attachment-description opis
--enable-legacy-font-mime-types
Dotyczy to zarówno dodawania nowych załączników, jak i zastępowania istniejących, ale tylko wtedy, gdy nowy typ MIME nie został określony. Pozostałe istniejące załączniki nie są zmieniane.
Dotyczy to typów MIME „font/sfnt”, „font/ttf” i „font/collection”, które są mapowane na „application/x-truetype-fonts”, oraz „font/otf”, który jest mapowany na „application/vnd.ms-opentype”.
Pozostałe opcje:
--disable-language-ietf
Ta opcja nie wpływa na zmiany żądane za pomocą właściwości ścieżki „language-ietf”.
--normalize-language-ietf mode
W postaci kanonicznej wszystkie podtagi, dla których istnieją preferowane wartości, są zastępowane tymi preferowanymi wartościami. Na przykład „zh-yue-jyutping” jest konwertowane na „yue-jyutping”, a „fr-FX” na „fr-FR”.
W przypadku postaci z rozszerzonymi podtagami językowymi najpierw tworzona jest postać kanoniczna. Następnie wszystkie języki główne, dla których istnieje rozszerzony podtag językowy, są zastępowane tym podtagiem i jego prefiksem. Na przykład „yue-jyutping” jest z powrotem konwertowane na „zh-yue-jyutping”, ale nie ma to wpływu na „fr-FR”, ponieważ „fr” nie jest rozszerzonym podtagiem językowym.
Normalizacja ta ma zastosowanie wyłącznie do elementów, które są faktycznie zmieniane:
Najlepszym sposobem znormalizowania wszystkich istniejących tagów językowych w pliku jest ponowne zmultipleksowanie go za pomocą mkvmerge(1) i ustawienie opcji „--normalize-language-ietf” na żądany tryb.
--command-line-charset zestaw-znaków
--output-charset zestaw-znaków
-r, --redirect-output nazwa-pliku
--no-bom
--ui-language kod
--abort-on-warnings
--debug temat
--engage funkcja
--gui-mode
-v, --verbose
-h, --pomoc
-V, --wersja
@options-file.json
EDYTUJ SELEKTORY¶
Opcja --edit ustawia sekcję pliku Matroska (informacje o segmencie lub nagłówki określonej ścieżki), na której działają wszystkie kolejne akcje add, set i delete. Pozostaje ona aktywna do momentu napotkania następnej opcji --edit. Argument tej opcji nazywany jest selektorem edycji.
Domyślnie mkvpropedit(1) edytuje sekcję informacji o segmencie.
Informacje o segmencie¶
Informacje o segmencie można wybrać za pomocą jednego z trzech słów: „info”, „segment_info” lub „segmentinfo”. Zawierają one właściwości takie jak tytuł segmentu lub identyfikator UID segmentu.
Nagłówki ścieżki¶
Nagłówki ścieżek można wybrać za pomocą nieco bardziej złożonego selektora. Wszystkie warianty zaczynają się od „track:”. Właściwości nagłówka ścieżki obejmują elementy takie jak kod języka, flaga „ścieżka domyślna” lub nazwa ścieżki.
track:n
Numerowanie rozpoczyna się od 1.
track:tn
Numerowanie rozpoczyna się od 1.
track:=uid
track:@numer
Uwagi¶
Ze względu na charakter selektorów edycji ścieżek możliwe jest, że kilka selektorów faktycznie pasuje do tych samych nagłówków ścieżek. W takich przypadkach wszystkie akcje dla tych selektorów edycji zostaną połączone i wykonane w kolejności, w jakiej podano je w wierszu poleceń.
SELEKTORY ZAŁĄCZNIKÓW¶
Selektor załącznika jest używany z dwiema akcjami: --replace-attachment i --delete-attachment. Może mieć jedną z następujących czterech postaci:
OBSŁUGA JĘZYKÓW¶
mkvpropedit(1) w większości przypadków domyślnie stara się robić właściwą rzecz. Dlatego zmiany właściwości language spowodują, że mkvpropedit(1) zastosuje tę samą zmianę zarówno do nowego elementu „LanguageIETF”, jak i starego elementu „Language”, podobnie jak mkvmerge(1) stosuje język do obu elementów. Na przykład przy użyciu mkvpropedit movie.mkv --edit track:2 --set language=zh-TW element „LanguageIETF” zostanie ustawiony na zh-TW, a stary element „Language” na chi.
Dodatkowo istnieje nowa właściwość nagłówka ścieżki o nazwie language-ietf, którą można ustawić lub usunąć. Zmiany tej właściwości dotyczą tylko nowego elementu nagłówka ścieżki „LanguageIETF”. Należy jednak pamiętać, że stary element nagłówka ścieżki „Language” jest elementem obowiązkowym w formacie Matroska — oznacza to, że nawet jeśli nie występuje w pliku, nadal ma wartość niejawną. Dlatego jeśli użytkownik ustawi tylko właściwość language-ietf, ale nie właściwość language, mkvpropedit(1) w niektórych przypadkach doda stary element „Language” i ustawi go na und (czyli „nieokreślony”), ponieważ użytkownik nie podał dla niego wartości.
Podczas odczytywania plików XML rozdziałów lub tagów mkvpropedit(1) działa tak samo jak mkvmerge(1).
Tworzenie nowych elementów można całkowicie wyłączyć za pomocą opcji wiersza poleceń --disable-language-ietf, która działa na wszystkie trzy nowe elementy.
Metodę normalizacji stosowaną dla rozszerzonych podtagów językowych można wybrać za pomocą parametru --normalize-language-ietf.
PRZYKŁADY¶
Poniższy przykład edytuje plik „movie.mkv”. Ustawia tytuł segmentu i modyfikuje kod języka ścieżki audio oraz ścieżki napisów. Należy pamiętać, że przykład można skrócić, pomijając pierwszą opcję --edit, ponieważ edycja elementu informacji o segmencie jest domyślna dla wszystkich opcji występujących przed pierwszą opcją --edit.
$ mkvpropedit film.mkv --edit info --set "title=Film" --edit track:a1 --set language=fre --edit track:a2 --set language=pol
Drugi przykład usuwa „flagę ścieżki domyślnej” z pierwszej ścieżki napisów i ustawia ją dla drugiej. Należy pamiętać, że mkvpropedit(1), w przeciwieństwie do mkvmerge(1), nie ustawia automatycznie flagi „ścieżka domyślna” innych ścieżek na „0”, jeśli dla innej ścieżki została ustawiona na „1”.
$ mkvpropedit film.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1
Podmiana tagów dla drugiej ścieżki napisów wygląda następująco:
$ mkvpropedit film.mkv --tags track:s2:nowe-tagi-napisów.xml
Usuwanie wszystkich tagów zakłada pominięcie nazwy pliku:
$ mkvpropedit film.mkv --tags all:
Podmiana rozdziałów w pliku wygląda następująco:
$ mkvpropedit film.mkv --chapters nowe-rozdziały.xml
Usuwanie wszystkich rozdziałów zakłada pominięcie nazwy pliku:
$ mkvpropedit film.mkv --chapters ''
Dodawanie pliku czcionki (Arial.ttf) jako załącznika:
$ mkvpropedit film.mkv --add-attachment Arial.ttf
Dodawanie pliku czcionki (89719823.ttf) jako załącznika i dostarczanie informacji, że jest to czcionka Arial:
$ mkvpropedit film.mkv --attachment-name Arial.ttf --attachment-description "Czcionka Arial jako TrueType" --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf
Zamiana załączonego pliku czcionki (Comit.ttf) na drugi z inną czcionką (Arial.ttf):
$ mkvpropedit film.mkv --attachment-name Arial.ttf --attachment-description "Czcionka Arial jako TrueType" --replace-attachment name:Comic.ttf:Arial.ttf
Usuwanie drugiego załącznika, cokolwiek by to nie było:
$ mkvpropedit film.mkv --delete-attachment 2
Usuwanie wszystkich załączonych czcionek według typu MIME:
$ mkvpropedit film.mkv --delete-attachment mime-type:application/x-truetype-font
KODY ZAKOŃCZENIA¶
mkvpropedit(1) kończy działanie z jednym z trzech kodów wyjścia:
PLIKI TEKSTOWE I KONWERSJE ZESTAWÓW ZNAKÓW¶
Szczegółowe omówienie sposobu, w jaki wszystkie narzędzia w pakiecie MKVToolNix obsługują konwersję zestawu znaków, kodowanie wejściowe/wyjściowe, kodowanie linii komend i kodowanie konsoli, można znaleźć w sekcji o identycznej nazwie na mkvmerge(1) stronie podręcznika.
ZMIENNE ŚRODOWISKOWE¶
mkvpropedit(1) używa domyślnych zmiennych, które określają ustawienia regionalne systemu (np. LANG i rodzina LC_*). Dodatkowe zmienne:
MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG i jego skrócona forma MTX_DEBUG
MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE i jego skrócona forma MTX_ENGAGE
ZOBACZ TAKŻE¶
STRONA WWW¶
Najnowsza wersja jest zawsze dostępna pod adresem domowym MKVToolNix[1].
AUTOR¶
Moritz Bunkus <moritz@bunkus.org>
PRZYPISY¶
- 1.
- adresem domowym MKVToolNix
| 2026-10-18 | MKVToolNix 103.0 |