Docs.
Install, permissions, links, backups, and what to do when something is off.
Install
- Download Rimline-1.0.0.dmg from the download page, open it, and drag Rimline to Applications. Or run
brew install --cask zawalid/rimline/rimline. - Open Rimline once. It is not notarized yet, so macOS asks you to confirm: close the warning, then System Settings, Privacy & Security, Open Anyway. Or run
xattr -dr com.apple.quarantine /Applications/Rimline.app. - Allow Accessibility when asked. The setup window continues by itself once you do.
Permissions
Rimline asks for Accessibility (System Settings, Privacy & Security, Accessibility). It needs it to read touches on the trackpad and to move windows. Two actions ask for more the first time you use them: dark mode asks to control System Events, and screenshots use the macOS shortcuts. Nothing leaves your Mac.
Updating
Rimline can check GitHub once a day for a newer version. It is off until you turn it on in General, then Updates. It shows what is new and only installs when you press Install Update. With Homebrew, brew upgrade --cask rimline also works. Pick one way.
rimline:// links
Rimline answers links, so a shortcut, a script or a launcher can ask it for something, and a gesture's Open a link action can too. General has a Links section with a Copy button for each scene.
| Link | What it does |
|---|---|
rimline://open | Open the window |
rimline://open/trackpad | Open a tab: trackpad, feel, appearance or general |
rimline://setup | Open the setup |
rimline://pause | Pause until resumed |
rimline://pause?minutes=30 | Pause for 30 minutes |
rimline://resume | Resume |
rimline://toggle-pause | Pause or resume |
rimline://scene/Music | Turn a scene on or off, by name or id; add ?state=on or ?state=off |
rimline://action/cheatSheet | Show the gesture cheat sheet |
rimline://workflow/Start%20my%20day | Run a workflow by name |
Backup and sharing
In General, Backup and presets saves your setup to a .rimline file with the parts you choose: layout, gestures, apps, scenes, workflows, feel and timing, look and feedback, and your own presets. Double-click a file, or drop it on the app, to see what is inside and put parts back. Presets you saved are added to yours rather than replacing them. Commands inside a file from someone else are counted and kept out unless you allow them. Undo the last change is always one click away.
Troubleshooting
The menu bar icon is not there
A crowded menu bar, or a manager such as Ice or Bartender, can push a new icon out of sight. Rimline always opens from its Dock icon too. General shows Icon hidden with a Bring it back button.
macOS gestures fire at the same time
For three and four fingers, the Multi-finger page reads your macOS trackpad settings and marks the gestures where macOS does the same thing. A hold is the clean choice there. A two-finger tap can also right-click if that is on in System Settings.
Coming from the earlier build
If you ran Rimline before it had its own identifier (it was net.sabiss.edgeline), the first launch copies your settings over. Rimline asks for Accessibility and Open at login once more.
Uninstall
Quit Rimline and drag it from Applications to the Trash. With Homebrew, brew uninstall --zap --cask rimline also removes its settings.