Skip to content
cajhin edited this page Jan 1, 2021 · 10 revisions

All lines starting with GLOBAL are valid for all layers.

It does not matter where the GLOBALs are.
For readability, I recommend you put the GLOBALs on top of your config file, outside of any section.

GLOBAL activeLayerOnStartup {0..9}

Switch to this layer on startup.

Default: layer 1 is active on startup.

Example

Always start with the [layer_3] config:
GLOBAL activeLayerOnStartup 3

GLOBAL debugOnStartup

Show debug output from startup until the first layer is loaded. After that, the layer decides if debug is active (OPTION debug).

GLOBAL iniVersion {any string}

{any string} is displayed on startup, and with Status (ESC+S).

This is useful when you have several capsicain.ini files and you are not sure which version of an .ini you are currently using.

GLOBAL startMinimized

The capsicain console is minimized on startup.

Useful when you have a stable config and you don't want to see the console anymore.

GLOBAL startInTraybar

The capsicain console is moved from the taskbar to the traybar on startup.

ESC commands with output (like Status or Help) will pop up the console again.

Switch between taskbar and traybar with [ESC]+[T]

Note that the traybar icon only shows the status of capsicain - it does not do anything when you click on it.

GLOBAL startAHK

When capsicain starts, it will try to start AutoHotkey.

AHK is started if:

  1. AutoHotkey.exe exists in the same folder as capsicain.exe
  2. AutoHotkey.exe is not already running

GLOBAL capsicainEnableDisableKey {KeyLabel}

If a plain key is defined, it will toggle the disabled state.

While disabled, capsicain does nothing except listen for the enableDisable key; even ESC combos will not work.

The key event is forwarded to Windows.

Note SCRLOCK is a nice key for disabling capsicain, because

  • it is rather useless (toggling the ScrollLock state on doesn't do anything in Win10 ?)
  • the "capsicain disabled" state is indicated by the ScrollLock LED