Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nchudleigh/homerow
Keyboard navigation for all of macOS. Click, scroll, and perform tasks with your keyboard.
https://github.com/nchudleigh/homerow
Last synced: 9 days ago
JSON representation
Keyboard navigation for all of macOS. Click, scroll, and perform tasks with your keyboard.
- Host: GitHub
- URL: https://github.com/nchudleigh/homerow
- Owner: nchudleigh
- Created: 2022-09-20T12:16:01.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-11T19:48:52.000Z (6 months ago)
- Last Synced: 2024-12-09T21:39:00.110Z (12 days ago)
- Homepage: https://homerow.app
- Size: 38.1 KB
- Stars: 577
- Watchers: 10
- Forks: 7
- Open Issues: 96
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred-test - nchudleigh/homerow - Keyboard navigation for all of macOS. Click, scroll, and perform tasks with your keyboard. (Others)
README
Homerow - Navigate macOS with your keyboard
Click, navigate, and perform tasks with the keyboard, no mouse required.
https://homerow.app.
## Demo
## Download
Download Homerow and view the changelog [here](https://homerow.app/download/).
Requires macOS 12.3 or later.
## User Guide
This is Homerow's workflow:
1. Activate via shortcut (default is `Command-Shift-Space`)
2. Search for the UI element to click on
3. Labels (aka dynamic shortcuts) will be shown for the UI elements matching the query. The green target is the current focused UI element.
4. There are two ways to focus the correct UI element:
- Press `Tab` or `Arrow-Dn` until the correct UI element is focused
- Type the UI element's label text while holding `Shift`
5. Press `Return` to perform a click on the focused UI element
There is an option to use the Labels-only workflow, which disables the search feature and allows you to type the label text without holding down `Shift`.
### Queries
1. Spaces and cases are ignored
2. `*` and `;` will query for all UI elements
### Not sure what to type? The Tutor 🤓 comes to the rescue!
The Tutor shows you searchable properties of a UI element.
When Homerow is activated, you can call for the Tutor two ways:
1. Press `?` for Tutor to follow the focused UI element
2. Hover your cursor over the UI element
### Disable search for speed 🏃♂️💨
Labels-only mode disables search. Labels for all UI elements are always shown, and label-text can be typed without holding `Shift`. You can click more ergonomically by pressing `Space` instead of `Return`.
Made for those who ❤️ Vimium and Vimperator.
### Controls
| Action | Binding(s) |
| ------------- | ------------- |
| Focus next UI element | `Tab`, `Arrow Dn`, or `Control-N` |
| Focus previous UI element | `Shift-Tab`, `Arrow Up`, or `Control-P` |
| Jump focus to UI element | Type the label while holding `Shift` |
| Left-click | `Return` |
| Double left-click | Press `Return` twice in quick succession |
| Right-click | `Shift-Return` |
| Command-click (performs `Open Link in New Tab`) | `Command-Return` |
| Enable the `Tutor 🤓` | `?` or hover your cursor over the UI element |
| Exit | `Esc` |
### Scroll with HJKL keys 🛞
Activate Scroll-mode with the shortcut (default is `⇧ ⌘ J`) and start scrolling in the active scroll area with HJKL keys (DHTN in DVORAK).
| Action | Binding(s) |
| ------------- | ------------- |
| Scroll | `H/J/K/L` |
| Dash | `Shift-H/J/K/L` |
| Next scroll area | `Tab`, `Arrow Down`, or `Control-N` |
| Previous scroll area | `Shift-Tab`, `Arrow Up`, or `Control-P` |
| Jump to scroll area | `0-9` |
| Exit | `Esc` |
### Pro-tip: Map Caps Lock to Hyper Key
You'll likely activate Homerow quite frequently, so make the controls as comfortable and as quick as possible for the best experience.
Three reasons to use Hyper Key:
1. Activate Homerow with `Caps Lock + F`
2. Focus the next or previous UI Element with `Caps Lock + J` and `Caps Lock + K` respectively.
3. Navigate menus with `Caps Lock + H/J/K/L`
How to set up Hyper Key:
1. [Hyperkey](https://hyperkey.app) by Ryan Hanson OR
2. Configure Karabiner-Elements
- You can import my Karabiner Hyper Key rules by opening this link in your browser:
```
karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/dexterleng/homerow/main/hyper_key.json
```
- [View the rules JSON](https://github.com/dexterleng/homerow/blob/main/hyper_key.json)
## Support
Encountered a bug? Would like to request a feature? An app does not work well with Homerow?
Please let me know through:
- Open a GitHub Issue
- Email me at [email protected]
---
Homerow is developed by an indie developer (me). It can be evaluated for free. Please [purchase a license](https://www.homerow.app/pricing/) to support development. Thanks!