MKVEXTRACT(1) Komendy uzytkownika MKVEXTRACT(1) NAZWA mkvextract - wyodrebnia sciezki z plikow Matroska(TM) do innych plikow SZABLON LINII KOMEND mkvextract {source-filename} {mode1} [options] [extraction-spec1] [mode2] [options] [extraction-spec2] [...] OPIS Ten program wyodrebnia okreslone fragmenty z pliku Matroska(TM) do innych uzytecznych formatow. Pierwszy argument to nazwa pliku zrodlowego, ktory musi byc plikiem Matroska(TM). Wszystkie pozostale argumenty albo przelaczaja na okreslony tryb ekstrakcji, zmieniaja opcje dla aktualnie aktywnego trybu, albo okreslaja, co ma zostac wyodrebnione do ktorego pliku. W jednym wywolaniu programu mkvextract mozna uzyc wielu trybow, co pozwala na wyodrebnienie wielu elementow w jednym przebiegu. Wiekszosc opcji mozna uzyc tylko w okreslonych trybach, a kilka opcji ma zastosowanie do wszystkich trybow. Obecnie obslugiwane jest wyodrebnianie sciezek, tagow, zalacznikow, rozdzialow, arkuszy CUE, znacznikow czasu i podpowiedzi. Opcje podstawowe Nastepujace opcje sa dostepne we wszystkich trybach i zostaly opisane tylko raz w tej sekcji. -f, --parse-fully Ustawia tryb analizy na ,,pelny". Domyslny tryb nie analizuje calego pliku, ale wykorzystuje elementy meta-seek do lokalizowania wymaganych elementow pliku zrodlowego. W 99% przypadkow to wystarcza. Jednak w przypadku plikow, ktore nie zawieraja elementow meta-seek lub sa uszkodzone, uzytkownik moze byc zmuszony do uzycia tego trybu. Pelne skanowanie pliku moze zajac kilka minut, podczas gdy szybkie skanowanie zajmuje tylko kilka sekund. --command-line-charset zestaw-znakow Ustawia zestaw znakow, z ktorego konwertowane sa ciagi znakow podane w wierszu polecen. Domyslnie jest to zestaw znakow okreslony przez biezaca lokalizacje systemu. --output-charset zestaw-znakow Ustawia zestaw znakow, do ktorego konwertowane sa ciagi znakow przeznaczone do wyprowadzenia. Domyslnie jest to zestaw znakow okreslony przez biezaca lokalizacje systemu. -r, --redirect-output nazwa-pliku Zapisuje wszystkie powiadomienia do pliku nazwa-pliku zamiast do konsoli. Podczas gdy moze byc to robione latwo z przekierowaniem wyjscia, sa przypadki, gdy ta opcja wlasnie jest potrzebna: gdy terminal ponownie interpretuje plik wyjsciowy przed zapisaniem do pliku. Uznawany bedzie zestaw znakow ustawiony z opcja --output-charset. --no-bom Zazwyczaj pliki tekstowe utworzone i zakodowane w jednym z wariantow UTF rozpoczynaja sie od znacznika kolejnosci bajtow (BOM). Uzycie tej opcji wylacza zapisywanie tego znacznika kolejnosci bajtow. --flush-on-close Nakazuje programowi przelanie wszystkich danych z pamieci podrecznej do pamieci masowej podczas zamykania plikow otwartych do zapisu. Mozna tego uzyc, aby zapobiec utracie danych podczas przerw w dostawie pradu lub obejsc pewne problemy z systemem operacyjnym lub sterownikami. Wada jest to, ze multipleksowanie bedzie trwalo dluzej, poniewaz program mkvmerge bedzie czekal, az wszystkie dane zostana zapisane w pamieci masowej, zanim zakonczy dzialanie. Szczegolowe omowienie zalet i wad mozna znalezc w zgloszeniach nr 2469 i 2480 w systemie sledzenia bledow MKVToolNix. --ui-language kod Wymusza uzycie tlumaczen dla kodu parameter jezyka (np. "de_DE" dla tlumaczen na jezyk niemiecki). Wprowadzenie "list" jako kodu parameter spowoduje, ze program wyswietli liste dostepnych tlumaczen. --abort-on-warnings Nakazuje programowi przerwanie po wyemitowaniu pierwszego ostrzezenia. Kodem wyjscia programu bedzie 1. --debug temat Wlacz debugowanie dla konkretnej funkcji. Ta opcja jest uzyteczna tylko dla deweloperow. --engage funkcja Wlacz funkcje eksperymentalne. Liste dostepnych funkcji mozna uzyskac za pomoca komendy mkvextract --engage list. Te funkcje nie sa przeznaczone do uzytku w normalnych sytuacjach. --gui-mode Wlacza tryb GUI. W tym trybie moga byc generowane specjalnie sformatowane linie, ktore informuja interfejs GUI o aktualnym stanie rzeczy. Komunikaty te maja formatt '#GUI#message'. Po komunikacie moga nastepowac pary klucz/wartosc, np '#GUI#message#key1=value1#key2=value2...'. Ani komunikaty, ani klucze nie sa tlumaczone i zawsze sa wyswietlane w jezyku angielskim. -v, --verbose Badz szczegolowy i pokazuj wszystkie wazne elementy Matroska(TM) w miare ich czytania. -h, --pomoc Pokaz informacje o sposobie uzycia opcji i wyjdz. -V, --wersja Pokaz informacje o wersji i wyjdz. @options-file.json Odczytuje dodatkowe argumenty wiersza polecen z pliku options-file. Pelny opis obslugiwanych formatow takich plikow znajduje sie w sekcji ,,Pliki opcji" na stronie man programu &mkvmerge;. Tryb wyodrebniania sciezek Skladnia: mkvextract nazwa_pliku_zrodlowego utwory [opcje] TID1:nazwa_pliku_docelowego1 [TID2:nazwa_pliku_docelowego2...] W trybie wyodrebniania,,tracks" dla kazdego utworu dostepne sa nastepujace opcje wiersza polecen. Musza one znajdowac sie przed specyfikacja utworu (patrz ponizej), do ktorego maja zostac zastosowane. -c zestaw-znakow Ustawia zestaw znakow, na ktory ma zostac przekonwertowana nastepna sciezka napisow tekstowych. Opcja ta ma znaczenie tylko wtedy, gdy identyfikator nastepnej sciezki odnosi sie do sciezki napisow tekstowych. Domyslnym ustawieniem jest UTF-8. --blockadd poziom Zachowaj tylko dodatki blokowe do tego poziomu. Domyslnie zachowywane sa wszystkie poziomy. Ta opcja ma wplyw tylko na niektore rodzaje kodekow, takie jak WAVPACK4. --cuesheet Powoduje, ze funkcja `mkvextract` wyodrebnia arkusz CUE na podstawie informacji o rozdziale oraz danych tagow dla danego utworu do pliku, ktorego nazwa sklada sie z nazwy wyjsciowej utworu z dodanym rozszerzeniem ,,.cue". --raw Wyodrebnia surowe dane do pliku bez zadnych danych otaczajacych. W przeciwienstwie do flag --fullraw, ta flaga nie powoduje zapisania zawartosci elementu CodecPrivate do pliku. Tryb ten dziala ze wszystkimi identyfikatorami CodecID, nawet tymi, ktorych &mkvextract; w innym przypadku nie obsluguje, ale powstale pliki moga okazac sie bezuzyteczne. --fullraw Wyodrebnia surowe dane do pliku bez zadnych danych kontenerowych. Jesli sciezka zawiera element naglowkowy CodecPrivate, jego zawartosc zostanie zapisana w pliku jako pierwsza. Tryb ten dziala ze wszystkimi identyfikatorami CodecID, nawet tymi, ktorych funkcja &mkvextract; w innym przypadku nie obsluguje, jednak powstale pliki moga okazac sie bezuzyteczne. TID:nazwa Powoduje wyodrebnienie sciezki o identyfikatorze TID do pliku o nazwie outname, jesli taka sciezka wystepuje w pliku zrodlowym. Opcje te mozna podac wielokrotnie. Identyfikatory sciezek sa takie same jak te wyswietlane przez opcje --identify programu &mkvmerge;. Kazda nazwa pliku wyjsciowego powinna byc uzyta tylko raz. Wyjatkiem sa sciezki RealAudio i RealVideo. Jesli uzyjesz tej samej nazwy dla roznych sciezek, zostana one zapisane w tym samym pliku. Przyklad: $ mkvextract input.mkv tracks 0:video.h264 2:output-two-vobsub-tracks.idx 3:output-two-vobsub-tracks.idx Tryb wyodrebniania zalacznikow Skladnia: mkvextract nazwa_pliku_zrodlowego attachments [opcje] AID1:nazwa_pliku_wynikowego1 [AID2:nazwa_pliku_wynikowego2...] AID:nazwa Powoduje wyodrebnienie zalacznika o identyfikatorze AID do pliku o nazwie outname, o ile taki zalacznik wystepuje w pliku zrodlowym. Jesli nazwa outname zostanie pominieta, uzywana jest zamiast tego nazwa zalacznika zawarta w zrodlowym pliku Matroska. Opcje te mozna podac wielokrotnie. Identyfikatory zalacznikow sa takie same jak te wyswietlane przez opcje --identify programu &mkvmerge;. Tryb wyodrebniania rozdzialow Skladnia: mkvextract nazwa_pliku_zrodlowego rozdzialy opcje nazwa_pliku_wynikowego.xml -s, --simple Eksportuje informacje o rozdzialach w prostym formacie uzywanym w narzedziach OGM (CHAPTER01=..., CHAPTER01NAME=...). W tym trybie niektore informacje musza zostac pominiete. Domyslnie rozdzialy sa wyswietlane w formacie &xml;. --simple-language jezyk Jesli wlaczono tryb uproszczony, polecenie mkvextract(1) wyswietli tylko jeden wpis dla kazdego napotkanego atomu rozdzialu, nawet jesli atom ten zawiera wiecej niz jedna nazwe rozdzialu. Domyslnie polecenie mkvextract(1) wykorzystuje pierwsza znaleziona nazwe rozdzialu dla kazdego atomu, niezaleznie od jezyka. Uzycie tej opcji pozwala uzytkownikowi okreslic, ktore nazwy rozdzialow maja zostac wyswietlone, jesli elementy zawieraja wiecej niz jedna nazwe rozdzialu. Parametr jezyka musi byc kodem zgodnym z norma ISO 639-1 lub ISO 639-2. Rozdzialy sa zapisywane do wskazanego pliku wyjsciowego. Domyslnie stosowany jest format XML, rozpoznawany przez program mkvmerge(1). Jesli w pliku nie znaleziono zadnych rozdzialow, plik wyjsciowy nie zostanie utworzony. Tryb wyodrebniania tagow Skladnia: mkvextract nazwa_pliku_zrodlowego tags [opcje] nazwa_pliku_wynikowego.xml -T, --no-track-tags Eksportuje tylko tagi, ktore nie sa powiazane z konkretnym utworem. Tagi sa zapisywane w okreslonym pliku wyjsciowym w formacie XML, rozpoznawanym przez program mkvmerge(1). Jesli w pliku nie znaleziono zadnych tagow, plik wyjsciowy nie zostanie utworzony. Tryb wyodrebniania arkuszy cue Skladnia: mkvextract nazwa_pliku_zrodlowego [opcje_arkusza_cue] nazwa_pliku_wyjsciowego.cue Lista utworow zostanie zapisana w okreslonym pliku wyjsciowym. Jesli w pliku nie znaleziono zadnych rozdzialow ani tagow, plik wyjsciowy nie zostanie utworzony. Tryb wyodrebniania kodow czasowych Skladnia: mkvextract nazwa_pliku_zrodlowego timestamps_v2 [opcje] TID1:nazwa_pliku_docelowego1 [TID2:nazwa_pliku_docelowego2...] TID:nazwa Powoduje wyodrebnienie znacznikow czasu dla sciezki o identyfikatorze TID do pliku o nazwie outname, o ile taka sciezka wystepuje w pliku zrodlowym. Opcje te mozna podac wielokrotnie. Identyfikatory sciezek sa takie same jak te wyswietlane przez opcje --identify programu &mkvmerge;. Przyklad: $ mkvextract timestamps_v2 wejsciowy.mkv 1:kczas-sciezki1.txt 2:kczas-sciezki2.txt Tryb wyodrebniania indeksow cue Skladnia: mkvextract nazwa_pliku_zrodlowego cues [opcje] TID1:nazwa_pliku_docelowego1 [TID2:nazwa_pliku_docelowego2...] TID:docelowa-nazwapliku Powoduje wyodrebnienie metadanych utworu o identyfikatorze TID do pliku o nazwie outname, o ile taki utwor wystepuje w pliku zrodlowym. Opcje te mozna podac wielokrotnie. Identyfikatory utworow sa takie same jak te wyswietlane przez opcje --identify programu &mkvmerge;, a nie numery zawarte w elemencie CueTrack. Wynik ma postac prostego pliku tekstowego: jeden wiersz na kazdy element CuePoint, zawierajacy pary klucz=wartosc. Jesli w elemencie CuePoint brakuje opcjonalnego elementu (np. CueDuration), jako wartosc zostanie wyswietlony myslnik. Przyklad: timestamp=00:00:13.305000000 duration=- cluster_position=757741 relative_position=11 Mozliwe klucze to: timestamp Sygnatura czasowa punktu kontrolnego z dokladnoscia do nanosekund. Format to HH:MM:SS.nnnnnnnnn. Ten element jest zawsze ustawiony. duration Czas trwania punktu kontrolnego z dokladnoscia do nanosekund. Format to HH:MM:SS.nnnnnnnnn. pozycja_klastra The absolute position in bytes inside the Matroska(TM) file where the cluster containing the referenced element starts. Uwaga Inside the Matroska(TM) file the CueClusterPosition is relative to the segment's data start offset. The value output by mkvextract(1)'s cue extraction mode, however, contains that offset already and is an absolute offset from the beginning of the file. pozycja_wzgledna The relative position in bytes inside the cluster where the BlockGroup or SimpleBlock element the cue point refers to starts. Uwaga Inside the Matroska(TM) file the CueRelativePosition is relative to the cluster's data start offset. The value output by mkvextract(1)'s cue extraction mode, however, is relative to the cluster's ID. The absolute position inside the file can be calculated by adding cluster_position and relative_position. Przyklad: $ mkvextract cues wejsciowy.mkv 1:cues-track1.txt 2:cues-track2.txt PRZYKLADY Jednoczesne wyodrebnianie rozdzialow i tagow w odpowiednich formatach XML $ mkvextract movie.mkv rozdzialy movie-chapters.xml tagi movie-tags.xml Jednoczesne wyodrebnianie kilku utworow i ich znacznikow czasu: $ 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" Extracting chapters in the Ogg/OGM format and re-encoding a text subtitle track to another character set: $ mkvextract "My Movie.mkv" chapters --simple "My Chapters.txt" tracks -c MS-ANSI "2:My Subtitles.srt" PLIKI TEKSTOWE I KONWERSJE ZESTAWOW ZNAKOW Szczegolowe omowienie sposobu, w jaki wszystkie narzedzia w pakiecie MKVToolNix obsluguja konwersje zestawu znakow, kodowanie wejsciowe/wyjsciowe, kodowanie linii komend i kodowanie konsoli, mozna znalezc w sekcji o identycznej nazwie na mkvmerge(1) stronie podrecznika. WYJSCIOWE FORMATY PLIKOW The decision about the output format is based on the track type, not on the extension used for the output file name. The following track types are supported at the moment: A_AAC/MPEG2/*, A_AAC/MPEG4/*, A_AAC Wszystkie pliki AAC beda zapisywane do plikow AAC z naglowkami ADTS przed kazdym pakietem. Naglowki ADTS nie beda zawierac niewspieranego pola emfazy. A_AC3, A_EAC3 Zostana one wyodrebnione do plikow w formacie surowym AC-3. A_ALAC Sciezki ALAC sa zapisywane do plikow CAF. A_DTS Zostana one wyodrebnione do plikow w formacie surowym DTS. A_FLAC Sciezki FLAC sa zapisywane do surowych plikow FLAC. A_MPEG/L2 Sciezki MPEG-1 Audio Layer II beda wyodrebniane do surowych plikow MP2. A_MPEG/L3 Zostana one wyodrebnione do plikow MP3 w formacie surowym. A_OPUS Sciezki Opus(TM) sa zapisywane do plikow OggOpus(TM). A_PCM/INT/LIT, A_PCM/INT/BIG Surowe dane PCM zostana zapisane w pliku WAV. Dane liczbowe w formacie big-endian zostana w trakcie tego procesu przekonwertowane na format little-endian. A_REAL/* Sciezki RealAudio(TM) sa zapisywane do plikow RealMedia(TM). A_TRUEHD, A_MLP Zostana one wyodrebnione do plikow w formacie surowym TrueHD/MLP. A_TTA1 Sciezki TrueAudio(TM) sa zapisywane do plikow TTA. Zauwaz, ze w wyniku ograniczonej precyzji formatu Matroska(TM), wyodrebniane naglowki plikow beda miec inne dwa pola: data_length (laczna liczba sampli w pliku) i CRC. A_VORBIS Dzwiek Vorbis bedzie zapisywany do pliku OggVorbis(TM). A_WAVPACK4 Sciezki WavPack(TM) sa zapisywane do plikow WV. S_HDMV/PGS Napisy PGS beda zapisywane do plikow SUP. S_HDMV/TEXTST TextST subtitles will be written as a special file format invented for mkvmerge(1) and mkvextract(1). S_KATE Sciezki Kate(TM) beda zapisywane do kontenera Ogg(TM). S_TEXT/SSA, S_TEXT/ASS, S_SSA, S_ASS Napisy tekstowe SSA i ASS beda zapisywane do plikow odpowiednio SSA/ASS. S_TEXT/UTF8, S_TEXT/ASCII Proste napisy tekstowe beda zapisywane do plikow SRT. S_VOBSUB Napisy VobSub(TM) beda zapisywane do plikow SUB razem z odpowiednimi plikami indeksu IDX. S_TEXT/USF Napisy tekstowe USF beda zapisywane do plikow USF. S_TEXT/WEBVTT Napisy tekstowe w formacie WebVTT zostana zapisane w plikach WebVTT. V_MPEG1, V_MPEG2 Sciezki wideo w formatach MPEG-1 i MPEG-2 zostana zapisane jako strumienie elementarne MPEG. V_MPEG4/ISO/AVC Sciezki obrazu H.264 / AVC sa zapisywane do sciezek surowych (dane podstawowe) H.264, ktore moga byc pozniej przetwarzane np. przez MP4Box(TM) z pakietu GPAC(TM). V_MPEG4/ISO/HEVC Sciezki obrazu H.265 / HEVC sa zapisywane do sciezek surowych (dane podstawowe) H.265, ktore moga byc pozniej przetwarzane np. przez MP4Box(TM) z pakietu GPAC(TM). V_MS/VFW/FOURCC Sciezki obrazu ze stalym FPS majace taki CodecID sa zapisywane do plikow AVI. V_REAL/* Sciezki RealVideo(TM) sa zapisywane do plikow RealMedia(TM). V_THEORA Sciezki Theora(TM) beda zapisywane do kontenera Ogg(TM) V_VP8, V_VP9 Sciezki VP8 / VP9 sa zapisywane do plikow IVF. Tagi Tagi sa konwertowane do formatu XML. Jest to taki sam format, jaki mkvmerge(1) obsluguje w plikach wejsciowych. Zalaczniki Zalaczniki sa zapisywane do pliku wyjsciowego takie jakie sa. Zadna konwersja nie jest wykonywana. Rozdzialy Chapters are converted to a XML format. This format is the same that mkvmerge(1) supports for reading chapters. Alternatively a stripped-down version can be output in the simple OGM style format. Kody czasowe Timestamps are first sorted and then output as a timestamp v2 format compliant file ready to be fed to mkvmerge(1). The extraction to other formats (v1, v3 and v4) is not supported. KODY ZAKONCZENIA mkvextract(1) konczy dzialanie z jednym z trzech kodow wyjscia: o 0 -- Ten kod zakonczenia oznacza, ze wyodrebnianie zostalo zakonczone powodzeniem. o 1 -- In this case mkvextract(1) has output at least one warning, but extraction did continue. A warning is prefixed with the text 'Warning:'. Depending on the issues involved the resulting files might be ok or not. The user is urged to check both the warning and the resulting files. o 2 -- This exit code is used after an error occurred. mkvextract(1) aborts right after outputting the error message. Error messages range from wrong command line arguments over read/write errors to broken files. ZMIENNE SRODOWISKOWE mkvextract(1) uses the default variables that determine the system's locale (e.g. LANG and the LC_* family). Additional variables: MKVEXTRACT_DEBUG, MKVTOOLNIX_DEBUG i jego skrocona forma MTX_DEBUG The content is treated as if it had been passed via the --debug option. MKVEXTRACT_ENGAGE, MKVTOOLNIX_ENGAGE i jego skrocona forma MTX_ENGAGE The content is treated as if it had been passed via the --engage option. ZOBACZ TAKZE mkvmerge(1), mkvinfo(1), mkvpropedit(1), mkvtoolnix-gui(1) STRONA WWW Najnowsza wersja jest zawsze dostepna pod adresem domowym MKVToolNix[1]. AUTOR Moritz Bunkus Autor PRZYPISY 1. adresem domowym MKVToolNix https://mkvtoolnix.download/ MKVToolNix 100.0 2026-07-05 MKVEXTRACT(1)