WindowsmacOSLinux

Where Does MKVToolNix Store Settings and Job Queue?

MKVToolNix GUI keeps settings in one mkvtoolnix-gui.ini plus jobQueue and cache folders. Paths on all platforms and portable mode.

Last updated

The MKVToolNix GUI stores every preference in a single mkvtoolnix-gui.ini file. Delete it and the GUI returns to defaults, the documented reset procedure. The job queue and the mux cache sit beside it in jobQueue and cache subfolders, so one directory holds the whole GUI state.

Portable builds flip the location entirely. If a portable-app marker sits in the data folder next to the executable, settings, queue and cache all live beside the program instead. Moving a portable install? Carry the ini plus jobQueue, and leave cache behind since new versions purge it anyway.

Where MKVToolNix stores this, by platform

Windows
%LOCALAPPDATA%\bunkus.org\mkvtoolnix-gui

mkvtoolnix-gui.ini with jobQueue and cache beneath it. Portable builds keep the same trio next to the executable when the portable-app marker exists.

macOS
~/Library/Preferences/bunkus.org/mkvtoolnix-gui

Same ini plus jobQueue layout as Windows. Cache behavior matches: ephemeral, version-scoped, safe to ignore during moves.

Linux
~/.config/bunkus.org/mkvtoolnix-gui

Mirrors the other platforms. Multiplex presets (.mtxcfg files) are separate documents you save yourself, not part of this state folder.

Frequently asked questions

How do I reset MKVToolNix GUI settings?

Close the GUI and delete mkvtoolnix-gui.ini in the folder above. Reopening recreates factory defaults. Leave jobQueue alone if queued mux jobs still matter to you.

How do I move MKVToolNix to a new computer?

For installed builds copy mkvtoolnix-gui.ini and the jobQueue folder to the matching path. For portable builds move the whole program folder with its ini and jobQueue. Skip the cache folder in both cases.

Notice an outdated path? Let us know.