Для глав и тэгов разрешена только подгруппа элементов. mkvmerge(1) автоматически удалит все элементы, неразрешённые спецификацией.

Стандартный код для «неопределённого» языка — und.

Смотрите раздел XML-файлы информации о сегментах ниже для подробностей.

Если SID начинается с =, то остальное будет распознано как имя файла Matroska, чей сегмент UID считывается и используется.

Каждый созданный файл содержит один сегмент, и каждый сегмент имеет один UID сегмента. Если указано больше UID сегментов, чем создано сегментов, то лишние UID игнорируются. Если указано меньше UID, чем создано сегментов, то для них будут созданы случайные UID.

Этот параметр может использоваться как для простых файлов глав, так и для исходных файлов, содержащих главы без информации об их языке, напр. файлы MP4 и OGM.

Язык, указанный в этом параметре, также используется и при генерации глав с помощью параметра --generate-chapters.

Этот переключатель также применяется к главам, скопированным из определённых типов контейнеров, например файлов Ogg/OGM и MP4. Дополнительные сведения смотрите ниже в разделе о главах.

o/p: поправка временных меток с помощью o/p, чтобы исправить линейные смещения. По умолчанию в случае пропуска p равно 1. И o и p могут быть числами с плавающей запятой.

По умолчанию: ручная коррекция синхронизации отключена (что равноценно d = 0 и o/p = 1.0).

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Названия новых глав управляются параметром --generate-chapters-name-template. Язык устанавливается с помощью --chapter-language, который должен быть указан перед --generate-chapters.

Существует несколько переменных, которые можно использовать в шаблоне, и которые заменяются их фактическими значениями во время создания главы. Строка «<NUM>» будет заменена номером главы. Строка «<START>» будет заменена меткой времени начала главы.

Строки «<FILE_NAME>» и «<FILE_NAME_WITH_EXT>» заполняются только при создании глав для добавляемых файлов. Они будут заменены именем добавляемого файла без указания соответственно его расширения. Обратите внимание, что вставляются только базовое имя и расширение файла, а не его каталог или компоненты диска.

Вы можете указать минимальное число мест для номера главы с помощью «<NUM:places>'», например, «<NUM:3>». Полученное число будет дополнено ведущими нулями, если число мест меньше указанного.

Вы можете управлять форматом, используемым начальной меткой времени, с помощью <START:format>. Когда формат не задан, то умолчанию используется '%H:%M:%S'. Допустимыми кодами формата являются:

Если этот параметр не задан, то mkvmerge(1) по умолчанию использует формат "%p - %t" (исполнитель, за которым следует пробел, тире, ещё один пробел и заголовок).

Если формат указан, то всё, исключая мета-символы, копируется как есть, а сами мета-символы подменяются следующим образом:

Если значение не указано, то mkvmerge(1) поместит в каждый кластер не более n блоков данных. Максимальное количество блоков — 65535.

Если число d имеет постфикс «ms», тогда mkvmerge(1) размещает максимум d миллисекунд данных в каждый кластера. Диапазон для d — от «100 мс» до «32000 мс».

По умолчанию mkvmerge(1) размещает не более 65535 блоков и 5000 мс данных в кластер.

Программы, пытающиеся найти определённый кадр, могут обращаться только непосредственно к кластеру, а затем должны прочесть весь кластер. Поэтому создание больших кластеров может привести к неточному или медленному поиску.

Обычно mkvmerge(1) использует значение 1000000, что означает, что метки времени и длительности имеют точность 1 мс. Для файлов, которые не содержат в себе видеодорожку, но имеют по крайней мере одну звуковую mkvmerge(1) автоматически выберет коэффициент масштаба метки времени, чтобы все метки времени и длительность имели точность до одного звукового образца. Это влечёт за собой большие накладные расходы, но обеспечивает точный поиск и извлечение.

Если используется специальное значение -1, то mkvmerge(1) будет использовать точность до одного семпла, даже если видео-дорожка присутствует.

Включение этого параметра запрещает mkvmerge(1) записывать эти теги и перезаписывать существующие теги с такими же названиями.

В канонической форме все подтеги, для которых существуют предпочтительные значения, заменяются этими предпочтительными значениями. Это преобразует, например, «zh-yue-jyutping» в «yue-jyutping» или «fr-FX» в «fr-FR».

Для формы расширенных языковых подтегов изначально строится каноническая форма. После этого все основные языки, для которых существует расширенный языковой подтег, заменяются этим расширенным языковым подтегом и его префиксом. Это преобразует, например, «yue-jyutping» обратно к «zh-yue-jyutping», но не влияет на «fr-FR», потому что «fr» не является расширенным языковым подтегом.

На данный момент mkvmerge(1) поддерживает следующие режимы:

Для этого режима разделения имя исходного файла обрабатывается иначе, чем для обычной операции. Он может содержать printf, выражение на подобии «%d», включая необязательную ширину поля, напр. «%02d». Если это так, то номер текущего файла будет отформатирован соответствующим образом и вставлен в это место имени файла. Если такого шаблона нет, то перед расширением файла предусматривается шаблон «-%03d»: «-o output.mkv» приведёт к «output-001.mkv»' и т. д. Если расширения нет, к имени будет добавлено «-%03d».

Другим возможным шаблоном является «%c», который будет заменён названием первой главы в файле. Обратите внимание, что когда присутствует «%c», шаблон «-%03d» не будет добавлен автоматически.

Если SID начинается с =, то остальное будет распознано как имя файла Matroska, чей сегмент UID считывается и используется.

Если SID начинается с =, то остальное будет распознано как имя файла Matroska, чей сегмент UID считывается и используется.

When mkvmerge appends a track (called 'track2_1' from now on) from a second file (called 'file2') to a track (called 'track1_1') from the first file (called 'file1') then it has to offset all timestamps for 'track2_1' by an amount. For 'file' mode this amount is the highest timestamp encountered in 'file1' even if that timestamp was from a different track than 'track1_1'. In track mode the offset is the highest timestamp of 'track1_1'.

Unfortunately mkvmerge cannot detect which mode to use reliably. Therefore it defaults to 'file' mode. 'file' mode usually works better for files that have been created independently of each other; e.g. when appending AVI or MP4 files. 'track' mode may work better for sources that are essentially just parts of one big file, e.g. for VOB and EVO files.

Дорожки субтитров всегда обрабатываются так, как если бы режим "file" был активен, даже если включен режим "track".

Если этот параметр был пропущен, используется стандартное сопоставление. Это стандартное сопоставление добавляет каждую дорожку из текущего файла к дорожке из предыдущего файла с тем же ИД дорожки. Это позволяет легко добавлять, если фильм был разделен на две части и оба файла имеют одинаковое количество дорожек и ИД дорожек с помощью команды mkvmerge -o output.mkv part1.mkv +part2.mkv.

Альтернативное использование синтаксиса '+' между двумя именами файлов. Поэтому следующие две команды эквивалентны:

$ mkvmerge -o полный.mkv файл1.mkv + файл2.mkv
$ mkvmerge -o полный.mkv '[' файл1.mkv файл2.mkv ']'

Также можно поставить '=' перед следующим именем файла. Поэтому следующие две команды эквивалентны:

$ mkvmerge -o полный.mkv = файл1.vob
$ mkvmerge -o полный.mkv =файл1.vob

Это можно использовать, например, для файлов VOB, поступающих из транспортных потоков DVD или MPEG. Его нельзя использовать, если каждый файл содержит собственный набор заголовков, что обычно бывает с отдельными файлами, такими как AVI или MP4.

Ввод имени файла в скобки также препятствует поиску mkvmerge(1) дополнительных файлов с таким же базовым названием, как описано в параметре =. Поэтому эти две командные строки эквивалентны:

$ mkvmerge -o выход.mkv = файл.mkv
$ mkvmerge -o выход.mkv '(' файл.mkv ')'

Следует отметить несколько моментов:

Если для вложения не задан тип MIME, то его тип будет определён автоматически.

mkvextract(1) может использоваться для извлечения вложений из файла Matroska.

Это влияет как на новые вложения, если их тип MIME обнаружен автоматически, так и на существующие вложения, чьи сохранённые типы MIME будут заменены устаревшими.

Затрагиваются типы MIME: «font/sfnt», «font/ttf» и «font/collection»; они сопоставляются с «application/x-truetype-fonts» и «font/otf», который сопоставляется с «application/vnd .ms-opentype».

Вместо идентификаторов дорожек вы также можете предоставить коды языков ISO 639-2. Это будет работать только для исходных файлов, которые содержат языковые теги для своих дорожек.

По умолчанию: копировать любые подобные дорожки.

Если идентификаторы имеют префикс !, то значение меняется: копировать все дорожки этого типа, кроме тех, которые перечислены после !.

Вместо идентификаторов дорожек вы также можете предоставить коды языков ISO 639-2. Это будет работать только для исходных файлов, которые содержат языковые теги для своих дорожек.

Если идентификаторы имеют префикс !, то значение меняется: копировать все дорожки этого типа, кроме тех, которые перечислены после !.

Вместо идентификаторов дорожек вы также можете предоставить коды языков ISO 639-2. Это будет работать только для исходных файлов, которые содержат языковые теги для своих дорожек.

Если идентификаторы имеют префикс !, то значение меняется: копировать все дорожки этого типа, кроме тех, которые перечислены после !.

Вместо идентификаторов дорожек вы также можете предоставить коды языков ISO 639-2. Это будет работать только для исходных файлов, которые содержат языковые теги для своих дорожек.

Если идентификаторы имеют префикс !, то значение меняется: копировать все дорожки этого типа, кроме тех, которые перечислены после !.

Если идентификаторы имеют префикс !, то значение разворачиваются: копировать всё кроме идентификаторов, перечисленных после !.

По умолчанию копирует все вложения во все выходные файлы.

Если идентификаторы имеют префикс !, то значение разворачиваются: копировать всё кроме идентификаторов, перечисленных после !.

o/p: поправка временных меток с помощью o/p, чтобы исправить линейные смещения. По умолчанию в случае пропуска p равно 1. И o и p могут быть числами с плавающей запятой.

По умолчанию: ручная коррекция синхронизации отключена (что равноценно d = 0 и o/p = 1.0).

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

По умолчанию — «iframes» для дорожек видео и субтитров и «none» для звуковых дорожек. Смотрите также параметр --no-cues, который препятствует созданию записей cue, независимо от используемых параметров --cues.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Если пользователь явно не выбирает дорожку во время воспроизведения, проигрыватель должен выбрать одну из дорожек, для которой установлен флаг «дорожка по умолчанию», учитывая, например, такие предпочтения пользователя, как язык.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Для воспроизведения следует рассматривать только дорожки, для которых установлен флаг «дорожка включена».

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Если исходным файлом является файл Matroska, то CodecID должно быть достаточно для обнаружения SBR AAC. Однако, если CodecID неправильный, то этот переключатель можно использовать, чтобы исправить его.

Если mkvmerge неверно определяет файл AAC в виде SBR, то вы можете добавить ':0' к идентификатору дорожки.

Currently only DTS tracks are affected by this option. TrueHD tracks that contain an embedded AC-3 core are instead presented as two separate tracks for which the user can select which track to copy. For DTS such a scheme would not work as the HD extensions cannot be decoded by themselves – unlike the TrueHD data.

На данный момент этот параметр влияет только на дорожки AC-3, DTS и TrueHD.

Если длительность по умолчанию не является принудительной, mkvmerge попытается получить длительность дорожки по умолчанию из контейнера и/или закодированного битового потока для определённых типов дорожек, например, AVC/H.264 или MPEG-2.

Этот параметр также может быть использован для изменения частоты кадров видеодорожек без необходимости использования внешнего файла временных меток.

Метод сжатия «mpeg4_p2»/«mpeg4p2» является специальным методом сжатия, который называется «удаление заголовка» и доступен только для видеодорожек MPEG4 part 2.

По умолчанию для некоторых типов субтитров используется сжатие «zlib». Этот метод сжатия поддерживает большинство, если не все программы воспроизведения. Поддержка других методов сжатия, кроме «none», не гарантируется.

Другим способом указания значений является использование параметра --aspect-ratio или --aspect-ratio-factor (см. ниже). Эти параметры являются взаимоисключающими.

Другим способом указать значения является использование параметров --aspect-ratio-factor или --display-dimensions (см. выше и ниже). Эти параметры являются взаимоисключающими.

Другим способом указать значения является использование параметров --aspect-ratio или --display-dimensions (см. выше и ниже). Эти параметры являются взаимоисключающими.

Допустимые значения и их расшифровка:

0: GBR, 1: BT709, 2: unspecified, 3: reserved, 4: FCC, 5: BT470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: YCOCG, 9: BT2020 non-constant luminance, 10: BT2020 constant luminance

Пример: Для видео с цветовая субдискретизация 4:2:0 следует указать параметр TID:1,1.

Пример: для видео с цветовой субдискретизацией 4:2:1, параметр --chroma-subsample должен быть установлен до TID:1,0 и подвыборка Cb должна быть установлена до TID:1,0.

Допустимые значения и их расшифровка:

0: reserved, 1: ITU-R BT.709, 2: unspecified, 3: reserved, 4: gamma 2.2 curve, 5: gamma 2.8 curve, 6: SMPTE 170M, 7: SMPTE 240M, 8: linear, 9: log, 10: log sqrt, 11: IEC 61966-2-4, 12: ITU-R BT.1361 extended color gamut, 13: IEC 61966-2-1, 14: ITU-R BT.2020 10 bit, 15: ITU-R BT.2020 12 bit, 16: SMPTE ST 2084, 17: SMPTE ST 428-1; 18: ARIB STD-B67 (HLG)

Допустимые значения и их расшифровка:

0: reserved, 1: ITU-R BT.709, 2: unspecified, 3: reserved, 4: ITU-R BT.470M, 5: ITU-R BT.470BG, 6: SMPTE 170M, 7: SMPTE 240M, 8: FILM, 9: ITU-R BT.2020, 10: SMPTE ST 428-1, 22: JEDEC P22 phosphors

0: progressive; 1: interlaced with top field displayed first and top field stored first; 2: undetermined field order; 6: interlaced with bottom field displayed first and bottom field stored first; 9: interlaced with bottom field displayed first and top field stored first; 14: interlaced with top field displayed first and bottom field stored first

Этот параметр можно использовать несколько раз для входного файла, применяемого к нескольким дорожкам, с указанием разных идентификаторов дорожек.

Формат вывода результата может быть изменён параметром --identification-format.

Если известно, что дорожки присутствуют, но не найдены, то процент для проверки можно изменить с помощью этого параметра. Минимальный размер 10 МБ является встроенным и не может быть изменён.

Выбор "самого низкого" также приводит к тому, что mkvmerge(1) выбирает приоритет холостого ввода-вывода в дополнение к самому низкому возможному приоритету процесса.

Зерно может быть произвольной строкой и не обязательно должно быть числом.

Результат работы байт-идентичных файлов гарантируется только при следующих условиях:

Использование других версий mkvmerge(1) или других параметров командной строки может выдать тот же файл, идентичный до байта, но это не гарантируется.

$ mkvmerge -i v.mkv
Файл 'v.mkv': контейнер Matroska
ID дорожки 0: video (V_MS/VFW/FOURCC, DIV3)
ID дорожки 1: audio (A_MPEG/L3)

CHAPTER01=00:00:00.000
CHAPTER01NAME=Intro
CHAPTER02=00:02:30.000
CHAPTER02NAME=Baby prepares to rock
CHAPTER03=00:02:42.300
CHAPTER03NAME=Baby rocks the house

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE Chapters SYSTEM "matroskachapters.dtd">
<Chapters>


  <EditionEntry>


    <ChapterAtom>


      <ChapterTimeStart>00:00:30.000</ChapterTimeStart>


      <ChapterTimeEnd>00:01:20.000</ChapterTimeEnd>


      <ChapterDisplay>


        <ChapterString>A short chapter</ChapterString>


        <ChapterLanguage>eng</ChapterLanguage>


      </ChapterDisplay>


      <ChapterAtom>


        <ChapterTimeStart>00:00:46.000</ChapterTimeStart>


        <ChapterTimeEnd>00:01:10.000</ChapterTimeEnd>


        <ChapterDisplay>


          <ChapterString>A part of that short chapter</ChapterString>


          <ChapterLanguage>eng</ChapterLanguage>


        </ChapterDisplay>


      </ChapterAtom>


    </ChapterAtom>


  </EditionEntry>
</Chapters>

Chapters (master)


  EditionEntry (master)


    EditionUID (unsigned integer, valid range: 1 <= value)


    EditionFlagHidden (unsigned integer, valid range: 0 <= value <= 1)


    EditionFlagDefault (unsigned integer, valid range: 0 <= value <= 1)


    EditionFlagOrdered (unsigned integer, valid range: 0 <= value <= 1)


    ChapterAtom (master)


      ChapterAtom (master)


      ChapterUID (unsigned integer, valid range: 1 <= value)


      ChapterTimeStart (unsigned integer)


      ChapterTimeEnd (unsigned integer)


      ChapterFlagHidden (unsigned integer, valid range: 0 <= value <= 1)


      ChapterFlagEnabled (unsigned integer, valid range: 0 <= value <= 1)


      ChapterSegmentUID (binary, valid range: 1 <= length in bytes)


      ChapterSegmentEditionUID (unsigned integer, valid range: 1 <= value)


      ChapterPhysicalEquiv (unsigned integer)


      ChapterTrack (master)


        ChapterTrackNumber (unsigned integer, valid range: 1 <= value)


      ChapterDisplay (master)


        ChapterString (UTF-8 string)


        ChapterLanguage (UTF-8 string)


        ChapterCountry (UTF-8 string)


      ChapterProcess (master)


        ChapterProcessCodecID (unsigned integer)


        ChapterProcessPrivate (binary)


        ChapterProcessCommand (master)


          ChapterProcessTime (unsigned integer)


          ChapterProcessData (binary)

$ mkvmerge -o файл.mkv --tags 0:теги.xml файл.avi

Tags (master)


  Tag (master)


    Targets (master)


      TargetTypeValue (unsigned integer)


      TargetType (UTF-8 string)


      TrackUID (unsigned integer)


      EditionUID (unsigned integer)


      ChapterUID (unsigned integer)


      AttachmentUID (unsigned integer)


    Simple (master)


      Simple (master)


      Name (UTF-8 string)


      TagLanguage (UTF-8 string)


      DefaultLanguage (unsigned integer)


      String (UTF-8 string)


      Binary (binary)

# timestamp format v1
assume 27.930
800,1000,25
1500,1700,30

# timestamp format v2
0
40
80

# timestamp format v3
assume 0.0
25.325
7.530,38.236
gap, 10.050
2.000,38.236