Skip to content

About

Open-source alternative to Google's Circle to Search for Windows & Linux: circle anything to search, translate the whole screen in place (great for games), ask AI, or snip & annotate. Rust, private, lightweight.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

60 stars

Watchers

1 watching

Forks

Repository files navigation

OpenCircle: circle anything on your screen to search, read, translate or ask AI

OpenCircle

Circle to Search for Windows and Linux. Free and open source.
Circle anything on your screen to search it, read it, translate it in place,
or ask an AI about it. Snip and mark up screenshots. Fast, private and light.

OpenCircle is one small native program for Windows and Linux that puts search, text reading, in-place translation, AI questions and a screenshot tool behind a few shortcuts. It never uploads your screen on its own: search and AI Mode open in your own browser, only when you choose them, and translation runs on your PC by default. It is free, MIT licensed, and has no account and no telemetry.

License: MIT Platforms: Windows and Linux

See it

Circle a picture on screen, then choose what to do with it.
Circle anything, then choose. Nothing is sent until you pick.
Select a line of text on screen and copy it.
Select text like on a desktop. Readable at once.
Snip an area, then hide text with Blur.
Snip, mark up, paste. Blur hides text for good.
Long capture: scroll a page by hand and OpenCircle stitches it.
Long capture. Scroll the page; it is stitched into one image.

Snip: an area is picked, with the grouped toolbar beside it. Translate in place: a page in English, then the same page in Arabic.

More in the gallery and the feature guides. The clips are short recordings of the real app; third-party material in them is credited in NOTICE and in Settings > About.

What works by default

  • Circle, then choose. Press Ctrl+Shift+Space, draw a circle or a box around anything, then pick what to do: Search in browser (the picture goes to Google Lens, selected text to a Google search), Copy text, Translate, or ask AI. Nothing is sent until you pick. The stroke snaps to a clean box that you can move, resize by its edges, or nudge with the arrow keys (Alt+drag moves it even over text). It opens on the screen your mouse is on, and all screens stay selectable.
  • Select text like on a desktop. Drag over words to copy, translate or search them. On Windows the text is readable at once with Windows' own text recognition; otherwise (and for Arabic or games) OpenCircle offers a one-time download of about 30 MB. On Windows and Linux, Arabic and pages that mix two languages are read part by part, each line by the reader that suits it; the Copy text button spins while the screen is still being read. Settings > Text reading

    Engine chooses.

  • Translate in place, built for games. Press Alt+Shift+T to translate the whole screen. The original text is erased and the translation is drawn in its place, with matching colour and size. On a game screen (menus, quest logs, HUDs) the translation is made to fit: a long label shrinks to its button and, as a last resort, is cut at a word with "...", never spilling over; names and numbers stay as written; counters like "x10" and "Lv. 80" survive. Browser address bars and file names are left alone, and big outlined subtitles are erased and redrawn at their size. It runs offline by default after a one-time model download (51 direct models, including Portuguese, and other pairs go through English); the target is the language you pick at the first start. Direct models into and out of Arabic make it faster. See Translate.
  • A glossary for each game. Keep a character's or a place's name exactly as you want it translated, or kept as written: one small file per game, on this PC only. It applies on game screens only (never in a browser), follows the game in front where the system gives its window title, and importing a friend's file merges into yours without losing your changes. OpenCircle also notices names that keep coming back on a game's screens and offers them with one click (a small dot on the pill's glossary button); nothing leaves your PC. See Translate.
  • Snip and annotate. Press Alt+A: the screen freezes, hover a window and click it (OpenCircle's own widgets too), or drag an area (Enter takes the full screen); Ctrl+C copies it at its original size. One grouped toolbar sits beside it: shapes, arrows, text, callouts, numbered steps, spotlight, magnifier, Blur (a fine pixel mosaic that hides text for good) and a solid Redact. Long capture: scroll the page yourself and OpenCircle stitches it. Steps keeps several snips on a slim strip and copies them as one numbered image. Also a colour picker, a screen ruler, Pin and Share. More also has Copy text, Ask AI and Translate for the picked area. Snip also takes a translated page as you see it (the translate pill's Snip button). Details: Snip and annotate.
  • One bottom bar. Ask OpenCircle AI about your screen, then Search in browser, Copy text, Translate and Snip. Ctrl+C copies the selection as an image (or the picked words as text), Ctrl+S saves it; a small pill confirms. Drag the bar to any of six spots, on any screen.
  • Ask AI about your selection. No key needed: the question and the circled picture open in Google in your browser (Lens, then AI Mode). Or add your own key for a chat inside OpenCircle with markdown and follow-ups: OpenRouter, OpenAI, Anthropic, Gemini, Groq, Mistral, DeepSeek, xAI, a local Ollama or LM Studio, or your own server, each with a list of its current models (OpenRouter's free router is the default). A follow-up pins the chat: it becomes its own window above other apps, the overlay closes by itself, and the chat stays. While the chat is open on the overlay, the bar stays beside it. Errors say plainly what went wrong and offer one fix. History is text only and stays on this PC. Optional web search (DuckDuckGo, then Wikipedia; no key, asked once) and one-click Connect OpenRouter sign-in.
  • Shortcuts for everything. Give any action its own key and skip the bar. Settings > Shortcuts can put them all back to the defaults.
  • In English or Arabic. The whole app, its setup and Settings speak Arabic right to left when you pick it (Settings > General > App language; picking Arabic as your language at the first start does it too).
  • 12 themes and Active Look. Pick a card in Settings > Appearance (light and dark; until you do, it follows the system). Sapphire Glow, a soft glow round the screen edge, is the default look; its colours also outline the snip area. The app, tray and installer icon is the Sapphire logo.
  • Updates that check a signature. Opt-in on first run. A new version downloads in the background and waits: a small pill above the tray offers Restart now, and What's new shows after the restart.

Settings > Appearance: 12 themes and the Active Look borders, with Sapphire Glow as the default.

Optional Labs features

Song search and live pins are off by default and hidden until enabled in Settings > Labs.

Private by design

  • Nothing leaves your computer unless you choose an action.
  • No account, no telemetry, no image-hosting service.
  • Snips stay in memory until you save them; only what you copy or save leaves the app.
  • A small log stays on your PC (logs/ in your local data folder) to help fix problems; nothing is sent. Settings > About has Copy diagnostics and Report a problem.
  • AI and song-search keys live in your system's keyring, never in a file.
  • Search and AI Mode open in your own browser, only when you press them. The picture goes from your browser to Lens; OpenCircle uploads it nowhere else.

Details: Privacy.

How it compares

  • Private by default. No image-hosting service sits in between, nothing is sent automatically, and translation and text reading can run fully offline.
  • One flow. Search, read, translate and ask AI come from the same selection and the same bar, instead of separate tools.
  • Windows and Linux with one native binary and no browser engine inside.
  • Honest limits. Search in browser and AI Mode are Google's services, opened in your browser, so they need the web and follow Google's own policies. Some features are Labs (unfinished).

Install

Download from the Releases page.

System Files
Windows 10 / 11 OpenCircle-Setup-<version>-x64.exe (the setup: one click, or pick the folder; for IT: OpenCircle-Setup-<version>-x64.exe /quiet /dir="C:\Apps\OpenCircle", uninstall with /uninstall /quiet), OpenCircle-<version>-x64-portable.exe (no install)
Linux .AppImage, .deb, .rpm

On Linux, one command downloads the latest AppImage, checks its signature, installs it to ~/.local/bin (no sudo), adds the app-menu entry and starts it:

curl -fsSL https://raw.githubusercontent.com/AmerAlreyahi/OpenCircle/main/scripts/install.sh | sh

Remove it again with ... | sh -s -- --uninstall. Read the script first if you like: scripts/install.sh.

Check a download with SHA256SUMS.txt from the same release:

sha256sum -c SHA256SUMS.txt --ignore-missing

Silent install (IT, winget, Scoop)

The setup installs for all users (it needs an administrator: from a normal prompt it stops with exit code 1925; winget and IT tools elevate it). It starts nothing and returns when the install is done.

Switch Does
/quiet (also /qn, /silent) no window; install or update in place
/dir="C:\Apps\OpenCircle" folder of a fresh install (an update stays where it is)
/uninstall /quiet remove OpenCircle (your settings and models stay)
/managed=<name> a package manager or IT tool updates this copy: OpenCircle's own updater stays off (it still says when a newer version exists). Passed to the MSI, which records it in OpenCircle's entry in Apps & features (HKLM, admin-only); pass it on every install or update, or the updater is on again. A portable copy uses a file opencircle.managed beside the exe instead (delete it to switch the updater back on)
/norestart accepted, nothing restarts the PC

Exit codes (Windows Installer's): 0 done, 3010 done, restart wanted, 1641 done, restart started, 1602 cancelled, 1603 fatal error, 1618 another install is running, 1638 a newer version is installed, 1639 bad /dir, 1925 not run as administrator.

Once the store packages are published, with winget: winget install AmerAlreyahi.OpenCircle. A copy installed through winget keeps its own updater (it updates through the same setup and winget sees the new version in Apps & features); winget upgrade works too. With Scoop (portable exe): scoop bucket add opencircle https://github.com/AmerAlreyahi/scoop-bucket, then scoop install opencircle; Scoop owns the updates there (the updater is off, Settings > General says so).

Windows SmartScreen may say "Windows protected your PC" because the installers are not code-signed yet (the project is free). Click More info, then Run anyway. See Signing to sign your own build.

Windows 11 Smart App Control. Where Smart App Control is on, Windows blocks unsigned programs outright and there is no "Run anyway". Until OpenCircle is code-signed (see below), either turn Smart App Control off in Windows Security > App & browser control > Smart App Control settings (Windows does not let you turn it back on afterwards, on some versions), or build from source. It is off on many PCs, and Windows 10 does not have it.

OpenCircle starts with Windows by default (tray only, no window). Turn that off in Settings.

The Getting started guide walks through the first run.

Code signing policy

We have applied to SignPath Foundation for free code signing (code signing by SignPath.io, certificate by SignPath Foundation). Until it is approved, the installers are unsigned and SmartScreen may warn.

Every release is built by GitHub Actions from a tagged commit in this repository, and each one is approved by hand before it is published.

Privacy: this program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. See the Privacy page.

Shortcuts

Action Shortcut
Circle to search Ctrl+Shift+Space
Translate the whole screen Alt+Shift+T
Circle, then explain with AI Ctrl+Shift+E
Circle, then copy its text Ctrl+Shift+X
Snip Alt+A

Colour picker and screen ruler have no default key. All of them change in Settings. Full list and details: Shortcuts.

Platforms

  • Windows 10 and 11: the full feature set.
  • Linux: X11 and Wayland. On Wayland the desktop owns the keys and the screen capture (GNOME asks once); shortcuts work on GNOME and KDE Plasma with or without the shortcut portal, long capture shows its progress in a small pop-up, picking a window is not offered (a click takes the screen), and Share is Windows only. See Linux notes.

Games must run in borderless or windowed mode for the translation to appear over them. Linux reads text with OpenCircle's own reader, a little slower than Windows OCR; on Wayland the overlay can take about half a second to appear and popups are square. AI-provider translation can be slower than the offline engine and may show the whole result at once.

Lightweight

One native program written in Rust, with no browser engine inside. The interface is drawn by iced. The goal is under 40 MB of RAM while idle. Reading text, translating and Lens start short helper processes that exit when they finish.

Build from source

Requires a recent stable Rust toolchain.

cargo build --release

Linux build dependencies (Debian/Ubuntu):

sudo apt-get install libxkbcommon-dev libwayland-dev libxcb1-dev libxrandr-dev libdbus-1-dev libpipewire-0.3-dev libgtk-3-dev libxdo-dev

docs/ARCHITECTURE.md describes how the code is organised.

Guides

Getting started · Shortcuts · Translate · Snip and annotate · Feature guides · Gallery · AI setup · Song search (Labs) · Privacy · Linux notes · Signing

About and credits

Settings > About lists the project, the licence, and every component OpenCircle uses that is made by others, with its licence. Text-reading and translation models are downloaded on first use under their own licences; see NOTICE. The translation models come from Hugging Face (Xenova's ONNX exports of the Helsinki-NLP OPUS-MT models) and, for the five direct Arabic models and the two Portuguese ones (Helsinki-NLP's multi-language Romance models) we converted ourselves, from AmerAlreyahi/OpenCircle-models. Every decoder is the lighter OptimaMT build (OptimaMT: OPUS-MT with the output layer built once; the same translations, less memory).

Contributing

Issues and pull requests are welcome. Run the checks before sending one:

cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test

License

MIT

Media exception: the preview clips (assets/previews: the stills bundled in the app, the full clips downloaded when you play a preview) show third-party material under its own terms, which the app's MIT licence does not relicense. Each clip's credit and licence is listed in NOTICE and in Settings > About.

OpenCircle is an independent project and is not affiliated with or endorsed by Google. "Google", "Google Lens" and "Circle to Search" are trademarks of Google LLC, used here only to describe the feature OpenCircle is an alternative to and the services it can open for you.

About

Open-source alternative to Google's Circle to Search for Windows & Linux: circle anything to search, translate the whole screen in place (great for games), ask AI, or snip & annotate. Rust, private, lightweight.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

60 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages