feat: custom keybinds, key combos, drag, random delay & UI polish

timoinglin · timoinglin · commit a61bf0648de7 · 2026-02-25T23:02:56.000+01:00
- Configurable start/stop/emergency hotkeys via Settings dialog
- Keyboard combos support (ctrl+c, alt+f4, etc.)
- drag(x1,y1,x2,y2) action for mouse dragging
- Random delay ranges (e.g. 0.3-0.8) in delay field
- App icon on all dialog windows
- START/STOP button state management
- Unsaved changes warning on close
- Redesigned help page with styled cards and live hotkey badges
- Legacy config compat (sleep -&gt; delay fallback)
- Updated README and docs/index.md
diff --git a/README.md b/README.md
@@ -24,6 +24,7 @@ A powerful and user-friendly GUI automation tool for simulating keyboard and mou
 - 🛡️ **Safety Features**: Safe Mode blocks dangerous keys, ESC for emergency stop
 - 💡 **Visual Feedback**: Active row highlighting and status indicators during execution
 - ⌨️ **Global Hotkeys**: Ctrl+F2 (Start), Ctrl+F3 (Stop), ESC (Emergency Stop)
+- 🔧 **Custom Keybinds**: Reassign start, stop and emergency stop hotkeys via Settings
 
 ## 📥 Download
 
@@ -97,6 +98,7 @@ The EXE will be created in the `dist/` folder.
 | `up`, `down`, `left`, `right` | Arrow keys |
 | `f1` - `f12` | Function keys |
 | `shift`, `ctrl`, `alt`, `win` | Modifier keys (use Hold Time) |
+| `ctrl+c`, `alt+f4` | Key combos (modifiers held automatically) |
 | `Hello World!` | Type text string |
 
 ### Mouse
@@ -108,12 +110,19 @@ The EXE will be created in the `dist/` folder.
 | `click(x,y)` | Left click at coordinates |
 | `rclick(x,y)` | Right click at coordinates |
 | `moveto(x,y)` | Move cursor to coordinates |
+| `drag(x1,y1,x2,y2)` | Drag from point A to point B |
 
 ### Color Detection
 | Action | Description |
 |--------|-------------|
 | `waitcolor(r,g,b,x,y)` | Wait until color RGB appears at (x,y) |
 
+### Timing
+| Value | Description |
+|-------|-------------|
+| `0.5` | Fixed delay in seconds |
+| `0.3-0.8` | Random delay between min and max |
+
 ## 🛡️ Safety Features
 
 ### Safe Mode (On by default)
@@ -126,9 +135,11 @@ The EXE will be created in the `dist/` folder.
 ### Global Hotkeys
 | Hotkey | Action |
 |--------|--------|
-| `Ctrl+F2` | Start automation |
-| `Ctrl+F3` | Stop automation |
-| `ESC` | Emergency stop |
+| `Ctrl+F2` | Start automation (default) |
+| `Ctrl+F3` | Stop automation (default) |
+| `ESC` | Emergency stop (default) |
+
+> All hotkeys are fully customizable. Click **⚙ Settings** in the header to open the keybind editor, then click **⏺ Record** next to any hotkey and press your preferred key combination. Changes take effect immediately and are saved/loaded with your configuration files.
 
 ## 📦 Requirements
 
diff --git a/docs/index.md b/docs/index.md
@@ -2,7 +2,7 @@
 
 ![SimpleKeyClicker Logo](logo.png)
 
-A powerful and user-friendly GUI automation tool for simulating keyboard and mouse inputs. Built with Python and ttkbootstrap. Perfect for gaming macros, testing, or automating repetitive input tasks.
+A powerful and user-friendly GUI automation tool for simulating keyboard and mouse inputs. Built with Python and **CustomTkinter** for a stunning modern dark UI. Perfect for gaming macros, testing, or automating repetitive input tasks.
 
 ![SimpleKeyClicker Screenshot](images/screenshot.png)
 
@@ -13,7 +13,7 @@ A powerful and user-friendly GUI automation tool for simulating keyboard and mou
 *   **Action Sequencing**: Create and run sequences of keyboard presses and mouse actions.
 *   **Repetition Control**: Run sequences indefinitely or for a specific number of times.
 *   **Customizable Timing**: Set delays *after* each action and specify hold durations.
-*   **Theme Support**: Toggle between Light (Flatly) and Dark (Darkly) themes.
+*   **Theme Support**: Beautiful glassmorphism dark theme with purple accents.
 *   **Advanced Mouse Control**: Perform clicks and movements at specific screen coordinates (`moveto(x,y)`, `click(x,y)`).
 *   **Coordinate/Color Capture**: Easily capture mouse coordinates (X,Y) and screen pixel color (R,G,B) with a single click.
 *   **Color Detection**: Pause execution until a specific color appears at designated coordinates (`waitcolor`) with timeout error handling.
diff --git a/main.py b/main.py
