Bolo User Guide

Record your screen.
Speak your mind.

Bolo is a single-file browser screen recorder. Captions, summaries, annotations, blur-in-export — all running on your machine. Nothing leaves your device.

Bolo v1.0.0 · bolo.naklitechie.com

1First look

Open Bolo and you're looking at the recorder. The big black area on the left is the stage — your live preview during recording and the playback after. Everything else lives in the right sidebar.

Bolo's idle state — empty stage, Sources and Captions panels in the sidebar.
The idle state, fresh load. Pick your sources on the right to start.

The header chip pair at the top right is the mode toggle. Bolo opens in Quick mode by default — the simplest possible recorder. Click Studio to unlock Looks, AI insights, annotations, and burn-in export.

2Quick vs Studio

Two modes, one toggle:

Studio mode active — the sidebar grows a Look panel below Sources.
Studio mode active. The sidebar grows new panels (Look here; Annotations & AI Insights appear after recording).

Your choice persists across sessions per device.

3Pick your sources

The Sources panel has three toggles:

You can mix any combination. Screen + webcam composites the webcam as a draggable picture-in-picture overlay during recording.

Tip: if Bolo detects you accidentally picked its own tab as the screen source (which would create a feedback loop), it stops the share and warns you.

4Looks & follow-cursor

Studio mode only. The Look panel applies framing to your recording — gradient background, padding, rounded corners, drop shadow. Five presets:

Spotlight Look applied to the stage — radial vignette around the empty preview.
Spotlight Look applied. The stage mirrors the framing live so you see what you'll get before recording.

Follow cursor (auto-zoom) — toggle below the Look chips. When on, the canvas gently zooms 1.4× toward whatever's moving on screen. Bolo infers cursor position from frame-to-frame pixel deltas (the browser can't read it directly the way native screen recorders can).

Note: the live stage preview shows the Look's background and rounded corners. The actual composition (gradient + padding + cursor zoom) is baked into the WebM during recording.

5Record

Hit the big red REC button at the bottom right (or press ⌘⇧B). Bolo counts down 3 · 2 · 1, then starts.

Stop with the FAB or ⌘⇧B again. You land back on the stage with the playback ready.

Post-recording state — playback area, Recording Ready panel with action buttons.
Right after stopping. The setup panels collapse; the playback and the Recording Ready actions take over.

6Captions (Whisper)

Click ✨ Generate Captions in the Recording Ready panel. Bolo runs Whisper Small (Xenova/whisper-small via Transformers.js) locally in a Web Worker.

Each transcript segment is editable in place — click any line to fix typos. Timestamps are clickable to seek the playback.

7AI insights

Studio mode only. Once you have a transcript, click ✨ Generate title, summary, chapters in the AI Insights panel. Bolo runs Qwen 2.5 0.5B Instruct on WebGPU (via Transformers.js v4) and produces:

Transcript and AI insights panels populated — title, summary, and four clickable chapters.
Transcript above, AI insights below. Click any chapter to seek the playback to that moment.

First run downloads ~350 MB of model weights, cached forever. The insights are stored on the recording's history entry so they survive reloads.

8Annotations & blur

Studio mode only. The Annotations panel adds four draw tools you can use directly on the playback:

Each annotation is visible for 3 seconds from the moment you draw it. Pause the playback to set the exact starting frame.

Playback with an arrow, a box, a text label, and a blur rectangle, with the annotations list in the sidebar.
All four annotation tools on the same frame, listed in the sidebar.

Annotations persist on the recording's history entry. They never leak between recordings.

Use the blur tool for: credit cards, passwords, customer PII in a dashboard, API keys in a terminal — anything that shouldn't ship in a shareable video.

9Export

Bolo has two export paths:

↓ Download (instant)

The original captured WebM/MP4 plus a sidecar .srt if you have captions. VLC, IINA, mpv all auto-load the SRT. Native, no re-encoding.

🎬 Export with overlays burned in

Studio mode only. Re-encodes the recording with captions and/or annotations baked into the pixels. Useful when the destination doesn't understand sidecar SRT — YouTube, Twitter, embedded players, social media.

Burn-in export button with aspect-ratio chips: Native / 1:1 / 9:16 / 16:9.
The burn-in export with aspect-ratio presets. Pick the right shape for the destination.

Non-native aspects use cover semantics — the source is center-cropped to fill the target frame. The output filename gains a -1x1 / -9x16 / -16x9 suffix.

Export speed: burn-in re-encodes via canvas + MediaRecorder driven by the source video's requestVideoFrameCallback. Roughly real-time — a 5-minute recording takes ~5 minutes to bake. The progress bar shows the playhead so you know how far along it is.

11Keyboard shortcuts

ShortcutAction
⌘⇧B / Ctrl⇧BStart / stop recording
⌘⇧. / Ctrl⇧.Pause / resume
EscCancel and discard the current recording

⌘⇧R would conflict with the browser's hard-reload shortcut, so Bolo uses B for "Bolo".

12Privacy

Everything stays on your device. There is no backend. There never will be. Bolo's only network calls are the one-time downloads of Whisper (~250 MB) and Qwen (~350 MB) from the Hugging Face CDN — and those land in your browser's Cache Storage, accessible only to this site. Close the tab and your recordings stay in your private OPFS, visible only to you, only on this device. Use Download to copy anything to disk.

No telemetry. No analytics. No accounts. No share links. No cloud upload. The transcripts, the AI insights, the annotations, the blur regions — all generated locally and stored locally.