zachpoblete / MouseToys

Mouse shortcuts to ease your workflow
MIT License
11 stars 0 forks source link
ahk autohotkey autohotkey-v2 mouse shortcuts

πŸ–±οΈ MouseToys

Keyboard shortcuts are awesome. But sometimes, you just have one hand on the mouse:

cueball

What if you could do the most common keyboard shortcuts from just your mouse?

πŸ’» How to use

  1. Grab a mouse with extra side buttons (see Buttons guide).
  2. Download AutoHotkey v2.0 (here are the docs).
  3. Download and extract the ZIP of this repo.
  4. Run MouseToys.ahk and try out these shortcuts!

πŸš€ Accelerated scroll (Scroll wheel)

Press this To do this
WheelUp πŸš€ Accelerated scroll up (Scroll faster to scroll farther)
WheelDown πŸš€ Accelerated scroll down

πŸͺŸ Window and general shortcuts (XButton1)

Press this To do this
XButton1+WheelDown ⬇️ Cycle through windows in recently used order (Alt+Tab)
XButton1+WheelUp ⬆️ Cycle through windows in reverse used order
XButton1+MButton 🚚 Restore window and move it using the mouse
XButton1+MButton+WheelDown ↙️ Minimize window
XButton1+MButton+WheelUp  β†—   Maximize window
XButton1+MButton+RButton ❎ Close window
XButton1+MButton+LButton πŸ“Έ Screenshot
XButton1+LButton ⌦  Send Delete key
XButton1+LButton+RButton  βŽ   Send Enter key
XButton1+RButton πŸ“‹ Copy to clipboard
XButton1+RButton+LButton πŸ“‹ Paste from clipboard
XButton1+RButton+WheelDown ↩️ Undo
XButton1+RButton+WheelUp β†ͺ Redo

🌐 Tab and page shortcuts (XButton2)

Press this To do this
XButton2+WheelUp ⬅️ Go to left tab
XButton2+WheelDown ➑️ Go to right tab
XButton2+RButton+WheelDown ⬇️ Cycle through tabs in recently used order
XButton2+RButton+WheelUp ⬆️ Cycle through tabs in reverse used order
XButton2+RButton ❎ Close tab
XButton2+RButton+LButton β†ͺ Reopen last closed tab
XButton2+LButton ⬅️ Go back one page
XButton2+LButton+RButton ➑️ Go forward one page
XButton2+LButton+MButton πŸ”„ Refresh page
XButton2+LButton+WheelUp πŸ” Zoom in
XButton2+LButton+WheelDown πŸ” Zoom out
XButton2+MButton πŸ”— Ctrl+Shift+Click
Use to open a link in a new active tab
or select multiple tabs

πŸ–±οΈ Buttons guide

mouse buttons

An example of a 3-button combination is XButton1+MButton+RButton. This means to press & hold XButton1, press & hold MButton, and press & release RButton.

🚩 Known issues

  1. Some mice don't do 3-button combinations well
  2. Shortcuts can be triggered twice if you click a certain way [1 solution]
  3. Lag when moving window across monitors

πŸ“œ License

MIT