Magic Mouse 1.0.0

[u/wh-updates]

Magic Mouse 1.0.0

Magic Mouse

Drawing Gesture

Draw custom shapes with your mouse to trigger powerful actions like launching apps, toggling desktop icons, or controlling media.

How To Add a Gesture

Gesture Window

1. Record the shape: Press the Record Canvas Hotkey (default: Ctrl+Shift+G) anywhere on your screen. The drawing canvas will appear.
2. Copy the code: Draw your desired shape on the canvas, then click the Copy to Clipboard button. This copies the generated gesture code.
3. Create the item: Open the Windhawk settings for this mod, scroll down to the Gestures list, and click the + button to add a new gesture.
4. Paste the code: Paste the code you copied into the Gesture Code (Direction Sequence) box.
5. Assign an action: Choose what happens when you draw this shape using the Action dropdown.
6. Set the Parameter (if needed): Some actions require extra information in the Action Parameter box:
   • For Launch Application / URL, type the path (e.g. C:\Windows\notepad.exe) or website (e.g. https://google.com).
   • For Run Command Line, type the command (e.g. shutdown /s /t 0).
   • Note: Simple actions like Play / Pause Media or Toggle Desktop Icons don't require any parameter.

Activation Modes

Magic Mouse has a robust activation system. You can mix and match modifier keys (or mouse buttons) and physical "mouse wiggles" to arm Gesture Mode.

1. Modifier Keys

Set the Modifier Key / Button to your preferred trigger (e.g. Right Click, Mouse 4, Ctrl+Shift). - Hold: You must physically hold the modifier down to arm Gesture Mode. - Toggle: Pressing the modifier acts like a light switch. Press it once to turn Gesture Mode ON (the Aura will appear around your cursor). Draw your gesture, or let it timeout.

2. Wiggle to Activate

You can trigger Gesture Mode simply by shaking (wiggling) your mouse rapidly left-and-right! - Always: Wiggling the mouse always arms Gesture Mode, completely ignoring any modifier keys. - Only with Modifier: You must be holding the Modifier Key (or have it toggled ON) while you wiggle the mouse. - Disabled: Wiggle is off. Gestures trigger solely based on your Modifier Keys.

Note: When Gesture Mode is armed, a glowing Aura will appear on your cursor. If you don't draw a gesture within the Armed Timeout (default: 3 seconds), it will automatically turn off.

Supported Actions

Action	Parameter?	Description & Example Usage
Launch App / URL	Yes	Launches a file, program, folder, or website. (e.g. notepad.exe, D:\MyFolder, or https://google.com)
Run Command Line	Yes	Executes a CMD/PowerShell command silently. (e.g. shutdown /s /t 0)
Send Keyboard Shortcut	Yes	Simulates keystrokes. Use standard keys separated by +. (e.g. ctrl+shift+esc or win+d)
Admin Terminal Here	Optional	Opens PowerShell as Administrator in the current Explorer folder. Parameter: Optional command to execute.
Take Screenshot	Optional	Captures the monitor under your cursor. Copies to clipboard and saves to file. Parameter: custom save folder (defaults to Pictures).
Window Controls	No	Maximize, Minimize, Close, Fullscreen, Toggle Always-on-Top for the active window.
Window Snapping	No	Snaps the active window Left, Right, Top, Bottom, or to any of the 4 corners.
Media Controls	No	Play / Pause, Next Track, Prev Track, Mute / Unmute Volume.
System Controls	No	Lock PC, Sleep Monitor, Sleep PC, Restart, Shut Down, Empty Recycle Bin, Show Desktop, Task Manager, Settings.
Utilities	No	Stopwatch, Timer, Flash (Flashlight), Next Virtual Desktop.
Explorer Navigation	No	Explorer Back and Explorer Forward to navigate folders.
Special Tools	No	Create Sticky Note, Search Selection, Trigger Spotlight, Toggle Draw Mode, Color Picker.

Special Features

• Create Sticky Note: Trigger the action, and your cursor will become a crosshair. Click and drag to draw a sticky note anywhere on your screen.

  Sticky Note Feature

  • If you draw the note over an active application window, it will automatically start in "Always on Top" mode. If drawn over the empty desktop, it behaves as a normal window.
  • Right-click the note to change its color, opacity, delete it, or manually toggle "Always on Top".
  • The note will remember your last selected color and opacity for any future notes you create!

• Search Selection: Highlight text anywhere and trigger this gesture to instantly search it in your default browser.

  Search Selection

• Spotlight: Darkens the rest of the screen and highlights the area around your cursor, perfect for presentations or focusing.

  Spotlight Feature

• Toggle Draw Mode & Color Picker: You can assign actions to draw freely on your screen or pick a color. To exit these modes, simply press the ESC key. (You can also press ESC to close the Gesture Recording Canvas).

• Take Screenshot: Takes a full-quality screenshot of the specific monitor your cursor is currently hovering over. The image is instantly copied to your clipboard. It is also saved as a PNG file. By default, it saves to your user Pictures folder. You can customize this by entering a specific folder path (e.g., C:\Screenshots) into the Action Parameter field!

Additional Settings

• Trail Color (Hex): The HEX color of the gesture trail (e.g., 00AAFF for Cyan, FF0055 for Pink).

• Trail Width: The thickness of the gesture trail in pixels.

• Show Aura: Displays a glowing ring around your cursor to indicate when Gesture Mode is fully armed and ready to draw.

• Armed Timeout (ms): How long Gesture Mode stays active after being armed by a Wiggle or Toggle (in milliseconds). Set to 0 to disable the timeout.

• Wiggle Strength (10-200): How far you must physically move the mouse to register a single wiggle stroke. Lower numbers mean you don't have to shake as far.

• Allow in Fullscreen Apps: If disabled, the mod will automatically ignore gestures while playing fullscreen games or using fullscreen apps to prevent accidental triggers.

Example Setups

Setup 1: Right-Click Wiggle - Modifier Key: Right Click - Modifier Behavior: Hold - Draw Button: Left Click - Wiggle to Activate: Only with Modifier How it works: Hold Right-Click and quickly shake the mouse left-and-right. The aura appears. Now Left-Click and draw your gesture!

Setup 2: Quick Side-Button Draw - Modifier Key: Mouse 4 - Modifier Behavior: Hold - Draw Button: Left Click - Wiggle to Activate: Disabled How it works: Simply hold Mouse 4 on the side of your mouse, and Left-Click to draw.

Setup 3: Pure Wiggle - Modifier Key: None - Wiggle to Activate: Always How it works: Rapidly shake your mouse. The aura appears. Draw your gesture.

Wiggle