Our take
- Activity
- 29
- Community
- 47
- Issues
- 46
- Pull requests
- 46
+27 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
4,916Forks
111Change since Nov 17, 2026: -1 stars·+1 forks
Overview
Freeze is a Go command-line tool for rendering source files and terminal output as images. It helps developers create shareable, styled code and terminal screenshots without manually arranging them in an image editor.
It can read code from files or standard input, and can capture ANSI-formatted output from a command. An interactive mode and configuration files let users adjust the appearance for repeated use.
Key Features
- Render code files or standard input as images.
- Capture terminal command output with the
--executeflag. - Export PNG, SVG, and WebP images.
- Customize syntax theme, font, line numbers, background, padding, and window styling.
- Save and reuse settings through JSON configuration files.
- Adjust settings in an interactive terminal interface.
- Capture terminal UI states by piping
tmux capture-paneoutput into Freeze.
Use Cases
- Developers can create consistent code visuals for documentation and tutorials.
- Educators and technical writers can prepare readable code examples for slides or articles.
- CLI maintainers can share formatted command output in release notes or support discussions.
- Terminal UI developers can capture a chosen application state for documentation or bug reports.
Getting Started
Install with Go:
go install github.com/charmbracelet/freeze@latest
For other installation options and usage details, see the README.
Alternatives
- VHS: VHS scripts and records terminal sessions as GIFs or videos, while freeze creates static images of source code or terminal output.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| freeze | Go | MIT | 4.9k | Not checked yet |
| vhs | Go | MIT | 21.1k | Active |
Considerations
Freeze is a command-line utility, so users need to be comfortable working in a terminal. Its output is intended as a visual rendering, not an editable code document. Check the README for installation options and the full list of supported customization settings.
Found this useful?
Share it with someone who would like freeze.