Skip to content(if available)orjump to list(if available)

Show HN: FlashRecord – 2MB Python-native CLI screen recorder

Show HN: FlashRecord – 2MB Python-native CLI screen recorder

7 comments

·October 26, 2025

Hi HN — I built FlashRecord, a tiny (≈2MB) Python-native CLI tool for screenshots and GIF recordings aimed at developers who want automation-friendly, scriptable screen capture without a GUI.

### What it is

- CLI-first and importable (import flashrecord) so you can plug it into scripts, tests, CI pipelines, or docs generation. - Outputs GIFs (and screenshots) with a pure-Pillow/NumPy implementation of a CWAM-inspired compression pipeline (multi-scale saliency, temporal subsampling, adaptive scaling). - Cross-platform (Windows/macOS/Linux), zero-config defaults, and production-ready with tests/docs.

---

### Why it might be interesting

- Tiny install and no heavyweight GUI/tooling to manage. - Designed for automation: generate evidence GIFs in CI, attach demo GIFs to PRs, or create tutorial assets from scripts. - Compression focuses on preserving visually important regions while reducing file size dramatically in typical UI demos.

---

Repo & license: https://github.com/Flamehaven/FlashRecord — MIT licensed.

---

I’m happy to answer technical questions, performance numbers, cross-platform quirks, or walk through the compression pipeline. Feedback, issues, and PRs welcome. What it is

CLI-first and importable (import flashrecord) so you can plug it into scripts, tests, CI pipelines, or docs generation.

Outputs GIFs (and screenshots) with a pure-Pillow/NumPy implementation of a CWAM-inspired compression pipeline (multi-scale saliency, temporal subsampling, adaptive scaling).

Cross-platform (Windows/macOS/Linux), zero-config defaults, and production-ready with tests/docs.

Why it might be interesting

Tiny install and no heavyweight GUI/tooling to manage.

Designed for automation: generate evidence GIFs in CI, attach demo GIFs to PRs, or create tutorial assets from scripts.

Compression focuses on preserving visually important regions while reducing file size dramatically in typical UI demos.

Quick try (from source)

git clone https://github.com/Flamehaven/FlashRecord cd FlashRecord pip install -e . flashrecord @sc # instant screenshot flashrecord @sv 5 10 # 5s GIF at 10 FPS (interactive by default)

Repo & license: https://github.com/Flamehaven/FlashRecord — MIT licensed.

I’m happy to answer technical questions, performance numbers, cross-platform quirks, or walk through the compression pipeline. Feedback, issues, and PRs welcome.

butteredpecan

A [vibecoded] warning might be appropriate.

What's the purpose of the AIPromptManager[0] class in a CLI screen recording project?

[0] https://github.com/Flamehaven/FlashRecord/blob/084e3308d7984...

hnlmorg

I’ve been using vhs recently. Same kind of solution: CLI, easy to install, bug focus on automation, supports gif, png, webp, etc. I’ve been really impressed with the output of vhs

https://github.com/charmbracelet/vhs

whinvik

What kind of usecases does a screenshot CLI have?

gus_massa

Where is the license?

tecleandor

Readme says "MIT License - See LICENSE file" bit there's no LICENSE file.

VISION.md file feels very weird to me...

bakugo

The AI that generated the entire project forgot to add it.

hnlmorg

There’s lots of other documents referenced in (for example) CONTRIBUTING that doesn’t exist in the repository.

I’ve got zero issue with using AI for development, but the author really should have read their documentation afterwards to sanity check it.

Though it’s also possible they’re not English literate. I also found some markdown documents written in Korean.