Getting started with Lekhini
Lekhini is an on-screen annotation overlay — a transparent, always-on-top window you can draw on, on top of any app. This guide gets you from download to your first annotation in a couple of minutes.
1. Install
Pick the download for your operating system from the Lekhini product page:
- Windows — run
Lekhini-Setup-1.1.0.exeand follow the installer. - macOS — open the
.dmgand drag Lekhini into Applications. Choose the Apple Silicon build for M1/M2/M3 Macs, or the Intel build otherwise.
On macOS, the first launch may require right-click → Open to bypass Gatekeeper on unsigned community builds.
Installed builds auto-update from GitHub Releases, so you’ll be prompted as new versions ship.
2. Grant permissions (macOS)
On first launch, macOS prompts for two permissions. Both are optional:
- Screen Recording — used only when you save an annotated screenshot. Denying it just disables screenshot export.
- Accessibility — lets global hotkeys work while another app is focused. Denying it disables global hotkeys when Lekhini isn’t in front.
To grant them later: System Settings → Privacy & Security → Screen Recording / Accessibility, then quit and relaunch Lekhini.
3. Toggle draw mode and start annotating
The overlay is click-through by default — clicks pass through to the app
underneath. Press ⌘⇧D (or click the status dot on the toolbar) to toggle
draw mode. The status dot turns green when you’re drawing, red when idle.
Now pick a tool from the floating toolbar and draw anywhere on screen:
- Pencil — graphite-textured, uniform width.
- Pen — smooth ink that thins with speed/pressure.
- Highlighter — translucent marker.
- Eraser, Hand (move/edit), and shapes (line, trendline, Fibonacci, rectangle, ellipse, arrow, text).
4. Save a screenshot
Press ⌘⇧S to capture the screen with your annotations baked into a saved
PNG.
5. Ask AI about a snip (optional)
Lekhini’s AI is opt-in and local-first. Enable it in Settings → AI — turn on Local AI (a first-run wizard installs Ollama and the recommended models) or pick a cloud provider and paste your own API key.
Once set up, snip a region of your screen and click Ask AI. A chat panel opens and solves what’s in the image — math, code, a question, an error — and you can keep asking follow-ups in the same conversation. Lekhini also transcribes handwriting on-device, autocorrects typed and recognized text, and (in the Trader profile) reads your drawn chart levels. With Local AI on, none of this leaves your machine.
Default hotkeys
| Shortcut | Action |
|---|---|
⌘⇧D | Toggle draw mode (click-through on/off) |
⌘⇧S | Screenshot + save annotated PNG |
⌘⇧C | Clear the current display |
⌘Z / ⌘⇧Z | Undo / redo |
Q | Pencil |
P | Pen |
H | Highlighter |
E | Eraser |
L | Horizontal line |
T | Trendline (hold Shift to snap to 15°/30°/45°/60°/75°/90°) |
F | Fibonacci retracement |
R | Region selector |
A | Arrow |
X | Text |
Profiles
Switch profiles from Settings → Profile; your choice is remembered.
- General — pencil, pen, eraser, hand, line, arrow, text, rectangle, ellipse, snip.
- Teacher — adds the highlighter for presentations.
- Trader — chart tools: trendline (Shift-snap), Fibonacci retracement and region selector.
A note on macOS fullscreen
No overlay tool can float above an app in native fullscreen (its own Space). Use maximized, non-fullscreen windows instead, or disable “Displays have separate Spaces” in System Settings → Desktop & Dock.
Next steps
Found a bug or want a feature? Open an issue on GitHub — Lekhini is community-owned and contributions are welcome.