Skip to content

Install OpenCircle

github-actions[bot] edited this page Nov 14, 2026 · 4 revisions

Install OpenCircle

Install OpenCircle on Windows, or use the portable executable; Linux packages are available as a preview.

How to

  1. Get the Windows Setup executable or portable executable from Releases. Linux users can choose a .deb, .AppImage, or .rpm.
  2. 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.
  3. Choose whether to Start with Windows and launch OpenCircle. The portable executable runs without an install.
  4. 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.
  5. Press Ctrl+Shift+Space to try it. You can change startup and update preferences in Settings.
  6. 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.

Shortcuts

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

Tips

  • 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.

Limits

  • 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. .deb and .rpm installations 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.

Clone this wiki locally