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

All lines starting with GLOBAL are used for all configs.

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 activeConfigOnStartup {0..9}

Switch to this config on startup.

Default: config 1 is active on startup.

Example

Always start with the [config_3] config:
GLOBAL activeConfigOnStartup 3

GLOBAL capsicainOnOffKey {KeyLabel}

If a plain key is defined, it will toggle the ON/OFF state.

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

The key event is forwarded to Windows.

Note SCRLOCK is a nice key for turning off capsicain, because

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

GLOBAL debugOnStartup

Show debug output from startup until the first config is loaded. After that, the config 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 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 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 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.