Keysticks provides a number of options to let you customise its behaviour and appearance. To view or edit the program options, click
the cog-shaped button in the controller window, or select "Program options..." from the Keysticks program menu.
With most of the options, like colours, mouse pointer speed etc., your changes are applied immediately so you can see the difference. If you don't like your changes, you can just select Cancel.
- Start when Windows starts: Whether to start Keysticks automatically when you start your computer.
- Load last-used profile: When Keysticks starts, whether to load the profile you last used.
- Allow running in the background: Whether Keysticks should continue running (as icon in the system tray) when the (last) controller window is closed, or whether the program should just exit.
- Show tray notifications: Whether Keysticks should show popup notifications in the system tray e.g. when a profile is loaded, when changes are applied.
- Open controller windows automatically: Whether to open the controller-shaped window(s) when a profile is loaded. You can also open this window manually by choosing the "View controls..." option on the program menu.
- Show held modifier keys graphic: Whether Keysticks should show a small graphic when any modifier keys (Alt, Ctrl, Shift, Win) are being held down by Keysticks.
- Show held mouse buttons graphic: Whether Keysticks should show a small graphic when any mouse buttons are being held down by Keysticks.
- Controller window opacity: How see-through the controller window is.
- Keyboard window opacity: How see-through the keyboard window is.
- Colours table: For changing the colours of the keyboard backgrounds and selected or highlighted items.
- Window magnification: Allows you to magnify the controller and keyboard windows (useful for viewing on a TV).
- Compact controller window: Makes the controller window more compact so that it takes up less screen space.
- Keep controller window on top: Whether the window should be shown above other desktop windows. Note: does not apply to programs or games in full-screen mode.
- Animate controls when they are used: Whether the controls shown in Keysticks windows should change colour to highlight when they are being used.
- Show keyboard window title bar: Whether to show the title bar in the keyboard window.
- Show keyboard window footer: Whether to show the footer in the keyboard window.
The override dead zones options allow you to apply global dead zone values which override the dead zones specified in each profile.
- Trigger / slider dead zone: How much you have to press trigger / slider controls before a press is registered.
- Stick / axis dead zone: How much you have to move stick controls away from the centre before a press or movement is registered.
Take care not to use dead zone values that are too small for your controller hardware because it may cause unwanted presses or movements to be registered even when you are not pressing the controls.
- Mouse pointer speed: How fast the mouse pointer moves when you are controlling it using an analogue stick control. This is applied independently of (i.e. in addition to) the Windows Control Panel pointer speed options.
- Mouse pointer acceleration: How much the pointer speed is amplified for large stick movements relative to small movements.
- Mouse click length: How long Keysticks holds down a mouse button for, when emulating a click or double-click.
- Key stroke length: How long Keysticks holds down a key for, when emulating a keystroke.
- Type of key presses: Which type of emulated key press to use.
Keysticks is able to use two different types of emulated keystroke: virtual keys and DirectX scan codes. For general
PC control, virtual keys are fine, however many PC games require DirectX input so DirectX is selected by default.
If you wish to use Keysticks to play DirectX games, make sure the "DirectX scan codes" option is selected.
However, with this option, ensure that NumLock is OFF, otherwise some keys will perform their numeric keypad equivalents
(e.g. the arrow keys will type numbers instead of moving the cursor).
- Enable word prediction: Whether to display word suggestions when you are using a screen keyboard and one or more word prediction actions are active.
- Auto-insert spaces after words: Whether to automatically enter a space after a suggested word is selected.
- Add words to dictionary: Whether to add new words that you type to the word prediction engine's dictionary.
- Connect using internal port: The local TCP/IP port to use to connect to the word prediction engine.
The word prediction engine runs as a separate program on your computer (called Word Prediction Server),
so Keysticks needs an internal connection in order to talk to it.
Keysticks can provide word suggestions in multiple languages. By default, English (UK) is enabled.
You can use the "Add language" button to add other languages.
If you have more than one language enabled, those higher up the list are given higher priority.
By default, the Keysticks Profile Designer asks for confirmation before doing things like applying or clearing actions for a control,
and deleting control sets. These confirmation message boxes allow you to select "Don't show this again" so that you can use the
designer without unnecessary interruptions. The "Messages" tab in the Program Options lets you select which messages you want,
all in one place, and re-enable any messages that you turned off.
Here, you can choose which folder you want to keep your Keysticks profiles in.
The following options help to protect you from accidentally performing unwanted actions when you are using Keysticks controls.
- Disallow Shift+Delete: prevents Keysticks from performing a Delete key press while it is holding a Shift key down.
- Disallow potentially harmful controls: prevents various combinations of actions that could potentially harm your computer e.g. performing a long list of actions for a single button press.
The rules table specifies a list of rules for deciding which commands can be executed by "Start program" actions, and whether or not you are asked to confirm the action first.
You should not normally need to edit this table.
Entries in the table specify an exact command, or a pattern for matching multiple commands,
plus the action to take: Run, Ask me, or Don't run.
- "Run" means run the command without asking you for confirmation.
- "Ask me" means pop up a message box so that you can decide (see first picture below).
- "Don't run" means that Keysticks will not run the command (see second picture below).
By default, Keysticks will ask you before running commands. When a command is blocked, or when you are asked to decide and you tick "Don't show this again", Keysticks will automatically add an entry for the command in the rules table so that you can easily change the action to take if you need to.
If a command value begins with "^", it is interpretted as a regular expression ("regex") pattern for matching multiple commands. Otherwise, the value is treated as an exact command string. The order or precedence in which the rules are applied is: exact match rules first, then "Run" rules, then "Ask me" rules, then "Don't run" rules,
until a match is found. If no rule matches a command, the default is "Ask me" i.e. you will be prompted to decide.
If you choose to allow commands to run without asking for confirmation, it is a good idea to do so
on an individual basis i.e. only select "Run" for exact command strings, not regular expressions.
In any case, you should only specify "Run" for commands that you know are safe to run.
The Program options window also provides a "Reset all" button. This resets the options shown in all the tabs to their original values. However, the changes are only applied when you click OK to close the Program options window. If you click Cancel in the Program options window, no changes will be made, even if you have clicked "Reset all". So there's no need to be nervous about using this button: there is chance to change your mind!
Next topic: Creating your own controls