KeyToggles.ini

@@ -0,0 +1,70 @@
+; KeyToggles v1.5
+
+[General]
+; To retrieve the title of the game's window, you have 2 solutions:
+;
+; Method 1
+; 1. Launch your game in windowed mode.
+; 2. The name of the window will be displayed on the left side of the title bar.
+;
+; Method 2
+; 1. Launch your game
+; 2. Tab out.
+; 3. Open Task Manager.
+; 4. Go to the Processes tab.
+; 5. Expand the entry corresponding to your game.
+; 6. The name of the window will be one of the expanded entries.
+windowName="put_window_name_here"
+
+; Use these to set key modes individually
+; 0: disable
+; 1: toggle (for keys that must be held down)
+; 2: hold (for keys that only work as toggles)
+; 3: autofire (toggled by the autofire keys)
+aimMode=1
+crouchMode=1
+sprintMode=1
+
+; How much time to wait (in milliseconds) before sending another input in autofire mode
+autofireKeyDelay=100
+
+; Fixes common system key combinations (such as Alt+Tab) not working when toggle keys are modifiers (1 to enable)
+fixSystemKeys=1
+
+; How often (in milliseconds) to check whether the window is active
+; If the window is no longer active, all keys will be released
+focusCheckDelay=1000
+
+; How much time to wait (in milliseconds) before hooking the window
+; Increase this delay in case hotkeys aren't working in some games
+hookDelay=0
+
+; How much time to wait (in milliseconds) between key press and release in hold/autofire mode
+; Increase this delay in case keystrokes aren't registered in some games
+keyDelay=0
+
+; Restore toggles to their previous state when the window regains focus (1 to enable)
+restoreTogglesOnFocus=0
+
+; Force the script to run as admin (1 to enable)
+runAsAdmin=0
+
+; Show notifications when certain events (such as window hooking) occur (1 to enable)
+showNotifications=0
+
+; See https://www.autohotkey.com/docs/KeyList.htm for key IDs
+[Keys]
+; Main keys (disabled if set to autofire mode)
+aimKey=RButton
+crouchKey=LControl
+sprintKey=LShift
+
+; Autofire keys (disabled if not set to autofire mode)
+; Repeatedly simulate pressing the corresponding main key until pressed again
+aimAutofireKey=F1
+crouchAutofireKey=F2
+sprintAutofireKey=F3
+
+[Debug]
+; Enable debug functions such as closing (ALT+F10) or reloading (ALT+F11) the script (1 to enable)
+debugMode=0

README.md

@@ -1,25 +1,34 @@
-# HoldToggles
-An AutoHotkey 1.1 script that makes keys and mouse buttons togglable so that you don't have to hold them to crouch, sprint or aim in games.
+# KeyToggles
+An AutoHotkey 1.1 script that can change the input mode of keys and mouse buttons.
+
+3 modes are currently supported:
+- toggle: you don't have to hold the key to perform its action.
+- hold: you have to hold the key to perform its action.
+- autofire: same as toggle except it will repeatedly perform the action of another key.
 
 ## Installation
 
-You can run the script from anywhere as long as "HoldToggles.ini" is in the same directory than the script.  
+You can run the script from anywhere as long as "KeyToggles.ini" is in the same directory than the script.  
 
 ## Usage
 
-The script will only be active when the game's window is in focus. Please read "HoldToggles.ini" for more information about setting it up.  
-Make sure that your keys or mouse buttons in "HoldToggles.ini" are the same than the ones in the game.
+The script will only be active when the specified window is in focus. Please read "KeyToggles.ini" for more information about setting it up.  
+
+Make sure that your keys or mouse buttons in "KeyToggles.ini" are the same than the ones in the game.
 
 Default keys:
 
+Right-click: toggle aim  
 Left CTRL: toggle crouch  
 Left SHIFT: toggle sprint  
-Right-click: toggle aim  
+F1: toggle aim autofire  
+F2: toggle crouch autofire  
+F3: toggle sprint autofire  
 Left ALT + F12: pause the script (disable all hotkeys)  
 
 For games run as admin, you must also run the script as admin for it to work.
 
 ## Limitations
 
-I've only tested the script in Half-Life 1, Half-Life 2 and Unity games.  
+I've only tested the script in Aliens: Colonial Marines, Half-Life 1, Half-Life 2 and some Unity games.  
 It will not work in games that prevent keys from being simulated (ex: games using anti-cheats).

release.bat

@@ -0,0 +1 @@
+powershell -Command Compress-Archive -Path "KeyToggles.exe", "KeyToggles.ini", "README.md" -Update -DestinationPath "KeyToggles.zip"