https://github.com/dxrcy/mousr
Move mouse cursor with keyboard!
https://github.com/dxrcy/mousr
Last synced: 2 months ago
JSON representation
Move mouse cursor with keyboard!
- Host: GitHub
- URL: https://github.com/dxrcy/mousr
- Owner: dxrcy
- License: mit
- Created: 2022-08-01T23:28:30.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2022-08-05T00:01:14.000Z (almost 3 years ago)
- Last Synced: 2025-03-15T08:37:17.061Z (3 months ago)
- Language: AutoHotkey
- Size: 93.8 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/darccyy/mousr/issues/new/choose) 😊
Pronounced /maÊŠsÉš/
Now written in [AutoHotKey](https://autohotkey.com)!
# How to use
## Installation
1. Download the [latest version](https://github.com/darccyy/mousr/releases/tag/v0.1.2)
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](#changing-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](https://www.autohotkey.com/) is installed.
```bash
# 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](https://github.com/darccyy)
# TODO
- [ ] Fix mouse movement
- [ ] Create linux, mac binaries
- [ ] Test
- [ ] Survey