MKVPROPEDIT(1) | 사용자 명령어 | MKVPROPEDIT(1) |
NAME¶
mkvpropedit - 완전한 remux 없이 기존 Matroska 파일의 속성 수정
개요¶
mkvpropedit [options] {source-filename} {actions}
설명¶
이 프로그램은 기존 Matroska 파일을 분석하고 일부 속성을 수정합니다. 그런 다음 수정 사항을 기존 파일에 기록합니다. 변경할 수 있는 속성에는 세그먼트 정보 요소(예: 제목)와 트랙 헤더(예: 언어 코드, '기본 트랙' 플래그 또는 이름)가 있습니다.
옵션:
-l, --list-property-names
-p, --parse-mode mode
트랙 및 세그먼트 정보 속성을 다루는 작업:
-e, --edit selector
기본적으로 mkvpropedit(1)는 세그먼트 정보 섹션을 편집합니다.
구문에 대한 전체 설명은 edit selectors섹션을 참조하십시오.
-a, --add name=value
-s, --set name=value
-d, --delete name
태그 및 장을 처리하는 작업:
-t, --tags selector:filename
selector는 all, global 또는 track 단어 중 하나여야 합니다. all의 경우 mkvpropedit(1)는 파일의 모든 태그를 바꾸거나 제거합니다. global을 사용할 경우 global 태그만 교체되거나 제거됩니다.
track을 사용하면 mkvpropedit(1)가 특정 트랙의 태그를 대체합니다. 또한 filename에서 읽은 태그가 동일한 트랙에 할당됩니다. 트랙은 edit selectors가 지정된 것과 동일한 방식으로 지정됩니다(아래 참조). 예를 들어 --tags track:a1:new-audio-tags.xml입니다.
--add-track-statistics-tags
--delete-track-statistics-tags
-c, --chapters filename
첨부 파일 처리 동작:
--add-attachment filename
--attachment-name 옵션이 이 선택사항 이전에 사용된 경우, 해당 값은 새 첨부 파일의 이름으로 사용됩니다. 그렇지 않으면 filename에서 파생됩니다.
--attachment-mime-type 선택사항이 이 선택사항 이전에 사용된 경우, 해당 값은 새로운 첨부파일의 MIME 유형으로 사용됩니다. 그렇지 않으면 filename의 내용에서 자동으로 탐지됩니다.
--attachment-description 옵션이 이 선택사항 이전에 사용된 경우, 해당 값은 새 첨부 파일의 설명으로 사용됩니다. 그렇지 않으면 설명이 설정되지 않습니다.
--attachment-uid 옵션이 이 선택사항 이전에 사용된 경우, 해당 값은 새 첨부 파일의 UID로 사용됩니다. 그렇지 않으면 랜덤 UID가 자동으로 생성됩니다.
--replace-attachment selector:filename
selector는 네 가지 형태 중 하나를 가질 수 있습니다. 아래 attachment selectors 섹션에서 설명합니다.
--attachment-name 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일의 새 이름으로 설정됩니다. 그렇지 않으면 이름이 바뀌지 않습니다.
--attachment-mime-type 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일에 대한 새 MIME 유형으로 설정됩니다. 그렇지 않으면 MIME 유형은 변경되지 않습니다.
--attachment-description 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일에 대한 새 설명으로 설정됩니다. 그렇지 않으면 설명이 변경되지 않습니다.
--attachment-uid 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일의 새 UID로 설정됩니다. 그렇지 않으면 UIDs가 바뀌지 않습니다.
--update-attachment selector
selector는 네 가지 형태 중 하나를 가질 수 있습니다. 아래 attachment selectors 섹션에서 설명합니다.
--attachment-name 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일의 새 이름으로 설정됩니다. 그렇지 않으면 이름이 바뀌지 않습니다.
--attachment-mime-type 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일에 대한 새 MIME 유형으로 설정됩니다. 그렇지 않으면 MIME 유형은 변경되지 않습니다.
--attachment-description 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일에 대한 새 설명으로 설정됩니다. 그렇지 않으면 설명이 변경되지 않습니다.
--attachment-uid 옵션이 이 선택사항 이전에 사용된 경우, 이 값은 수정된 각 첨부파일의 새 UID로 설정됩니다. 그렇지 않으면 UIDs가 바뀌지 않습니다.
--delete-attachment selector
selector는 네 가지 형태 중 하나를 가질 수 있습니다. 아래 attachment selectors 섹션에서 설명합니다.
첨부 작업 옵션:
--attachment-name name
--attachment-mime-type mime-type
--attachment-description 설명
--enable-legacy-font-mime-types
이것은 새 첨부 파일 추가 및 기존 첨부 파일 교체 모두에 영향을 미치지만, 새 MIME 유형이 지정되지 않은 경우에만 적용됩니다. 다른 기존 첨부 파일은 변경되지 않습니다.
영향을 받는 MIME 유형은 'application/x-truetype-fonts'에 매핑된 'font/sfnt'와 'font/ttf', 'font/collection'이고 'application/vnd.ms-opentype'에 매핑된 'font/otf' 입니다.
다른 옵션:
--disable-language-ietf
이 옵션은 language-ietf 트랙 헤더 속성을 통해 요청된 변경에는 영향을 주지 않습니다.
--normalize-language-ietf mode
표준 형식에서 기본값이 존재하는 모든 하위 태그는 해당 기본 값으로 대체됩니다. 이를 통해 'zh-yue-jyutping'을 'yue-jyutping'으로 변환하거나 'fr-FX'를 'fr-FR'로 변환합니다.
확장 언어 하위 태그 형식의 경우 표준 형식이 먼저 구축됩니다. 나중에 확장 언어 하위 태그가 존재하는 모든 기본 언어는 확장 언어 하위 태그와 접두사로 대체됩니다. 예를 들면 'yue-jyutping'을 'zh-yue-jyutping'으로 다시 변환하지만 'fr'은 확장 언어 하위 태그가 아니기 때문에 'fr-FR'에는 영향을 미치지 않습니다.
이 정규화는 실제로 변경된 요소에만 적용됩니다:
파일의 모든 기존 언어 태그를 정규화하는 가장 좋은 방법은 mkvmerge(1)로 remux하고 '--normalize-language-ietf' 옵션을 원하는 모드로 설정하는 것입니다.
--command-line-charset 문자셋
--output-charset 문자셋
-r, --redirect-output 파일명
--ui-language 코드
--abort-on-warnings
--debug 토픽
--engage 기능
--gui-mode
-v, --verbose
-h, --help
-V, --version
@옵션 파일.json
선택기 편집¶
--edit 옵션은 다음과 같은 모든 add, set 및 delete 작업이 작동하는 Matroska 파일 섹션(세그먼트 정보 또는 특정 트랙의 헤더)을 설정합니다. 이것은 다음 --edit 선택사항을 찾을 때까지 유효합니다. 이 옵션의 인수를 편집 선택기라고 합니다.
기본적으로 mkvpropedit(1)는 세그먼트 정보 섹션을 편집합니다.
세그먼트 정보¶
세그먼트 정보는 'info', 'segment_info' 또는 'segmentinfo'의 세 단어 중 하나로 선택할 수 있습니다. 세그먼트 제목 또는 세그먼트 UID와 같은 속성을 포함합니다.
트랙 헤더¶
트랙 헤더는 조금 더 복잡한 선택기로 선택할 수 있습니다. 모든 변형은 'track:'로 시작합니다. 트랙 헤더 속성에는 언어 코드, '기본 트랙' 플래그 또는 트랙 이름과 같은 요소가 포함됩니다.
track:n
번호는 1부터 시작입니다.
track:tn
번호는 1부터 시작입니다.
track:=uid
track:@number
주의¶
트랙 편집 선택기의 특성상 여러 선택기가 실제로 동일한 트랙 헤더와 일치할 수 있습니다. 이러한 경우 편집 선택기에 대한 모든 작업은 명령줄에 지정된 순서대로 결합되고 실행됩니다.
첨부 파일 선택기¶
첨부 파일 선택기는 --replace-attachment 및 --delete-attachment 두 가지 동작과 함께 사용됩니다. 다음 네 가지 형식 중 하나를 사용할 수 있습니다:
LANGUAGE HANDLING¶
mkvpropedit(1) mostly tries to do the right thing by default. Therefore changes to the language property will cause mkvpropedit(1) to apply the same change to both the new "LanguageIETF" element as well as the old "Language" element similar to how mkvmerge(1) applies the language to both elements. For example, when using mkvpropedit movie.mkv --edit track:2 --set language=zh-TW the "LanguageIETF" element will be set to zh-TW and the old "Language" element to chi.
Additionally there's a new track header property named language-ietf that can be set or removed. Changes to this property only apply to the new "LanguageIETF" track header element. A caveat is that the old "Language" track header element is a mandatory element in Matroska — meaning even if it isn't present in the file it still has an implied value. When the user only sets the language-ietf property but not the language property, mkvpropedit(1) will therefore add the old "Language" element in certain cases & set it to und (meaning "undetermined") as the user didn't specify a value for it.
When reading XML chapter or tag files mkvpropedit(1) works like mkvmerge(1) does.
The creation of the new elements can be disabled completely with the command-line option `--disable-language-ietf` which operates on all three new elements.
You can chose the normalization method applied to extended language sub-tags with the parameter --normalize-language-ietf.
보기¶
다음 예제에서는 'movie.mkv'라는 파일을 편집합니다. 세그먼트 제목을 설정하고 오디오와 자막 트랙의 언어 코드를 수정합니다. 세그먼트 정보 요소를 편집하는 것은 어쨌든 첫 번째 --edit 옵션 이전에 발견된 모든 옵션의 기본값이기 때문에 첫 번째 --edit 옵션을 생략하면 이 예를 단축할 수 있습니다.
$ mkvpropedit movie.mkv --edit info --set "title=The movie" --edit track:a1 --set language=fre --edit track:a2 --set language=ita
두 번째 예는 첫 번째 자막 트랙에서 '기본 트랙 플래그'를 제거하고 두 번째 트랙으로 설정합니다. mkvpropedit(1)는 mkvmerge(1)와 달리 다른 트랙의 '기본 트랙 플래그'가 자동으로 '1'로 설정된 경우 '0'으로 설정되지 않습니다.
$ mkvpropedit movie.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1
파일에서 두 번째 자막 트랙의 태그를 바꾸는 것은 다음과 같습니다.
$ mkvpropedit movie.mkv --tags track:s2:new-subtitle-tags.xml
모든 태그를 제거하려면 파일 이름을 생략해야 합니다.
$ mkvpropedit movie.mkv --tags all:
파일의 장을 바꾸는 것은 다음과 같습니다.
$ mkvpropedit movie.mkv --chapters new-chapters.xml
모든 챕터를 제거하려면 파일 이름을 생략해야 합니다.
$ mkvpropedit movie.mkv --chapters ''
첨부 파일로 글꼴 파일(Arial.ttf) 추가:
$ mkvpropedit movie.mkv --add-attachment Arial.ttf
첨부 파일로 글꼴 파일(89719823.ttf)을 추가하고 실제로 Arial에 해당하는 정보를 제공합니다.
$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf
첨부된 글꼴(Comic.ttf) 파일을 다른 글꼴(Arial.ttf)로 대체하는 경우:
$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --replace-attachment name:Comic.ttf:Arial.ttf
두 번째 첨부 파일 삭제:
$ mkvpropedit movie.mkv --delete-attachment 2
MIME 유형별로 연결된 모든 글꼴 삭제:
$ mkvpropedit movie.mkv --delete-attachment mime-type:application/x-truetype-font
종료 코드¶
mkvpropedit(1) 종료 시 다음 세 가지 종료 코드 중 하나가 표시됩니다.
텍스트 파일과 문자셋 변환¶
MKVToolNix 제품군의 모든 도구가 문자 집합 변환, 입력/출력 인코딩, 명령줄 인코딩 및 콘솔 인코딩을 처리하는 방법에 대한 자세한 내용은 mkvmerge(1) 매뉴얼 페이지에서 동일한 이름의 섹션을 참조하십시오.
환경 변수¶
mkvpropedit(1)는 시스템의 로케일을 결정하는 기본 변수(예: LANG 및 LC_* 제품군)를 사용합니다. 추가 변수:
MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG 와 그 간략한 형태인MTX_DEBUG
MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE 와 그 간략한 형태인 MTX_ENGAGE
더 보기¶
WWW¶
이전 버전은 언제나 MKVToolNix 홈페이지[1]에서 찾을 수 있습니다.
AUTHOR¶
Moritz Bunkus <moritz@bunkus.org>
NOTES¶
- 1.
- MKVToolNix 홈페이지
2024-10-19 | MKVToolNix 88.0 |