mkvinfo -- Print information about elements in Matroska files

mkvinfo -- Print information about elements in Matroska(tm) files

# 1. 개요

mkvinfo [options] {source-filename}

# 2. 설명

This program lists all elements contained in a Matroska(tm). The output can be limited to a list of tracks in the file including information about the codecs used.

Option | Description
--- | ---
-g, --gui | Start the GUI. This option is only available if mkvinfo was compiled with GUI support.
-c, --checksums | Calculates and display the Adler32 checksum for each frame. Useful for debugging only.
-s, --summary | Only show a terse summary of what mkvinfo(1) finds and not each element.
-t, --track-info | Show statistics for each track in verbose mode. Also sets verbosity to 1 if it was at level 0 before.
-x, --hexdump | 각 프레임의 처음 16바이트를 16진수 덤프로 표시합니다.
-X, --full-hexdump | 각 프레임의 모든 바이트를 16진수 덤프로 표시합니다.
-z, --size | 헤더를 포함한 각 요소의 크기를 표시합니다.
--command-line-charset 문자셋 | 명령행에 주어진 문자열을 변환할 문자셋을 정합니다. 기본값은 현재 시스템 로케일에 따른 문자셋입니다.
--output-charset 문자셋 | 출력할 문자열을 변환할 문자셋을 정합니다. 기본값은 현재 시스템 로케일에 따른 문자셋입니다.
-r, --redirect-output 파일명 | Writes all messages to the file file-name instead of to the console. While this can be done easily with output redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file. The character set set with --output-charset is honored.
--ui-language 코드 | Forces the translations for the language code to be used (e.g. 'de_DE' for the German translations). It is preferable to use the environment variables LANG, LC_MESSAGES and LC_ALL though. Entering 'list' as the code will cause mkvinfo(1) to output a list of available translations.
--debug 토픽 | 특정 기능에 대해 디버깅을 켭니다. 이 기능은 개발자에게만 유용합니다.
--engage 기능 | Turn on experimental features. A list of available features can be requested with mkvinfo --engage list. These features are not meant to be used in normal situations.
--gui-mode | GUI 모드를 켭니다. 이 모드에서는 GUI 동작시 무슨 일이 일어나는지 알려줄 수 있는 특별하게 형식화된 줄을 출력할 것입니다. 이 메시지들은 '#GUI#message' 형식을 따릅니다. 이 메시지 뒤에 '#GUI#message#key1=value1#key2=value2…' 형태의 키/값 쌍이 붙을 수 있습니다. 메시지나 키값들은 결코 번역되지 않고 항상 영어로 출력됩니다. This switch has nothing to do with the --gui parameter which causes mkvinfo to display its own GUI.
-v, --verbose | Be more verbose. See the section about verbosity levels for a description which information will be output at which level.
-h, --help | 사용법에 관한 정보를 표시하고 종료합니다.
-V, --version | 버전 정보를 표시하고 종료합니다.

--check-for-updates

http://mkvtoolnix-releases.bunkus.org/latest-release.xml URL을 다운로드하여 새로운 버전이 나왔는지 온라인에서 확인합니다. key=value 스타일의 네 줄이 출력될 것입니다: 정보를 검색하는 주소 (key version_check_url), 현재 실행 중인 버전 (key running_version), 가장 최근에 나온 버전 (key available_version), 다운로드 URL (key download_url).

이후에 프로그램은 이용 가능한 새 버전이 없으면 0, 새 버전이 있으면 1, 오류 발생시(업데이트 정보를 가져올 수 없는 경우)는 2의 종료 코드를 가지고 있습니다.

이 옵션은 libcurl을 지원하도록 프로그램을 만든 경우에만 이용 가능합니다.

@옵션 파일

options-file 파일에서 추가적인 명령행 인수를 읽습니다. 공백이 아닌 첫번째 문자가 해쉬 표시('#')인 줄은 주석으로 간주하여 무시합니다. 줄의 앞과 끝의 공백은 제거될 것입니다. 각 줄에는 반드시 한 개의 옵션을 포함해야 합니다.

Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in the section about escaping text.

The command line 'mkvinfo -v -v input.mkv --redirect-output info.txt' could be converted into the following option file:

    # Be more verbose
    -v
    -v
    # Parse input.mkv
    input.mkv
    # and write the output to info.txt
    --redirect-output
    info.txt

# 3. Verbosity levels

The -v option can be used to increase mkvinfo(1)'s verbosity level and print more information about the current file.

At level 0 mkvinfo(1) will print only the track headers it finds and their types. mkvinfo(1) will exit as soon as the headers are parsed completely (more technical: as soon as the first cluster is encountered). In this level the seek head entries and the cues will not be displayed -- even if they're located in front of the track information.

At level 1 mkvinfo(1) will also print all Matroska(tm) elements encountered for the complete file but the seek head entries and the cue entries. If the summary mode is enabled then mkvinfo(1) will output the frame position as well.

At level 2 mkvinfo(1) will also print the seek head entries, the cue entries and the file position at which each Matroska(tm) element can be found at.

At level 3 and above mkvinfo(1) will print some information that is not directly connected to a Matroska(tm) element. All other elements only print stuff about the elements that were just found. Level 3 adds meta information to ease debugging (read: it's intended for developers only). All lines written by level 3 are enclosed in square brackets to make filtering them out easy.

# 4. Text files and character set conversions

For an in-depth discussion about how all tools in the MKVToolNix suite handle character set conversions, input/output encoding, command line encoding and console encoding please see the identically-named section in the mkvmerge(1) man page.

# 5. 종료 코드

mkvinfo(1) exits with one of three exit codes:

- 0 -- This exit codes means that the run has completed successfully.

- 1 -- In this case mkvinfo(1) has output at least one warning, but the run did continue. A warning is prefixed with the text 'Warning:'.

- 2 -- This exit code is used after an error occurred. mkvinfo(1) aborts right after outputting the error message. Error messages range from wrong command line arguments over read/write errors to broken files.

# 6. Escaping special chars in text

There are a few places in which special characters in text must or should be escaped. The rules for escaping are simple: each character that needs escaping is replaced with a backslash followed by another character.

The rules are: ' ' (a space) becomes '\s', '"' (double quotes) becomes '\2', ':' becomes '\c', '#' becomes '\h' and '\' (a single backslash) itself becomes '\\'.

# 7. Environment variables

mkvinfo(1) uses the default variables that determine the system's locale (e.g. LANG and the LC_* family). Additional variables:

Option | Description
--- | ---
MKVINFO_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG | The content is treated as if it had been passed via the --debug option.
MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE | The content is treated as if it had been passed via the --engage option.
MKVINFO_OPTIONS, MKVTOOLNIX_OPTIONS and its short form MTX_OPTIONS | The content is split on white space. The resulting partial strings are treated as if it had been passed as command line options. If you need to pass special characters (e.g. spaces) then you have to escape them (see the section about escaping special characters in text).

# 8. 더 보기

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

# 9. WWW

The latest version can always be found at the MKVToolNix homepage.