Skip to main content

Bloom on GitHub

Complete source code, installation guide, and configuration

​
What Is It?

Your local-first screen recorder, built for AI workflows. Bloom records on your machine (no lock-in), automatically uploads to VideoDB for transcription and indexing, then lets you search any moment with natural language. It’s Loom meets agent-ready infrastructure.
The Power: Your recordings become queryable data. Search “when did I mention the deadline?” or “show me the deployment steps” — get timestamped clips with context.

​
When to Use Bloom

Bloom shines in scenarios where you need recordings to become searchable data:
  • Sales demos: Record product demos once, search forever. “Show me when we explained the pricing model to enterprise clients last month.”
  • Bug reproduction: Capture exact steps that trigger issues, then let teammates search “when did the error first appear?”
  • Tutorial learning: Following along with video courses? Record your implementation so AI assistants can reference both the tutorial and your work.
  • Async team updates: Record your screen while explaining complex work. Teammates can search the recording instead of watching the whole thing.
  • Personal knowledge base: Capture important calls and workshops. Search months later when you need to remember “what did we decide about the API design?”

​
Why You Need This

​
No Lock-In

Your files stay on your machine:
  • Record locally, no forced cloud upload
  • Pay only for AI processing (when you need it)
  • Export and own your recordings
  • No subscription, no storage limits

​
How It Works

1

Record Locally

Capture screen, microphone, system audio, and camera with a floating control bar. Multi-monitor support lets you choose which display to record.
2

Upload to VideoDB (Optional but Powerful)

As you record, Bloom can sync chunks to VideoDB Cloud in real-time. Why? Processing video on your local machine would drain battery and CPU. By streaming to VideoDB, the heavy lifting—transcription, visual indexing, embedding generation—happens server-side while you keep working. You keep the local file, VideoDB keeps the intelligence.
3

Process with AI

VideoDB indexes spoken words, generates transcripts, and creates subtitled streams. Visual embeddings make every frame searchable.
4

Query Anywhere

Search your recordings with natural language. “Show me when I explained the architecture” returns timestamped clips with full context.
5

Share or Integrate

One-click shareable links, VideoDB Chat for questions, or API access for agent frameworks. Download MP4 files anytime.

​
Key Features

Complete Desktop Capture
  • Screen recording with multi-monitor support
  • Microphone and system audio capture
  • Draggable camera bubble overlay
  • Display picker to choose which screen
  • Global keyboard shortcut: Cmd+Shift+R
  • Always-on-top floating control bar
Organize Your Recordings
  • Browse all recordings with search
  • Sort by date (newest/oldest)
  • Rename recordings in-place
  • Delete with confirmation
  • Download recordings as MP4
  • Keyboard navigation (arrow keys, delete key)
Automatic Intelligence
  • Transcription of spoken words via VideoDB
  • Subtitle generation for video playback
  • HLS streaming with in-app player
  • Visual indexing for scene search
  • Metadata extraction from content
Connect with Workflows
  • One-click shareable links for any recording
  • VideoDB Chat to query recordings with AI
  • Download MP4 files for offline use
  • API access for agent frameworks
  • Integration with Claude Code and other tools
Open Source & Customizable
  • Full UI source code available (MIT license)
  • System tray integration with status indicator
  • Light/dark theme support
  • Permission management for mic, screen, camera
  • Local SQLite database for metadata

​
Tech Stack

Built for performance and reliability:

Electron 39.7

Desktop application shell

Node.js 18+

JavaScript runtime

VideoDB SDK 0.2.4

Recording and AI processing

SQLite (sql.js)

Local metadata storage

HLS.js

In-app video playback

Universal Binary

Apple Silicon + Intel support

​
Getting Started

Prerequisites
  • macOS 12+ or Windows 10+ (Linux support coming soon)
  • VideoDB API key (free tier available)
1

Install Bloom

Automated installation (recommended):
Manual installation:For manual install: mount the DMG and drag Bloom to Applications, then run:
2

Launch and Register

  1. Launch Bloom from Applications or Spotlight
  2. Enter your VideoDB API key (get one free)
  3. Grant system permissions when prompted
3

Grant Permissions

Bloom needs access to:
  • Microphone - For voice recording
  • Screen Recording - For screen capture
  • Camera (optional) - For camera bubble overlay
Grant these in System Settings > Privacy & Security.
4

Start Recording

  1. Press Cmd+Shift+R or click the Bloom icon in system tray
  2. Choose your display from the picker
  3. Toggle camera, mic, and system audio as needed
  4. Click Start Recording
macOS Permissions RequiredGrant in System Settings > Privacy & Security:
  • Microphone (for voice recording)
  • Screen Recording (for screen capture)
  • Camera (for camera overlay, optional)

​
Configuration

All features are configurable through the Bloom interface:

​
Privacy & Data

Local Recording - Files saved on your machine first, cloud upload is optional
No Lock-In - Download recordings anytime, export as MP4
Encrypted Storage - API keys encrypted, credentials protected
User Control - Delete recordings locally and from cloud independently

Complete Setup Guide on GitHub

Detailed installation instructions, troubleshooting guide, and development setup

Pair Programmer

AI coding assistant with screen and audio context

Focusd

AI-powered productivity tracking with automatic insights

Call.md

Real-time AI meeting assistant with live intelligence