AutoHotkey: Winfig Dots Custom Hotkeys & Automation
Overview¶
AutoHotkey is a powerful scripting language for Windows automation, hotkeys, and workflow customization. With Winfig Dots, you get a curated set of ergonomic, productivity-focused hotkeys for window management, terminal launching, and seamless integration with tiling managers and automation tools.
Features¶
- Fast, ergonomic hotkeys for window and workspace management
- One-touch restart/reload for whkd, komorebic, and yasbc
- Quick launch for Windows Terminal and WSL
- Minimize all windows except the active one
- Close focused window instantly
- Designed for seamless integration with Winfig Dots and tiling managers
Requirements¶
- AutoHotkey v2.0+ installed on Windows 11
- PowerShell 5+ for automation and scripting
- Git for Git gutter integration (optional)
- Administrator privileges for certain configurations
- Internet access for downloading dependencies
Quick Install
- AutoHotkey:
winget install --id AutoHotkey.AutoHotkey -e - Git:
winget install --id Git.Git -e - PowerShell 7 (optional, recommended):
winget install --id Microsoft.Powershell -e
Installation Methods¶
One-line installation - Downloads and runs automatically:
```powershell title="Run in Administrative PowerShell"
Invoke-RestMethod -useb https://raw.githubusercontent.com/Get-Winfig/winfig-dots/refs/heads/main/AHK/setup.ps1 | Invoke-Expression
```
!!! success "Why Web Install?"
- Always gets the latest version
- No manual download required
- Automatic script verification
Download and run manually for offline environments:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# Download from GitHub
Invoke-WebRequest -useb "https://raw.githubusercontent.com/Get-Winfig/winfig-dots/refs/heads/main/AHK/setup.ps1" -OutFile "setup.ps1"
Unblock-File -Path .\setup.ps1
.\setup.ps1
Note
- Ensure you have the latest script version
- Manual updates required for new releases
- Verify script integrity before running
Usage¶
All hotkeys are active as soon as the script is running. You can edit the script to add, remove, or change hotkeys as needed. For advanced automation, combine these hotkeys with your tiling manager or other Winfig Dots tools.
Hotkey Quick Reference¶
| Hotkey | Action/Description |
|---|---|
| Alt + O | Restart whkd (tiling window manager) |
| Alt + Shift + O | Reload komorebic configuration |
| Alt + Ctrl + O | Reload yasbc |
| Win + F2 | Toggle komorebic shortcuts |
| Alt + W | Close active/focused window/app |
| Win + T | Open Windows Terminal |
| Win + K | Open Windows Terminal with WSL |
| Alt + M | Minimize all except active window |
Configuration Highlights¶
- All hotkeys use AutoHotkey v2.0+ syntax for reliability and performance
- Designed for minimal conflicts with other shortcuts
- Easily extensible: add your own hotkeys or automation blocks
- Integrates with PowerShell, whkd, komorebi, yasbc, and Windows Terminal
Frequently Asked Questions (FAQ)¶
How do I add or change hotkeys?
Edit the script in any text editor. Use the AutoHotkey documentation for syntax help.
How do I make the script run at startup?
Place a shortcut to your script in the Windows Startup folder (shell:startup).
Can I use these hotkeys with other automation tools?
Yes! These hotkeys are designed to work alongside Winfig Dots, whkd, komorebi, and other automation tools.
How do I reload or restart the script?
Right-click the AHK tray icon and choose Reload Script, or double-click the script again.
Troubleshooting¶
| Issue | Solution |
|---|---|
| Hotkey not working | Make sure AutoHotkey v2.0+ is installed and script is running. |
| Conflicting shortcut | Change the hotkey in the script to avoid conflicts. |
| Integration not working | Ensure whkd, komorebi, or yasbc are installed and in your PATH. |
| Script errors | Check the AHK syntax and use the v2.0+ documentation for reference. |
If your issue isn’t listed, check the AutoHotkey documentation or Winfig GitHub Issues.