You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+13-8Lines changed: 13 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,34 +18,39 @@ You can either use the latest executable release, or run the script itself. Both
18
18
19
19
## Running the executable
20
20
21
-
Download the [latest executable release](https://github.com/sophice/ahk-keyboard-locker/releases), place it anywhere you want, and run it!
22
-
23
-
Note: You cannot currently change the keyboard shortcut or password in the executable version. The keyboard shortcut to lock is Ctrl+Alt+K, and the password to unlock is "unlock".
21
+
Download the [latest release](https://github.com/sophice/ahk-keyboard-locker/releases), place it where you want, and run `keyboard-locker.exe`.
24
22
25
23
## Running the .ahk script
26
24
27
25
1) Install [AutoHotkey](https://www.autohotkey.com/) version 1.x in order to run .ahk scripts. Not tested with AutoHotkey version 2.
28
-
2) Download [the latest release](https://github.com/sophice/ahk-keyboard-locker/releases) and extract the files where you want.
26
+
2) Download the [latest release](https://github.com/sophice/ahk-keyboard-locker/releases) and extract the files where you want.
29
27
3) Run keyboard-locker.ahk.
30
28
4) Lock the keyboard either by pressing the default shortcut "Ctrl+Alt+k", or by right clicking on the tray icon and selecting "Lock keyboard".
31
29
5) Unlock the keyboard either by typing the default password "unlock", or by right clicking on the tray icon and selecting "Unlock keyboard".
32
30
33
-
The keyboard shortcut and password can be changed by editing keyboard-locker.ahk.
31
+
# Settings
32
+
33
+
Various settings can be changed by editing `settings.ini`. The file contains explanations for each setting.
34
+
35
+
- keyboard shortcut and password
36
+
- disable keyboard shortcut or password
37
+
- disable tray notifications
38
+
- automatically lock on open
39
+
- automatically exit on unlock
40
+
- lock mouse as well
34
41
35
42
# Known issues
36
43
37
44
- Some media keys or Windows shortcuts may not be blocked.
38
-
- Some keys (especially modifiers) may get "stuck" after typing the unlock password, requiring you to press them again to get them unstuck.
45
+
- Some keys (especially modifiers) may get "stuck" after unlocking, requiring you to press them again to get them "unstuck".
39
46
- There is sometimes a slight delay after typing the password before the keyboard is unlocked.
40
47
41
48
Feel free to submit a PR if you have improvements for these issues!
42
49
43
50
# Potential future improvements
44
51
45
-
- Better configuration: command line parameters to customize the script on run, and a config file to provide your own defaults.
46
52
- Stealth mode: hide the tray icon and disable tooltips on lock, making it slightly more difficult to bypass the script.
47
53
- Temporary password: change the password at run time to avoid using the one that is readable in the script itself.
48
-
- Lock the mouse: lock the mouse, keyboard, or both.
49
54
- Unlock timer: automatically unlock after a period of time.
50
55
- Inactivity lock: automatically lock after a period of inactivity.
51
56
- Scheduled lock: automatically lock and unlock on a schedule.
0 commit comments