Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

KeyCap

Download the Latest Release

Updates in progress

Docs/code are being updated to v2 branch (just merged into master for further refinement/release).

Description

Windows only application for capture keyboard input and remapping it to:

  • another key or sequence of keys
  • mouse input
  • nothing at all
  • on/off toggles for keys and inputs (this allows a single keystroke to initiate a hold and a second keystroke to end the hold)
  • Repetition (with custom delay)

Example Uses

  • (original inspiration) Shortcutting a sequence of shortcuts. I originally created the application long ago to help with a sequence of keyboard shortcuts necessary to perform file merges when integrating a branch with Perforce + Araxis Merge
  • Starbound Keyboard shortcuts to toggle off/on mouse buttons. This makes extensive mining in the game a lot less painful. Mass Effect 2 planet scanning also can be a lot easier...
  • Dreamfall Chapters has a run button though it can be nice to have a button that toggles whether you are running or not instead of holding one down.
  • Citadel: Forged With Fire has a number of long mouse hold actions. Toggling this off/on instead of holding the button for long periods of time is extremely nice.

Run on Startup

With Registry Editor, add a new StringValue to HKCU\Software\Microsoft\Windows\CurrentVersion\Run with the full path to KeyCap.exe followed by the full path to your .kfg file. KeyCap will load the config file, start it and then minimize to the tray.

Alternatively, copy the following to a text file named KeyCap.reg and then edit it to match your setup. Save it, right click-it and selct Merge. Follow the prompts and then the next time you reboot, KeyCap will start automatically.

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run]
"KeyCap"="D:\\Util\\KeyCap\\KeyCap.exe D:\\Util\\KeyCap\\Config.kfg"

TODO:

  • Fix bugs!

Warning

This program does perform keyboard capture and is essentially the first component of a key logger. I humbly request you NOT use the information included in the source code to create a malicious application.

Visual Studio Notes

  • If you attempt to run from Visual Studio you will need to make sure the C# project is configured with Enable Native Code Debugging. If this is not enabled the dll will not create the necessary keyboard hook (works fine outside of Visual Studio). This was observed in every Visual Studio version up-to and including 2015.

Technical Documentation

.kfg File Format

The file is prefixed with two 32-bit ints:

File Data Prefix File Format Version
0x0E0CA000 0x1

The remainder of the file is a repeated sequence of the following information. One input may be associated with numerous outputs. Byte array representation of each input/output(s) pair:

Flags VirtualKey Parameter Outputs Count Output Flags Output VirtualKey Output Parameter (repeats for all outputs) ...

There is no count for the number of inputs. Instead the file is read until no further input/output(s) pairings can be read.

Flags

The flags indicate information that modifies the value (alt/shift/ctrl and special functionality when mapping to another output)

VirtualKey

A VirtualKey value.

Parameter

A special value associated with the input/output (as necessary based on the function).

Output Count

This is limited to a single byte despite the use of an int, so 255 maximum.

History

This is an old project I used many years ago for remapping input. I still find it useful sometimes.

Disclaimer

I am providing code in the repository to you under an open source license. Because this is my personal repository, the license you receive to my code is from me and not my employer.