Skip to content

Using config.txt

ililim edited this page Sep 10, 2021 · 10 revisions

Wherever dual-key-remap.exe is run, it will look for a file called config.txt in the same directory. An example of this file looks like this:

remap_key=CAPSLOCK
when_alone=ESC
with_other=CTRL

remap_key=SHIFT
when_alone=SPACE
with_other=SHIFT

debug=1

This file is case sensitive and does not allow extraneous characters (except empty lines).

The following configuration options are available (they are required unless noted otherwise):

remap_key: Key that will trigger the dual key functionality.
when_alone: Key that will triggered when remap_key is pressed alone.
with_other: Key that will be triggered if another key is pressed while remap_key is held down.
debug: (Optional) Either 1 or 0. If enabled the application will output detailed activity logs.

You may remap any amount of keys by simply declaring the remap-key, when_alone, with_other settings multiple times, as seen in the example above.

Key Names

Modifier Keys

Certain modifiers have left and right variations. If you do not specify the which side you're remapping dual-key-remap will assume you're referring to the left key. To remap both sides simply add two remappings to your config.

CTRL
LEFT_CTRL
RIGHT_CTRL

SHIFT
LEFT_SHIFT
RIGHT_SHIFT

ALT
LEFT_ALT
RIGHT_ALT

WIN
LEFT_WIN
RIGHT_WIN

Direction Keys

UP
DOWN
LEFT
RIGHT

General Keys

ESCAPE
SPACE
CAPSLOCK
BACKSPACE
TAB
ENTER

UP
LEFT
RIGHT
DOWN

INSERT
DELETE
HOME
END
PAGE_UP
PAGE_DOWN

NUMLOCK
SCROLLLOCK
PRINT_SCREEN
PAUSE

Character Keys

Note: Dual Key Remap specialized in modifier key remapping and has only limited support for abitrary character remapping.

KEY_A through KEY_Z
KEY_0 through KEY_9

PLUS
COMMA
MINUS
PERIOD

# The following keys can vary by keyboard. Names refer to US standard.
KEY_US_SEMI
KEY_US_SLASH
KEY_US_TILDE

Oh no! My key isn't here!

If a key you need isn't listed please feel free to open a new issue and we can add it 😉