Skip to content

Vim-Style MacOS Navigation

Choose a tag to compare

View all tags
@arturgrochau arturgrochau released this 24 Jul 19:48
· 48 commits to main since this release
v1.2.0
c0b1afb

🟩 VIM‑STYLE MAC NAVIGATION system — v1.2.0

✨ What’s New

  • 🚶‍♂️ Smooth, slower scrolling for d, u, w, and b; holds still scroll but at a gentle pace.
  • 🧠 Vim‑style “gg” and “G” scrolling: Press g twice in a row to jump to the top; press Shift + g to jump to the bottom.
  • 💻 Browser launcher: Press o in nav mode to open the first available browser (Arc, Chrome, Firefox, Safari, etc.).
  • 💬 ChatGPT hotkey change: The ChatGPT app is now summoned with c instead of g, and the binding automatically focuses the input box.
  • 🔄 Simplified nav‑mode behaviour: removed experimental drag‑hold on i; single i is just a double click (highlights word under cursor).
  • 📚 Documentation updates: README updated to reflect all new bindings, behaviours, and customization tips.
  • 🖱️ Improved double-click for i: Now simulates rapid double-click events to enable word highlighting/selection, mimicking macOS trackpad behavior.
  • 🔍 Refined screen handling for Option and Control taps: Option detects the current screen and moves the cursor to the center of the next screen; Control clicks near the bottom-center of the current screen (where text boxes are typically located).

🧩 Files Included

  • init.lua — Updated Hammerspoon config with refined key bindings and behaviors for double-click, Option, and Control.
  • README.md — Revised setup instructions and a complete table of commands matching the updated functionality.

📦 How to Install

Download the ZIP below, unzip it, and copy init.lua into your ~/.hammerspoon/ folder. Reload Hammerspoon or press ⌥ + r. See the README for full setup and usage details.

🧠 Usage Highlights

  • Tap ⌥ → Detects current screen and moves mouse to center of next screen.
  • Tap ⌃ → Clicks near bottom of current screen.
  • Press ⌃⌥⌘ + Space → Enters NAV MODE for Vim‑style control.
  • Use h/j/k/l to move the pointer and d/u/w/b to scroll; hold keys for continuous movement.
  • Press gg to jump to the top of a document, Shift + g to jump to the bottom.
  • Press c to open the ChatGPT app and focus the text field.
  • Press o to open your default web browser.
  • Press i for a double left click (e.g., to highlight words).

Built by Artur Grochau with Lua + ❤️

Assets 3
Loading