Table of Contents

Settings

Application Settings


Theme

Controls the application theme.


System Language

Defines which language to use on the user interface (restart required).


Auto Save Settings

Controls whether or not the settings should be saved automatically.


7z Path

Note

This field is optional but highly recomended.

Stores the location of the installed 7-zip executable for faster .7z mod installation.


Emulator Executable Path

The absolute path to your emulator's executable. It should point to the direct executable (e.g: Ryujinx.exe or Ryujinx.AppImage).

Alternatively, you may also type the full name of the emulator, instead of the path to its executable (if the emulator is open when doing so, it will fetch the rest of the configuration on its own).

Note

If using an .AppImage file, the file's name should contain only the exact name of the emulator and nothing else (e.g: Citron.AppImage instead of Citron-Nightly-0.10.0.AppImage).


Show Trivia Popup

Defines whether or not to show the trivia popup during the merging process.


Show Advanced Settings

This makes advanced options visible (restart required). Those options are hidden by default because modifying them can break your configuration.


Packaging Settings


Default Author

Warning

This setting is automatically set your computers username. Make sure this does not contain sensitive information that may be packaged and deployed in mods.

Defines the author name to use when packaging mods.

Merging Settings


Target Language

Sets the language and region to use when merging.


Export Locations

Defines the location(s) to export the merged mod to.

For usage details, refer to the Using Mods guide.


Use romfslite

Defines whether or not to use the romfslite feature from the TotK Optimizer. This renames the romfs folder to romfslite and bypasses the atmosphere romfs building process on Switch hardware (to load mod files through the optimizer instead).

This fixes issues preventing the game from being able to launch with mods on Switch hardware using firmware 20.0.0 and higher (due to lack of memory).

This setting is ignored if the TotK Optimizer is disabled.


Merged Output Folder

Caution

The romfs, romfslite, exefs and cheats folders in this location will be permanently deleted when merging.

Do not set this to a folder with any valuable contents.

Defines the folder where the merged mod is stored (ignored when exporting to a microSD card).

GameBanana Client


Use Threaded Downloads

Defines whether to use multi-threaded downloads when downloading mods from the GameBanana browser. Enable this if you experience low download speeds.


Download Timeout Seconds

This defines the maximum amount of seconds to wait for a response from the server before failing.


GameBanana Download Max Retries

This defines the maximum amount of times to retry a download before failing.


GameBanana Poll Interval

This defines the duration (in minutes) between attempts to fetch remotely installed mods from GameBanana. A clear value only polls once at startup.


Game Dump


Important

By default, all these settings are hidden under Show Advanced Settings (except Preferred Game Version), because the required paths are automatically fetched during the setup process.

Do not make modifications to the hidden settings if you do not know what you are doing.

Not all types of dump formats are required, so if you see empty fields it does not mean you have to fill them. TKMM is compatible with multiple dump types, but it does not mean you have to provide all possible types.

Preferred Game Version

This defines which version of the game to use if multiple are found in your configuration. When the preferred version is not available, the first version found is used.

This setting is useful if you have different game versions in Sysnand and Emunand on your Switch. Otherwise, for emulators, it is recommended to leave this setting on Auto so that TKMM directly selects the exact version that is currently in use on your emulator.


Keys Folder Path

This is the path to the folder containing your dumped Switch decryption keys.


Packaged Base Game Path(s)

The absolute path to your dumped base game file (.xci or .nsp), or a folder with the base game split into multiple files.


Game Update File Path(s)

The absolute path to your dumped game update file (.nsp). Multiple paths can be provided if you use multiple versions.


SD Card Root Path

The path to the root of your SD card. For this to be used to be used to fetch the game dump, it must either contain a Nintendo/Contents folder with the game on it, or the game needs to be dumped to this SD card via nxdumptool.

Additionally, this setting is also used to determine where to output the TotK Optimizer configuration.


Game Dump Folder Path(s)

The absolute path to your dumped RomFS Folder. This type of dump is not recommended for most users, but can be useful for mod creators who have dumps with all extracted contents. Multiple paths can be provided if you use multiple versions.


NAND Folder Path(s)

The absolute path to your virtual NAND folder. This is where the game update is installed for some emulators.

Edit this page