restructure

This commit is contained in:
JMARyA 2024-01-17 09:00:45 +01:00
parent ef7661245b
commit 598a10bc28
Signed by: jmarya
GPG key ID: 901B2ADDF27C2263
182 changed files with 342 additions and 336 deletions

View file

@ -5,15 +5,15 @@ flatpak-id: org.bunkus.mkvtoolnix-gui
---
# MKVToolnix
MKVToolNix is a set of tools to create, alter and inspect [Matroska](../../media/Matroska.md) files under [Linux](../../linux/Linux.md), other Unixes and [Windows](../../windows/Windows.md).
MKVToolNix is a set of tools to create, alter and inspect [Matroska](../../files/media/Matroska.md) files under [Linux](../../linux/Linux.md), other Unixes and [Windows](../../windows/Windows.md).
## MKVToolnix-GUI
MKVToolnix has a GUI for remuxing and getting information about [Matroska](../../media/Matroska.md) files. Most of the tasks can also be done with the command line (See below).
MKVToolnix has a GUI for remuxing and getting information about [Matroska](../../files/media/Matroska.md) files. Most of the tasks can also be done with the command line (See below).
![Screenshot][Screenshot]
## mkvmerge
This program takes the input from several media files and joins their streams (all of them or just a selection) into a [Matroska](../../media/Matroska.md) file.
This program takes the input from several media files and joins their streams (all of them or just a selection) into a [Matroska](../../files/media/Matroska.md) file.
Usage: `mkvmerge [global options] {-o out} [options1] {file1} [[options2] {file2}] [@options-file.json]`
Instead of specifying the options on the command line, you can put them in a [JSON](../../files/JSON.md) file and use it with `mkvmerge @options-file.json`. The file is an array of options.
@ -85,7 +85,7 @@ CHAPTER03NAME=Alice rocks the house
| `--attachment-description description` | Plain text description of the following attachment. Applies to the next `--attach-file` or `--attach-file-once` option. |
| `--attachment-mime-type MIME type` | [MIME](../../files/MIME.md) type of the following attachment. |
| `--attachment-name name` | Sets the name that will be stored in the output file for this attachment. |
| `--attach-file file-name, --attach-file-once file-name` | Creates a file attachment inside the [Matroska](../../media/Matroska.md) file. The [MIME](../../files/MIME.md) type must have been set before this option can used. |
| `--attach-file file-name, --attach-file-once file-name` | Creates a file attachment inside the [Matroska](../../files/media/Matroska.md) file. The [MIME](../../files/MIME.md) type must have been set before this option can used. |
#### Input File Options
| Option | Description |
@ -110,8 +110,8 @@ CHAPTER03NAME=Alice rocks the house
#### Video Input File Options
| Option | Description |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--display-dimensions TID:widthxheight` | [Matroska](../../media/Matroska.md) files contain two values that set the display properties that a player should scale the image on playback to: display width and display height. These values can be set with this option, e.g. `1:640x480`. |
| `--aspect-ratio TID:ratio/(width/height)` | [Matroska](../../media/Matroska.md) files contain two values that set the display properties that a player should scale the image on playback to: display width and display height. With this option mkvmerge will automatically calculate the display width and display height based on the image's original width and height and the aspect ratio given with this option. The ratio can be given either as a floating point number `ratio` or as a fraction `width/height`, e.g. `16/9`. |
| `--display-dimensions TID:widthxheight` | [Matroska](../../files/media/Matroska.md) files contain two values that set the display properties that a player should scale the image on playback to: display width and display height. These values can be set with this option, e.g. `1:640x480`. |
| `--aspect-ratio TID:ratio/(width/height)` | [Matroska](../../files/media/Matroska.md) files contain two values that set the display properties that a player should scale the image on playback to: display width and display height. With this option mkvmerge will automatically calculate the display width and display height based on the image's original width and height and the aspect ratio given with this option. The ratio can be given either as a floating point number `ratio` or as a fraction `width/height`, e.g. `16/9`. |
#### Other Options
| Option | Description |
@ -122,7 +122,7 @@ CHAPTER03NAME=Alice rocks the house
| `--list-languages` | Lists all languages and their ISO 639-2 code which can be used with the `--language` option. |
## mkvinfo
This program lists all elements contained in a [Matroska](../../media/Matroska.md). The output can be limited to a list of tracks in the file including information about the [codecs](../../media/Codecs.md) used.
This program lists all elements contained in a [Matroska](../../files/media/Matroska.md). The output can be limited to a list of tracks in the file including information about the [codecs](../../files/media/Codecs.md) used.
Usage: `mkvinfo [options] {source-filename}`
### Options
@ -134,7 +134,7 @@ Usage: `mkvinfo [options] {source-filename}`
| `-z, --size` | Show the size of each element including its header. |
## mkvextract
This program extracts specific parts from a [Matroska](../../media/Matroska.md) file to other useful formats. The first argument is the name of the source file which must be a [Matroska](../../media/Matroska.md) file.
This program extracts specific parts from a [Matroska](../../files/media/Matroska.md) file to other useful formats. The first argument is the name of the source file which must be a [Matroska](../../files/media/Matroska.md) file.
Usage: `mkvextract {source-filename} {mode1} [options] [extraction-spec1] [mode2] [options] [extraction-spec2] […]`
### Extract Tracks
@ -151,7 +151,7 @@ Usage: `mkvextract source-filename chapters [options] output-filename.xml`
Usage: `mkvextract source-filename tags [options] output-filename.xml`
## mkvpropedit
This program analyses an existing [Matroska](../../media/Matroska.md) file and modifies some of its properties. Then it writes those modifications to the existing file. Among the properties that can be changed are the segment information elements (e.g. the title) and the track headers (e.g. the language code, 'default track' flag or the name).
This program analyses an existing [Matroska](../../files/media/Matroska.md) file and modifies some of its properties. Then it writes those modifications to the existing file. Among the properties that can be changed are the segment information elements (e.g. the title) and the track headers (e.g. the language code, 'default track' flag or the name).
Usage: `mkvpropedit [options] {source-filename} {actions} `
### Options
@ -162,7 +162,7 @@ Usage: `mkvpropedit [options] {source-filename} {actions} `
#### Track and segment info properties:
| Option | Description |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-e, --edit selector` | Sets the [Matroska](../../media/Matroska.md) file section (segment information or a certain track's headers) that all following add, set and delete actions operate on. This option can be used multiple times in order to make modifications to more than one element.<br>This stays valid until the next `--edit` option is found<br>`selector` has the `track:n` format. |
| `-e, --edit selector` | Sets the [Matroska](../../files/media/Matroska.md) file section (segment information or a certain track's headers) that all following add, set and delete actions operate on. This option can be used multiple times in order to make modifications to more than one element.<br>This stays valid until the next `--edit` option is found<br>`selector` has the `track:n` format. |
| `-a, --add name=value` | Adds a property `name` with the value `value`. The property will be added even if such a property exists already. Note that most properties are unique and cannot occur more than once. |
| `-s, --set name=value` | Sets all occurrences of the property `name` to the value `value`. If no such property exists then it will be added. |
| `-d, --delete name` | Deletes all occurrences of the property `name`. Note that some properties are required and cannot be deleted. |