MKVEXTRACT(1) Uzivatelske prikazy MKVEXTRACT(1) NAME mkvextract - extrahovat stopy ze souboru Matroska(TM) do jinych souboru PrEHLED mkvextract {source-filename} {mode1} [options] [extraction-spec1] [mode2] [options] [extraction-spec2] [...] POPIS Tento program extrahuje konkretni casti ze souboru Matroska(TM) do jinych uzitecnych formatu. Prvnim argumentem je nazev zdrojoveho souboru, ktery musi byt souborem Matroska(TM). Vsechny ostatni argumenty bud prepinaji do urciteho rezimu extrakce, meni volby aktualne aktivniho rezimu, nebo urcuji, co se ma extrahovat do ktereho souboru. V jednom spusteni mkvextract lze pouzit vice rezimu, coz umoznuje extrahovat vice veci v jedinem pruchodu. Vetsinu voleb lze pouzit pouze v urcitych rezimech; nekolik voleb plati pro vsechny rezimy. V soucasnosti je podporovana extrakce stop, stitku, priloh, kapitol, CUE sheetu, casovych razitek a indexu. Spolecne volby Nasledujici volby jsou dostupne ve vsech rezimech a jsou popsany pouze jednou v tomto oddilu. -f, --parse-fully Nastavuje rezim analyzy na 'full'. Vychozi rezim neanalyzuje cely soubor, ale k nalezeni pozadovanych prvku zdrojoveho souboru pouziva prvky hlavicky vyhledavani. V 99 % vsech pripadu to staci. U souboru, ktere prvky hlavicky vyhledavani neobsahuji nebo jsou poskozene, vsak uzivatel mozna bude muset tento rezim pouzit. Uplna kontrola souboru muze trvat nekolik minut, zatimco rychla kontrola trva jen sekundy. --command-line-charset character-set Nastavuje znakovou sadu, ze ktere se prevadeji retezce zadane na prikazovem radku. Vychozi je znakova sada dana aktualnim narodnim prostredim systemu. --output-charset character-set Nastavuje znakovou sadu, do ktere se prevadeji retezce urcene k vystupu. Vychozi je znakova sada dana aktualnim narodnim prostredim systemu. -r, --redirect-output file-name Zapise vsechny zpravy do souboru file-name misto na konzoli. Ackoli to lze snadno provest presmerovanim vystupu, tato volba je potreba v pripadech, kdy terminal vystup pred zapisem do souboru znovu interpretuje. Je respektovana znakova sada nastavena pomoci --output-charset. --no-bom Textove soubory vytvorene & kodovane v nektere z variant UTF obvykle zacinaji znackou poradi bajtu (BOM). Tato volba zakaze zapis teto znacky poradi bajtu. --flush-on-close Dava programu pokyn, aby pri zavirani souboru otevrenych pro zapis vyprazdnil na uloziste vsechna data ulozena v pameti. Lze tim zabranit ztrate dat pri vypadku napajeni nebo obejit urcite problemy v operacnim systemu ci ovladacich. Nevyhodou je, ze multiplexovani bude trvat dele, protoze mkvmerge pred ukoncenim ceka na zapis vsech dat na uloziste. Podrobnou diskusi o vyhodach a nevyhodach najdete v hlasenich c. 2469 a 2480 ve sledovani chyb MKVToolNix. --ui-language code Vynuti pouziti prekladu pro jazyk code (napr. 'de_DE' pro nemecke preklady). Zadanim 'list' jako code program vypise seznam dostupnych prekladu. --abort-on-warnings Ukonci program po vydani prvniho upozorneni. Navratovy kod programu bude 1. --debug topic Zapne ladeni urcite funkce. Tato volba je uzitecna pouze pro vyvojare. --engage feature Zapne experimentalni funkce. Seznam dostupnych funkci lze vyzadat pomoci mkvextract --engage list. Tyto funkce nejsou urceny pro bezne pouziti. --gui-mode Zapne rezim GUI. V tomto rezimu mohou byt vypisovany specialne formatovane radky, ktere ridicimu GUI sdeluji, co se deje. Tyto zpravy maji format '#GUI#message'. Za zpravou mohou nasledovat dvojice klic/hodnota jako v '#GUI#message#key1=value1#key2=value2...'. Zpravy ani klice se nikdy neprekladaji a vzdy jsou vypisovany anglicky. -v, --verbose Vypisuje podrobne informace a zobrazuje vsechny dulezite prvky Matroska(TM) pri jejich cteni. -h, --help Zobrazi informace o pouziti a ukonci se. -V, --version Zobrazi informace o verzi a ukonci se. @options-file.json Nacte dalsi argumenty prikazoveho radku ze souboru options-file. Uplne vysvetleni podporovanych formatu takovych souboru naleznete v oddilu ,,Option files" manualove stranky mkvmerge(1). Rezim extrakce stop Syntaxe: mkvextract source-filename tracks [options] TID1:dest-filename1 [TID2:dest-filename2 ...] Nasledujici volby prikazoveho radku jsou dostupne pro kazdou stopu v rezimu extrakce 'tracks'. Musi byt uvedeny pred specifikaci stopy (viz nize), na kterou se maji pouzit. -c character-set Nastavuje znakovou sadu, do ktere se ma prevest nasledujici textova titulkova stopa. Plati pouze tehdy, pokud ID nasledujici stopy oznacuje textovou titulkovou stopu. Vychozi je UTF-8. --blockadd level Zachova pouze BlockAdditions az do teto urovne. Vychozi je zachovat vsechny urovne. Tato volba ovlivnuje pouze urcite druhy kodeku, napriklad WAVPACK4. --cuesheet Zpusobi, ze mkvextract(1) extrahuje CUE sheet z informaci o kapitolach a dat stitku nasledujici stopy do souboru, jehoz nazev je vystupnim nazvem stopy s pripojenou priponou '.cue'. --raw Extrahuje surova data do souboru bez okolnich kontejnerovych dat. Na rozdil od volby --fullraw tato volba nezpusobi zapis obsahu prvku CodecPrivate do souboru. Tento rezim funguje se vsemi CodecIDs, dokonce i s temi, ktere mkvextract(1) jinak nepodporuje, ale vysledne soubory nemusi byt pouzitelne. --fullraw Extrahuje surova data do souboru bez okolnich kontejnerovych dat. Obsah prvku CodecPrivate se nejprve zapise do souboru, pokud stopa takovy prvek hlavicky obsahuje. Tento rezim funguje se vsemi CodecIDs, dokonce i s temi, ktere mkvextract(1) jinak nepodporuje, ale vysledne soubory nemusi byt pouzitelne. TID:outname Zpusobi extrakci stopy s ID TID do souboru outname, pokud takova stopa ve zdrojovem souboru existuje. Tuto volbu lze zadat vicekrat. ID stop jsou stejna jako ID vypisovana volbou --identify programu mkvmerge(1). Kazdy vystupni nazev by se mel pouzit pouze jednou. Vyjimkou jsou stopy RealAudio a RealVideo. Pouzijete-li stejny nazev pro ruzne stopy, budou tyto stopy ulozeny do stejneho souboru. Priklad: $ mkvextract input.mkv tracks 0:video.h264 2:output-two-vobsub-tracks.idx 3:output-two-vobsub-tracks.idx Rezim extrakce priloh Syntaxe: mkvextract source-filename attachments [options] AID1:outname1 [AID2:outname2 ...] AID:outname Zpusobi extrakci prilohy s ID AID do souboru outname, pokud takova priloha ve zdrojovem souboru existuje. Zustane-li outname prazdny, pouzije se misto nej nazev prilohy uvnitr zdrojoveho souboru Matroska(TM). Tuto volbu lze zadat vicekrat. ID priloh jsou stejna jako ID vypisovana volbou --identify programu mkvmerge(1). Rezim extrakce kapitol Syntaxe: mkvextract source-filename chapters [options] output-filename.xml -s, --simple Exportuje informace o kapitolach v jednoduchem formatu pouzivanem nastroji OGM (CHAPTER01=..., CHAPTER01NAME=...). V tomto rezimu je nutne nektere informace zahodit. Vychozi je vypis kapitol ve formatu XML. --simple-language language Je-li povolen jednoduchy format, mkvextract(1) vypise pouze jednu polozku pro kazdy nalezeny atom kapitoly, i kdyz atom kapitoly obsahuje vice nez jeden nazev kapitoly. Ve vychozim stavu mkvextract(1) pouzije pro kazdy atom prvni nalezeny nazev kapitoly bez ohledu na jeho jazyk. Pomoci teto volby muze uzivatel urcit, ktere nazvy kapitol se vypisi, pokud atomy obsahuji vice nez jeden nazev kapitoly. Parametr language musi byt kod ISO 639-1 nebo ISO 639-2. Kapitoly se zapisi do zadaneho vystupniho souboru. Vychozi je format XML, kteremu rozumi mkvmerge(1). Nejsou-li v souboru nalezeny kapitoly, vystupni soubor se nevytvori. Rezim extrakce stitku Syntaxe: mkvextract source-filename tags [options] output-filename.xml -T, --no-track-tags Exportuje pouze stitky, ktere nejsou specificke pro stopu. Stitky se zapisi do zadaneho vystupniho souboru ve formatu XML, kteremu rozumi mkvmerge(1). Nejsou-li v souboru nalezeny stitky, vystupni soubor se nevytvori. Rezim extrakce CUE sheetu Syntaxe: mkvextract source-filename cuesheet [options] output-filename.cue CUE sheet se zapise do zadaneho vystupniho souboru. Nejsou-li v souboru nalezeny kapitoly ani stitky, vystupni soubor se nevytvori. Rezim extrakce casovych razitek Syntaxe: mkvextract source-filename timestamps_v2 [options] TID1:dest-filename1 [TID2:dest-filename2 ...] TID:outname Zpusobi extrakci casovych razitek stopy s ID TID do souboru outname, pokud takova stopa ve zdrojovem souboru existuje. Tuto volbu lze zadat vicekrat. ID stop jsou stejna jako ID vypisovana volbou --identify programu mkvmerge(1). Priklad: $ mkvextract input.mkv timestamps_v2 1:ts-track1.txt 2:ts-track2.txt Rezim extrakce indexu Syntaxe: mkvextract source-filename cues [options] TID1:dest-filename1 [TID2:dest-filename2 ...] TID:dest-filename Zpusobi extrakci indexu stopy s ID TID do souboru outname, pokud takova stopa ve zdrojovem souboru existuje. Tuto volbu lze zadat vicekrat. ID stop jsou stejna jako ID vypisovana volbou --identify programu mkvmerge(1), nikoli cisla obsazena v prvku CueTrack. Vystupni format je jednoduchy textovy format: jeden radek pro kazdy prvek CuePoint s dvojicemi key=value. Neni-li v prvku CuePoint pritomen volitelny prvek (napr. CueDuration), vypise se jako hodnota pomlcka. Priklad: timestamp=00:00:13.305000000 duration=- cluster_position=757741 relative_position=11 Mozne klice jsou: timestamp Casove razitko bodu indexu s presnosti na nanosekundy. Format je HH:MM:SS.nnnnnnnnn. Tento prvek je vzdy nastaven. duration Delka bodu indexu s presnosti na nanosekundy. Format je HH:MM:SS.nnnnnnnnn. cluster_position Absolutni pozice v bajtech uvnitr souboru Matroska(TM), kde zacina cluster obsahujici odkazovany prvek. Note Uvnitr souboru Matroska(TM) je CueClusterPosition relativni vuci pocatecnimu posunu dat useku. Hodnota vypisovana rezimem extrakce indexu programu mkvextract(1) vsak jiz tento posun obsahuje a je absolutnim posunem od zacatku souboru. relative_position Relativni pozice v bajtech uvnitr clusteru, kde zacina prvek BlockGroup nebo SimpleBlock, na ktery bod indexu odkazuje. Note Uvnitr souboru Matroska(TM) je CueRelativePosition relativni vuci pocatecnimu posunu dat clusteru. Hodnota vypisovana rezimem extrakce indexu programu mkvextract(1) je vsak relativni vuci ID clusteru. Absolutni pozici uvnitr souboru lze vypocitat sectenim cluster_position a relative_position. Priklad: $ mkvextract input.mkv cues 1:cues-track1.txt 2:cues-track2.txt PriKLADY Soucasna extrakce kapitol a stitku v prislusnych formatech XML: $ mkvextract movie.mkv chapters movie-chapters.xml tags movie-tags.xml Soucasna extrakce nekolika stop a jejich prislusnych casovych razitek: $ mkvextract "Another Movie.mkv" tracks 0:video.h265 "1:main audio.aac" "2:director's comments.aac" timestamps_v2 "0:timestamps video.txt" "1:timestamps main audio.txt" "2:timestamps director's comments.txt" Extrakce kapitol ve formatu Ogg/OGM a prekodovani textove titulkove stopy do jine znakove sady: $ mkvextract "My Movie.mkv" chapters --simple "My Chapters.txt" tracks -c MS-ANSI "2:My Subtitles.srt" TEXTOVe SOUBORY A PrEVODY ZNAKOVyCH SAD Podrobnou diskusi o zpusobu, jakym vsechny nastroje sady MKVToolNix pracuji s prevody znakovych sad, kodovanim vstupu/vystupu, prikazoveho radku a konzole, naleznete ve stejnojmennem oddilu manualove stranky mkvmerge(1). FORMaTY VySTUPNiCH SOUBORu Rozhodnuti o vystupnim formatu je zalozeno na typu stopy, nikoli na pripone pouzite pro nazev vystupniho souboru. V soucasnosti jsou podporovany nasledujici typy stop: A_AAC/MPEG2/*, A_AAC/MPEG4/*, A_AAC Vsechny soubory AAC budou zapsany do souboru AAC s hlavickami ADTS pred kazdym paketem. Hlavicky ADTS nebudou obsahovat zastarale pole zdurazneni. A_AC3, A_EAC3 Tyto stopy budou extrahovany do surovych souboru AC-3. A_ALAC Stopy ALAC se zapisuji do souboru CAF. A_DTS Tyto stopy budou extrahovany do surovych souboru DTS. A_FLAC Stopy FLAC se zapisuji do surovych souboru FLAC. A_MPEG/L2 Proudy MPEG-1 Audio Layer II budou extrahovany do surovych souboru MP2. A_MPEG/L3 Tyto stopy budou extrahovany do surovych souboru MP3. A_OPUS Stopy Opus(TM) se zapisuji do souboru OggOpus(TM). A_PCM/INT/LIT, A_PCM/INT/BIG Surova data PCM budou zapsana do souboru WAV. Celociselna data big-endian budou pri zpracovani prevedena na data little-endian. A_REAL/* Stopy RealAudio(TM) se zapisuji do souboru RealMedia(TM). A_TRUEHD, A_MLP Tyto stopy budou extrahovany do surovych souboru TrueHD/MLP. A_TTA1 Stopy TrueAudio(TM) se zapisuji do souboru TTA. Upozornujeme, ze kvuli omezene presnosti casovych razitek Matroska(TM) se hlavicka extrahovaneho souboru bude lisit ve dvou polich: data_length (celkovy pocet vzorku v souboru) a CRC. A_VORBIS Zvuk Vorbis bude zapsan do souboru OggVorbis(TM). A_WAVPACK4 Stopy WavPack(TM) se zapisuji do souboru WV. S_HDMV/PGS Titulky PGS budou zapsany jako soubory SUP. S_HDMV/TEXTST Textove titulky TextST budou zapsany jako zvlastni format souboru vytvoreny pro mkvmerge(1) a mkvextract(1). S_KATE Proudy Kate(TM) budou zapsany v kontejneru Ogg(TM). S_TEXT/SSA, S_TEXT/ASS, S_SSA, S_ASS Textove titulky SSA a ASS budou zapsany jako soubory SSA, resp. ASS. S_TEXT/UTF8, S_TEXT/ASCII Jednoduche textove titulky budou zapsany jako soubory SRT. S_VOBSUB Titulky VobSub(TM) budou zapsany jako soubory SUB spolu s prislusnymi indexovymi soubory IDX. S_TEXT/USF Textove titulky USF budou zapsany jako soubory USF. S_TEXT/WEBVTT Textove titulky WebVTT budou zapsany jako soubory WebVTT. V_MPEG1, V_MPEG2 Video stopy MPEG-1 a MPEG-2 budou zapsany jako elementarni proudy MPEG. V_MPEG4/ISO/AVC Video stopy H.264 / AVC se zapisuji jako elementarni proudy H.264, ktere lze dale zpracovat napriklad programem MP4Box(TM) z baliku GPAC(TM). V_MPEG4/ISO/HEVC Video stopy H.265 / HEVC se zapisuji jako elementarni proudy H.265, ktere lze dale zpracovat napriklad programem MP4Box(TM) z baliku GPAC(TM). V_MS/VFW/FOURCC Video stopy s pevnou FPS s timto CodecID se zapisuji do souboru AVI. V_REAL/* Stopy RealVideo(TM) se zapisuji do souboru RealMedia(TM). V_THEORA Proudy Theora(TM) budou zapsany v kontejneru Ogg(TM) V_VP8, V_VP9 Stopy VP8 / VP9 se zapisuji do souboru IVF. Stitky Stitky jsou prevedeny do formatu XML. Tento format je stejny, jaky mkvmerge(1) podporuje pro cteni stitku. Prilohy Prilohy se zapisuji do vystupniho souboru beze zmeny. Neprovadi se zadny prevod. Kapitoly Kapitoly jsou prevedeny do formatu XML. Tento format je stejny, jaky mkvmerge(1) podporuje pro cteni kapitol. Alternativne lze vypsat zjednodusenou verzi v jednoduchem formatu ve stylu OGM. Casova razitka Casova razitka se nejprve seradi a pak vypisou jako soubor odpovidajici formatu casovych razitek v2, pripraveny pro mkvmerge(1). Extrakce do jinych formatu (v1, v3 a v4) neni podporovana. NaVRATOVe KoDY mkvextract(1) konci jednim ze tri navratovych kodu: o 0 - Tento navratovy kod znamena, ze extrakce byla uspesne dokoncena. o 1 - V tomto pripade mkvextract(1) vypsal alespon jedno upozorneni, ale extrakce pokracovala. Upozorneni ma predponu 'Warning:'. V zavislosti na danych problemech mohou, ale nemusi byt vysledne soubory v poradku. Uzivatel by mel zkontrolovat upozorneni i vysledne soubory. o 2 - Tento navratovy kod se pouzije po vyskytu chyby. mkvextract(1) se ukonci hned po vypsani chybove zpravy. Chybove zpravy sahaji od chybnych argumentu prikazoveho radku pres chyby cteni a zapisu az po poskozene soubory. PROMeNNe PROSTrEDi mkvextract(1) pouziva vychozi promenne urcujici narodni prostredi systemu (napr. LANG a rodinu LC_*). Dalsi promenne: MKVEXTRACT_DEBUG, MKVTOOLNIX_DEBUG a jeji zkraceny tvar MTX_DEBUG Obsah se zpracuje, jako by byl predan pomoci volby --debug. MKVEXTRACT_ENGAGE, MKVTOOLNIX_ENGAGE a jeji zkraceny tvar MTX_ENGAGE Obsah se zpracuje, jako by byl predan pomoci volby --engage. VIZ TAKe mkvmerge(1), mkvinfo(1), mkvpropedit(1), mkvtoolnix-gui(1) WWW Nejnovejsi verzi lze vzdy najit na domovske strance MKVToolNix[1]. AUTHOR Moritz Bunkus Vyvojar NOTES 1. domovske strance MKVToolNix https://mkvtoolnix.download/ MKVToolNix 102.0 2026-09-14 MKVEXTRACT(1)