Skip to content

zachpoblete/MouseToys

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🖱️ 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

  • ❶ is LButton
  • ❷ is RButton
  • Pushing directly down on ❸ is MButton
  • Scrolling ❸ forward is WheelUp
  • Scrolling ❸ backward is WheelDown
  • ❹ is XButton1
  • ❺ is XButton2

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