Mousr

A compiled customizable AutoHotKey script to fully control the mouse cursor, clicks, and scrolling with the keyboard!

Releasing full version soon...

Issues, Bugs and Missing Features can be submitted here 😊

Pronounced /maʊsɚ/

Now written in AutoHotKey!

How to use

Installation

1. Download the latest version
2. Extract the zip and move the folder somewhere safe (Do not separate executable from other files)
3. Run Mousr.exe
4. Press 'More info' and then 'Run anyway' (If you are worried that it's a virus, the full source code is available for each release)

.It should run automatically.

• How to change controls

Controls

Shortcuts are only work when the program is active (when tray icon is green), except for Alt+Insert (MISC.ACTIVATE)

Default controls, listed with config names:

• F5 spins the cursor in a circle (to test if it is functioning). MISC.SPIN

• Alt+Insert activates and deactivates the program. MISC.ACTIVATE

• • Shift+Alt+Insert kills the program. MISC.KILL

• ijkl moves the cursor (Up, Left, Down, Right). MOUSE.LEFT, MOUSE.UP, ect.

• • Holding Shift slows the speed. MOUSE_SLOW.LEFT, MOUSE_SLOW.UP, ect.

• u, 8, o map to the Left, Middle (scroll), and Right clicks respectively. CLICK.LEFT, CLICK.MIDDLE, CLICK.RIGHT

• • y toggles the left click up and down. CLICK.HOLD
• • [, ] map to buttons 4 and 5 (side of mouse). CLICK.4, CLICK.5

• wasd scrolls (Up, Left, Down, Right). SCROLL.LEFT, SCROLL.UP, ect.

• v, b increase or decrease speed of cursor. SPEED.DOWN, SPEED.UP

• • Holding Shift sets speed to minimum or maximum. SPEED.MIN, SPEED.MAX

• g resets speed SPEED.RESET

Changing controls

To change hotkeys or settings, make sure Mousr not running, and edit config.ini in the app directory, then restart Mousr.

Settings

• SETTINGS_MISC.START: Whether the program starts activated by default (Boolean)

Speed

• SETTINGS_SPEED.DEFAULT: Initial speed of mouse when program starts or speed is reset (Number)
• SETTINGS_SPEED.SLOW: Speed multiplier for slow mode (Number)
• SETTINGS_SPEED.ACCEL: How quickly the speed changes when decreasing in increasing (Number)
• SETTINGS_SPEED.MIN: Minimum speed (Number)
• SETTINGS_SPEED.MAX: Maximum speed (Number)
• SETTINGS_SPEED.DURATION: How long the mouse takes to moves each step, 1 is AHK default (Number)

Spin

• SETTINGS_SPIN.AMOUNT: Resolution of circle, amount of calculations (Number)
• SETTINGS_SPIN.SIZE: Radius of circle (px)
• SETTINGS_SPIN.DURATION: Time the circle takes to draw (ms)

Popup

• SETTINGS_POPUP.ENABLED: Whether popup enabled (Boolean)
• SETTINGS_POPUP.SIZE: Size of popup (px)
• SETTINGS_POPUP.DURATION: Time it stays on screen (ms)

Contributing

Make sure AutoHotKey is installed.

# Copy repository
git clone https://github.com/darccyy/mousr.git

# Run file
start "C:\Program Files\AutoHotkey\autohotkey.exe" Mousr.ahk

# Compile binaries
powershell -ExecutionPolicy ByPass -File compile.ps1

Created by darcy

TODO

• Fix mouse movement
• Create linux, mac binaries
• Test
• Survey