Skip to content

zachpoblete/MouseToys

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

783 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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? (without moving it!)

💻 How to use

  1. Grab a mouse with extra side buttons (see Buttons guide).
  2. Download MouseToys (make sure you have AutoHotkey v2 installed first).
  3. Run MouseToys.ahk (keep it in the folder) 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

You can enable or disable Accelerated Scroll by right-clicking the AutoHotkey tray icon. This opens the tray menu where you can toggle the checkmark next to "Enable Accelerated Scroll".

🪟 Window and general shortcuts (XButton1)

Press this To do this
Xbutton1 ⬅️ Go back one page
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 ↙️ Restore/minimize window
XButton1+MButton+WheelUp  ↗   Maximize window
XButton1+MButton+RButton ❎ Close window
XButton1+RButton+WheelUp 🔊 Increase volume
XButton1+RButton+WheelDown 🔈 Decrease volume
XButton1+RButton+LButton ⏯️ Play/pause media
XButton1+LButton  ⏎   Send Enter key
XButton1+LButton+RButton ⌦  Send Delete key
XButton1+LButton+MButton 📸 Screenshot

🌐 Tab and page shortcuts (XButton2)

If a shortcut doesn't work on a particular window, you can edit the source code :D

Press this To do this
Xbutton2 ➡️ Go forward one page
XButton2+WheelUp ⬅️ Go to left tab (in a browser for example)
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 🔄 Refresh page
XButton2+LButton+MButton 📋 Duplicate page
XButton2+LButton+RButton 🔍 Paste and search or Paste and go (if it's a URL)
XButton2+LButton+WheelUp 🔍 Zoom in
XButton2+LButton+WheelDown 🔍 Zoom out
XButton2+MButton 🔗 Click a link to open it in a new active tab

🖱️ 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. Lag when moving window across monitors
  3. Accelerated Scroll lag / suddenly too fast on sites like Google Docs

📜 License

MIT - You can use my code in your projects. Just credit me.

📖 Wiki

The MouseToys wiki can be found here.

About

Mouse shortcuts to ease your workflow

Topics

Resources

License

Stars

Watchers

Forks

Contributors