MKVCleaver How To
Using MKVcleaver
GUI Layout
In the left pane you can see the files that were added and their main tracks, codecs and languages listed under each file. Tracks can be hidden by clicking + or – button on the left of each file name.
The right pane will display the list of items that can be extracted from files listed in the left pane.
Tracks listed in the left pane are specific to the file they are listed under. The right pane lists the highest number of tracks found. This does not mean that all files will have the same layout.
As you can see above, second file only has one video and one audio track, however the right pane lists 1 video, 2 audio and 2 subtitle tracks.
If you haven’t told the program where you’re hiding MkvToolNix package then clicking “Locate MKVToolNix…” button will allow you to do just that. The path will be saved in “custom.ini” file, which is located in the same directory.
Filename options will allow you to select how the output files should be named. This is done for easier sorting in Windows Explorer or any other file manager. Click Settings –> Track Language Code –> Append 2 Letter Lng Code and set the option to append a language tag to the end of filenames.
Output directory will allow you to select where you want output files to be stored. Make sure you have enough disk space remaining as MKVcleaver does not check that for you.
If you maximize or re-size the main window, location and window size will be saved in “custom.ini” file when the application is closed. MKVcleaver will be started exactly where you left it on the screen last time. Click Settings –> UI Resize –> On. If this option is OFF, you will still be able to resize the main window, but the position and size won’t be applied on application start up.
Adding Files
Click “Open MKV files to process…” button, navigate to the folder where your files are stored and select the files you want to open. Multiple selections are allowed.
Alternatively, drag and drop file (s) or a directory onto the “Files to process” window. Note:MKVcleaver will not check sub-folders.
MKVcleaver also accepts command line parameters. MKVcleaver now accepts full paths to matroska files separated by a single space. All paths should be enclosed in quotation marks.
You can use “Open With” or “Send To” menus in Windows Explorer. To add MKVcleaver to the “Send To” menu, click Settings –> Explorer “Send To” Menu –> Add To “Send To” Menu. Note:This option is only visible in portable version. MSI installer configures this option automatically.
Removing Files
To remove files from the list, select check boxes next to the files you want removed and hit “Remove selected files from list…” button. To toggle selection of all files on and off press Alt+Shift+A.
Preparing To Extract
The right pane is strictly for batch processing. This means anything that is checked there will be applied to all files in the left pane. If during processing, a file doesn’t have the appropriate track, it will be skipped.
Example: if “Subtitle Track 1” is checked in the pic above then the second file will be skipped during processing, since is doesn’t have any subtitle tracks. If a combination of “Video Track 1” and “Subtitle Track 1” is checked then only video track will be extracted from the second file.
If a track is checked in the left pane for any file, it will override settings in the right pane, just for that file.
Example: If a combination of “Video Track 1” and “Subtitle Track 1” is checked in the right pane and second audio track is checked for the first file in the left pane then second audio track will be extracted from the first file and the video track will be extracted from the second file.
If your file has a FLAC stream and you want to extract raw FLAC, , click Settings –> Audio –> Raw Flac. Click Settings –> Audio –> Flac Inside Ogg, if you want to extract FLAC in Ogg container. This option will only work if MKVcleaver detects FLAC codec in any audio stream, it will be ignored otherwise.
Selecting Attachments, Timecodes, Tags, Cuesheets check boxes will apply to all files regardless of any other settings. Only available data will be extracted.
If you need more information on a file then double right click the file name in the left pane. You will get all the information in the window for that file. To return to the file list, press Esc or right click anywhere.
Only timecodes for the tracks that are selected will be extracted. If you just want timecodes, but not the tracks themselves then right click click Settings –> Timecodes –> Timecodes Only. In this mode timecodes will be extracted for selected tracks, but not the tracks themselves. Note: “Timecodes” check box must be checked. Timecodes for VFR (Variable Frame Rate) video tracks are extracted automatically. If “Timecodes” check box is selected then files are not parsed for VFR tracks. This check can also be turned off in Setting -> VFR Detection since version 0.5.0.3
Everything in the right pane should be set once all the files have been added. All check boxes will be cleared and right click options set to default every time a file is added.
Check “Convert H264 to AVI files” if you want h.264 elementary streams converted to AVI files. Why would you want that ? Well, one of the reasons would be, if you have a VFR video and would like to quickly convert it to CFR. Avi tc package can do that, but it only works with AVI files.
Now you should be ready to extract data. Hit “Extract Tracks !” button.
Extraction
Well it’s ON now… If you supplied the output directory then all the files will be output there, if it’s left empty, the output files will go into the directory of the input file.
If you want to know which file MKVcleaver is working on – it’s the very top file.
“Convert H264 tracks to Avi files” check box can be toggled on/off during extraction. It takes affect right away.
Extraction can take a very long time, depending on how many files you supplied, your PC specs and what you are extracting. Status bar will display per file as well as overall progress. Once the process starts, there is nothing else for you to do, so go get a cup of tea or something…
Cancel at any time by clicking “Cancel”.
MKvcleaver can shut your computer down once finished. Click Settings –> Shutdown PC — > “choose your option here”.
Advanced
MKVcleaver is capable of detecting codecs for each track automatically. It will assign an extension to a file based on it’s codec. All currently supported formats are already programmed. However, in the case of a rare or unsupported codec and to support future codecs, MKVcleaver allows users to assign extensions to codecs manually. This can be done by adding sections to “custom.ini” file that is located in the same directory as MKVcleaver.exe. Sections must be in the following format:
[CODEC]
extension=.ext
Note: Codec IDs must be in the same format as reported by mkvmerge -i command.
Examples:
[V_MPEG4/ISO/AVC]
extension=.h264
[A_MPEG/L3]
extension=.mp3
Whatever is found in “custom.ini” takes priority over what’s been preprogrammed in MKVcleaver. This means that if MKVcleaver finds an appropriate entry in “custom.ini” it will skip internal check.
OR
Click Tools –> Edit Extensions. Here you can view current custom extension as well as add new ones, edit existing ones, delete existing ones. Click Tools –> Get Codec(s) From File, then choose a matroska file. MKVcleaver will retrieve all available codecs from that file and present a window where you can add an extension for each codec. Simply click, press Enter or F2 on the same line in the left column and type in the extension, then press Enter again.
Mkvextract.exe and/or Mkvmerge.exe was not found.
Make sure that the path to the files is correct.
????????????
Brazil
Make sure you tell MKVCleaver where those files are. Click on Locate MKVToolsnix button.
First things first, thanks for your effort and a truly quality product. Next, I’ve noticed that suddenly MKVCleaver is SLOW to launch….Like 30 to 45 seconds slow. I didn’t seem to take that long when I first installed it. Is there something that could be gumming up the startup that I could possible clean up?
Looks like automatic update check is causing this. I will fix it in the next version, however, for now, please disable update check in the settings.
I have a problem in version 0.7.0.1:
line 32619 (File “C:\Program Files\MKVCleaver\MKVcleaver.exe”):
Error: Variable used without being declared
Please file a bug.
Hello,
I cannot hear anything when I play the avi file. How can I get the audio to play in the movie?
I’m assuming you extracted AVI from an MKV file. In that case the AVI file only contains the video stream. The audio stream will need to be extracted separately, if you haven’t already done so. Then you will have to mux it into the AVI file using something like AviDeMux.
Depending on the hardware you use to play it the audio stream may need to be converted to mp3.
Hi Ilia,
Is it possible MKVCleaver just to extract the unwanted (second) Audio and/or second Subtitle, but the video to stay merged with our wanted audio? Or we must afterwards merge them with AviDemux?
Hi,
The way MKVCleaver works is the tracks are extracted as separate files and the original file is never modified in any way.
You then have to merge the separate track files into one by using any software you want.
Hope that helps.
Thanks.
I thought so Ilia, but then what software do you suggest to be used for merging and being the fastest in that, also even to be able to merge the latest HEVC compression, nevertheless it is free or premium Software? 🙂
Are you converting it to avi or keeping it as mkv ?
AviDemux is what I use when I want the files in avi format (which is very rare). If you want to keep the file in mkv format then just use mkvtoolnix-gui.exe to merge it back together.
Thanks, I prefer keeping in mkv.
I install the MKVCleaver but the window does not pop up when I start it , it stays in the task bar. I install the toolnix and added the extract gui in the toolnix folder along with newtonsoft.json.dll and toolnix.dll. I actually place both, GUI and GUI2 extractor. Mkv Cleaver still stays on the task bar..
Are you using a portable version ? Make sure the directory is writable to MKVCleaver. It is not advised to run MKVCleaver from a directory where another application is installed.
Please, try both portable and the installer versions.
Please file a bug if the issue persists.
Is not portable, is my PC. It worked fine and, one time when I start it I saw the main screen for half a second and since than it when in the side bar , does not want to show up again. It opens fine , I just can’t see the window! I uninstall and reinstall same result. How to file a bug?
No, I meant if you were using MKVCleaver portable or the installer version (not what type of computer…).
Please install MKVCleaver installer version before filing a bug.
Then if it still not working, file a bug here: https://blogs.sapib.ca/apps/bugs-requests/
Some files show a subtitle track, if I go into MVVToolnix-GUI it shows the file there as an SRT file. However, when I go to extract, it just skips through the files like nothing is there and although creates a SUB folder, it’s empty. Other files work perfectly fine. Basically works great when it works, doesn’t do anything when it doesn’t.
Please file a bug. Comments is not an appropriate channel for reporting issues.
Also, please send me the file that causes the issue, if possible. For large files, please go to https://ft.sapib.ca. I will need the file to test the bug.
please figure out a bug that when I encountered a error (the destination drive partition remaining space has been used up, for example) that the program didn’t give the feedback to users, at the meantime the software mini/max/close buttons are disabled and it have no responses all the time untill i end it up with the windows task manager.
my system: OS windwos 10 21H1, graphics card: nvidia quadro T 600, cpu i5-11400, motherboard intel z590
I would have to probably check free space before each extraction. I will look into it.
Windows 11 crashed; after that i can’t get MKVCleaver to work.
It takes all the files in n presents them nicely, as usual. but when i press extract now, nothing happens.
do I need to clear a cache or .ini file or…?
Try deleting all MKVCleaver files. Re-download the executable and try again.
If that doesn’t work, enable debug and execute all the actions. Send me the debug log.