thebristolsound

birdbrain: Capture and Verify Web Evidence with Electron

Birdbrain is a local-first Electron desktop app with a Chromium extension for capturing web evidence, organizing it into cases, and checking its integrity. It runs on Windows and Ubuntu, with an experimental macOS build, and is aimed at OSINT investigators and journalists.

Stars
8
Forks
1
Last commit
today
Contributors
9
Releases, 12 months
1

Our take

Activeregular commits and releases

Health score

68/100

How it is scored
Activity
66
Community
34
Issues
87
Pull requests
86
  • Merges more pull requests than 100% of the projects we track
  • Closes issues faster than 82% of the projects we track

Birdbrain is an active beta with regular development, but its evidence workflow is still maintained primarily by one contributor and should not be treated as proof that a captured page was authentic.

Good fit if

  • You need a local-first desktop workflow for capturing and organizing web evidence.
  • You want integrity checks and a portable verification runbook for exported evidence packages.
  • You can use a beta application on Windows or Ubuntu, or test its experimental macOS build.

Look elsewhere if

  • You need shared cases or automatic capture, which the README lists as planned work.
  • Your process requires court-tested evidence handling; the README says the workflow has not been tested in court.
  • Your team needs a mature, independently maintained product rather than a beta project whose work is concentrated in one contributor.
All health signals
Last commit2026-10-18 (today)
Commits, last 90 days100+
Releases, last 12 months1 (latest v1.0.1-beta.23, 2026-10-12, pre-release)
Contributors9 (top contributor: 83% of commits)
Issues closed, last 90 days17+ (typically closed in 0 days)
Pull requests merged, last 90 days100+ (typically merged in 0 days)
Project age7 months

Checked on 2026-10-18 with the GitHub API.

Overview

Birdbrain is a local-first Electron desktop app, written in TypeScript, with a companion Chromium extension for OSINT investigators and journalists who need to capture web pages as evidence and later check whether the saved record has changed. It runs on Windows and Ubuntu, with an experimental macOS build, and stores cases on the investigator’s machine.

A capture includes an MHTML page, a full-page screenshot, and extracted text. Birdbrain hashes the saved content, records it in a signed, hash-chained manifest, and requests an RFC 3161 timestamp. These controls help show whether a stored record has changed, but they do not establish that the original page was genuine.

Key Features

  • Capture pages from the Chromium extension as MHTML, screenshots, and extracted text.
  • Organize captures in per-case folders stored locally.
  • Record SHA-256 hashes in a signed, hash-chained manifest.
  • Request RFC 3161 timestamp tokens, with timestamp status remaining pending until the authority responds.
  • Verify a case’s manifest chain in the desktop app.
  • Export evidence packages with a VERIFY.md runbook for checks using sha256sum, openssl, and jq.
  • Operate without an account or telemetry; captures leave the machine only when exported.

Use Cases

  • An OSINT investigator preserving a web page and its contents for later review.
  • A journalist organizing captured pages by case and sharing an evidence package with a recipient.
  • A researcher who needs a recipient to verify exported files without installing Birdbrain.
  • A team testing a local evidence-capture workflow with synthetic or low-stakes material before relying on it for sensitive work.

What you need

Detected in the repository

  • Node.js >=20.19.0 (from package.json)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

The project requires Node.js 20.19.0 or later and pnpm. To run the development app:

pnpm install
pnpm dev

For platform downloads and extension setup, see the download guide and tester guide. See the README for development and project details.

Alternatives

  • web-archive: It saves webpages as searchable, shareable HTML archives, rather than organizing captured evidence into investigation cases and checking its integrity.
ProjectLanguageLicenseStarsStatus
birdbrainTypeScriptMIT8Active
web-archiveTypeScriptGPL-3.0932Quiet

Considerations

Birdbrain is in public beta. It has recent, regular commits and merged changes, but one contributor accounts for most of the project’s contributions. The project has published a beta release within the past year, and the README recommends using synthetic or low-stakes material where possible and exporting anything that cannot be lost. Shared cases and automatic capture are not yet available. A verified chain can indicate that a record has not changed without the signing key, but it cannot prove the source page was genuine. The project is MIT-licensed; review the license and the threat model before adopting it.

Found this useful?

Share it with someone who would like birdbrain.