charmbracelet

freeze: Create Images of Code and Terminal Output

Freeze turns source code and terminal output into polished PNG, SVG, or WebP images. It suits developers who need consistent visuals for documentation, tutorials, presentations, or sharing command-line results.

View on GitHub Compare
Stars
4.9k
Forks
107
Stars, last 30 days
+27

Our take

Health score

42/100

How it is scored
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.

Selected snapshot

Stars

4,916

Forks

111

Change 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 --execute flag.
  • 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-pane output 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.
ProjectLanguageLicenseStarsStatus
freezeGoMIT4.9kNot checked yet
vhsGoMIT21.1kActive

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.

Comparisons