guide to all twenty tools

updated

every module, what it is for and how it works. open the one you need, or read it end to end.

the panel itself

spaces

The icon holds up to four tabs, and you drag each module into whichever tab you like – the timer on one, the monitor on another, the things you rarely open tucked away. The power button beside a module turns it off: it keeps its place and stops running – no key, no badge, nothing collected in the background.

documents

The converter learned documents: markdown to PDF laid out by Hop itself, Word files (.docx, .doc, .rtf) to PDF or markdown, and a PDF's text pulled out as markdown – a scanned page is read with Apple's Vision. Native and offline, with no office suite bundled and nothing to download.

the menu bar icon

The icon carries small badges: the running time, keep-awake, a reminder that fired, a dot while a VPN is up (orange if it stops passing anything) and arrows while torrents move – colored or monochrome, each switchable. Hop's own windows appear in the Dock while they are open, so a click brings one back instead of opening the panel first, and the icon leaves with the last window.

themes, hotkeys and safe mode

Dark and light themes with a film-grain texture, global hotkeys, launch at login, and a safe mode that recovers the app from a crash loop – everything lives in one settings window.

frequently asked questions

where is hop after i install it?
in the menu bar, at the top right of the screen. hop has no Dock icon and no window of its own — click the asterisk and the panel opens under it. if the menu bar is crowded, macOS may hide the icon: hold command and drag the icons to reorder them.
how do i turn off modules i don't use?
open settings from the panel and switch off whatever you do not need. a module that is off leaves the panel and stops running entirely, so the list stays as short as you want it.
why does a module ask for a permission?
because the job needs it, and only then. screen recording is asked by text recognition when you frame an area, by screenshots and by the loupe and the blur on the drawing layer, accessibility by pasting, window moving and the keyboard lock, notifications by the timer and finished torrents. the info window has a tab listing every permission with its current state.
where does hop keep my data, and how do i remove it?
everything stays in your own user folder on the Mac: timers, tasks, clipboard history, converted files. nothing is sent anywhere. dragging the app to the trash removes it; the settings and history live in ~/Library and can be deleted alongside.
can i drive hop from a script or an ai assistant?
yes. hop reads commands from one plain file in its own folder and writes its state into another, and the same commands work as hop:// links. a shortcut, a script, claude code or codex can start a timer, add a to-do or open the panel without any server or api key.