charmbracelet/freeze
Freeze
Freeze is a code-to-image generator and terminal output renderer that converts source code and ANSI terminal text into high-quality images. It functions as a command-line tool that transforms text and styled sequences into scalable vector graphics for use in documentation and presentations.
The tool differentiates itself by capturing raw output from shell commands via a pseudo-terminal environment and translating ANSI escape codes and colors directly into SVG styles. It features a terminal user interface for real-time parameter adjustment and supports configuration profiles to maintain consistent visual styles across multiple exports.
The capability surface covers typography management through custom font embedding and line height control, as well as visual styling for window frames, shadows, and margins. It also includes utilities for syntax highlighting and cropping specific line ranges from code snippets.
Features
- Styled Code Image Exporters - Render code and terminal text into high-quality images using SVG conversion and custom font rendering.
- Terminal-Driven Image Renderers - Converts shell text and ANSI output into high-quality graphical image files for documentation and presentations.
- Code Snippet Visualizers - Generates high-quality, aesthetic images of source code snippets for technical documentation.
- Styled Code Screenshot Creators - Creates styled, shareable screenshots of code and terminal sessions with customizable themes.
- Code-to-SVG Visualizers - Transforms code snippets into scalable vector graphics with configurable fonts and window frames.
- ANSI-to-SVG Translators - Parses terminal escape codes and colors to map them to visual styles within a vector graphics format.
- Shell Command Execution - Executes shell commands and captures the resulting terminal output to be rendered as an image.
- Pseudo-Terminal Commands - Executes shell commands within a simulated terminal environment to capture raw output for rendering.
- Terminal Session Capturing - Executes shell commands in a simulated terminal environment to capture raw text for visual rendering.
- Terminal Output Monitors - Execute a command within a pseudo-terminal and capture the output to render it as an image.
- Terminal Output Stylers - Enhances terminal output readability by applying colors, window frames, and shadows before rendering to images.
- Text-to-SVG Generators - Converts plain text and styled sequences into scalable vector graphics for high-resolution image export.
- ANSI-to-SVG Converters - Transforms terminal escape codes and colors into scalable vector graphics for high-resolution output.
- Terminal Output - Captures ANSI terminal output and converts it into a polished visual image.
- Operation Output Captures - Execute a specified command and capture the resulting text to render it as an image.
- Screenshot Image Renderers - Renders code blocks into styled image files with automatic language detection and line numbering.
- Syntax Highlighting - Assign colors and styles to code elements like keywords and strings to improve visual readability.
- Technical Documentation Styling - Ensures consistent visual formatting for code examples across projects using shared configuration profiles.
- CLI Image Processing Tools - Provides a command-line interface for batch processing and exporting styled code images.
- Interactive Parameter Interfaces - Provides a real-time interactive terminal interface to adjust visual parameters before final image generation.
- Configuration File Loading - Import predefined styling and layout settings from files to ensure consistent image generation.
- Configuration Profiles - Load specific visual presets or external files to ensure consistent styling across multiple image exports.
- Visual Style Profiles - Loads predefined setting files to apply consistent margins, fonts, and colors across different image exports.
- Developer Content Generation - Creates visual assets of code and terminal sessions specifically for technical sharing on social platforms.
- Visual Parameter Adjustments - Provides a real-time interactive terminal interface to modify visual settings before final image generation.
- Image Styling - Adjust visual properties like margins, padding, and shadows using flags, config files, or an interactive interface.
- Configuration-Based Styling - Loads predefined configuration files to apply consistent margins, fonts, and colors across different image exports.
- Font Embedding Utilities - Integrates custom typeface files into the rendering process to ensure consistent typography and ligature support.
- Surface Corner Radii - Configures the visual wrapper of images with adjustable corner radii and drop shadows.
- Typography Configurations - Set font family, size, and line height while embedding custom font files for specific text styles.
- Visual Style Customization - Customize the image appearance using borders, shadows, padding, margins, and window frames.
- Image Processing - Generate stylized images of code and terminal output.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
