Repository navigation
Install OpenCircle
github-actions[bot] edited this page Nov 14, 2026
·
4 revisions
Install OpenCircle on Windows, or use the portable executable; Linux packages are available as a preview.
- Get the Windows Setup executable or portable executable from Releases. Linux users can choose a
.deb,.AppImage, or.rpm. - On Windows, run
OpenCircle-Setup-<version>-x64.exe. Choose Install OpenCircle, or customise the install folder. Running Setup for an existing installation offers Update OpenCircle or Repair OpenCircle, depending on the version. - Choose whether to Start with Windows and launch OpenCircle. The portable executable runs without an install.
- The Setup window speaks Windows' display language (English, or Arabic right to left). Follow the first-run prompts: your language first, then your update preference and the rest. A tray notice tells you OpenCircle is running and shows the shortcut.
- Press
Ctrl+Shift+Spaceto try it. You can change startup and update preferences in Settings. - To uninstall an installed Windows copy, use Windows' installed-apps list. The uninstall window lets you Keep or Remove settings, downloaded models, and saved keys. Keep is the default.
| Shortcut | What it does |
|---|---|
Ctrl+Shift+Space |
Open Circle to Search after launching |
Alt+Shift+T |
Translate the whole screen |
Esc |
Close the capture overlay; leave the question field first if focused |
- OpenCircle starts with Windows by default and waits in the tray. Turn this off in Settings if you prefer to start it yourself.
- Automatic updates are opt-in on first run. A new version downloads in the background; a pill above the tray offers Later or Restart now (the tray icon gets a dot). It installs on Restart now, when you quit or sign out, or after a minute with the screen locked (a Setup install only on Restart now, with one Windows prompt), then shows what's new.
- Updates must pass a signature check and a file checksum check before installation. The update check sends only the request, with no screen content, personal identifier, or telemetry.
- For Linux setup and desktop shortcut details, see Linux notes and Getting started.
- Silent install (for IT, winget, Scoop):
OpenCircle-Setup-<version>-x64.exe /quiet [/dir="…"] [/managed=<name>]; silent uninstall:/uninstall /quiet./managed=leaves OpenCircle's own updater off for a copy a package manager updates. Switches and exit codes: README. - Update signatures verify downloads; they are separate from Windows code signing. Windows SmartScreen may warn about the unsigned executable, and Windows 11 with Smart App Control on blocks it until OpenCircle is code-signed. See Signing.
- Linux is a preview.
.deband.rpminstallations notify you about updates and link to the release rather than replacing the package themselves. - Windows OCR needs an installed recognition language. Other text readers and offline translation models download on first use.
Previous: Snip · Next: Circle to Search · All features · Back to README
This page is generated from docs/features/install.md. Edit it there; changes made here are overwritten.