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.

​
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

Recordings automatically sync to VideoDB Cloud during capture. Real-time chunk upload keeps your cloud copy up-to-date.
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):
curl -fsSL https://artifacts.videodb.io/bloom/install | bash
Manual installation:For manual install: mount the DMG and drag Bloom to Applications, then run:
xattr -cr /Applications/Bloom.app
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:
FeatureCustomizable
Recording sourcesEnable/disable mic, system audio, camera
Display selectionChoose which screen to record
Camera positionDrag camera bubble anywhere on screen
Keyboard shortcutDefault: Cmd+Shift+R
ThemeLight or dark mode
Storage locationLocal database at ~/Library/Application Support/bloom/

​
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