Freeze

生成代码和终端输出的图片。

示例

Freeze 可以生成代码和终端输出的 PNG、SVG 和 WebP 图片。

生成代码图片

freeze artichoke.hs -o artichoke.png

生成终端输出图片

你可以使用 freeze 的 --execute 标志来捕获终端命令的 ANSI 输出。

freeze --execute "eza -lah"

Freeze 还高度可定制，并提供交互式 TUI。

安装

# macOS 或 Linux
brew install charmbracelet/tap/freeze

# Arch Linux（顺便一提）
yay -S freeze

# Nix
nix-env -iA nixpkgs.charm-freeze

或者，下载：

提供 Debian 和 RPM 格式的安装包
为 Linux、macOS 和 Windows 提供二进制文件

或者，直接用 go 安装：

go install github.com/charmbracelet/freeze@latest

自定义

交互模式

Freeze 提供完全交互式模式，方便自定义。

freeze --interactive

设置保存在 $XDG_CONFIG/freeze/user.json，可以通过 freeze --config user 访问。

标志

可以通过 --flags 或配置文件自定义截图。

[!注意] 可以通过 freeze --help 查看所有 freeze 自定义选项。

-b，--background：应用背景填充。
-c，--config：基础配置文件或模板。
-l，--language：应用于代码的语言。
-m，--margin：为窗口添加边距。
-o，--output：.svg、.png、.jpg 的输出位置。
-p，--padding：为代码添加内边距。
-r，--border.radius：窗口的角落半径。
-t，--theme：用于语法高亮的主题。
-w，--window：显示窗口控件。
-H，--height：终端窗口的高度。
--border.width：边框宽度。
--border.color：边框颜色。
--shadow.blur：阴影高斯模糊。
--shadow.x：阴影 x 坐标偏移。
--shadow.y：阴影 y 坐标偏移。
--font.family：代码使用的字体系列。
--font.ligatures：在字体中使用连字。
--font.size：代码使用的字体大小。
--font.file：字体文件路径（嵌入 SVG）。
--line-height：相对于字体大小的行高。
--show-line-numbers：显示行号。
--lines：捕获的行（开始,结束）。

语言

如果可能，freeze 会从文件名或分析文件内容自动检测语言。可以使用 --language 标志覆盖这个推断。

cat artichoke.hs | freeze --language haskell

主题

更改颜色主题。

freeze artichoke.hs --theme dracula

输出

更改输出文件位置，默认为 out.svg 或管道输出时为 stdout。此值支持 .svg、.png、.webp。

freeze main.go --output out.svg
freeze main.go --output out.png
freeze main.go --output out.webp

# 或上述所有格式
freeze main.go --output out.{svg,png,webp}

字体

指定输出图像的字体系列、字体大小和字体行高。默认为 JetBrains Mono、14(px)、1.2(em)。

freeze artichoke.hs \
  --font.family "SF Mono" \
  --font.size 16 \
  --line-height 1.4

你还可以使用 --font.file 标志嵌入字体文件（TTF、WOFF 或 WOFF2 格式）。

要在字体中使用连字，可以应用 --font.ligatures 标志。

行号

使用 --show-line-numbers 标志在终端窗口中显示行号。

freeze artichoke.hs --show-line-numbers

要只捕获特定范围的行号，可以使用 --lines 标志。

freeze artichoke.hs --show-line-numbers --lines 2,3

边框圆角

为终端添加圆角。

freeze artichoke.hs --border.radius 8

窗口

为终端添加 macOS 风格的窗口控件。

freeze artichoke.hs --window

背景

设置终端窗口的背景颜色。

freeze artichoke.hs --background "#08163f"

高度

设置终端窗口的高度。

freeze artichoke.hs --height 400

边框宽度

为终端窗口添加边框轮廓。

freeze artichoke.hs --border.width 1 --border.color "#515151" --border.radius 8

内边距

为终端窗口添加内边距。你可以提供1、2或4个值。

freeze main.go --padding 20          # 所有边
freeze main.go --padding 20,40       # 垂直，水平
freeze main.go --padding 20,60,20,40 # 上，右，下，左

外边距

为终端窗口添加外边距。你可以提供1、2或4个值。

freeze main.go --margin 20          # 所有边
freeze main.go --margin 20,40       # 垂直，水平
freeze main.go --margin 20,60,20,40 # 上，右，下，左

阴影

在终端窗口下方添加阴影。

freeze artichoke.hs --shadow.blur 20 --shadow.x 0 --shadow.y 10

截图TUI

使用tmux capture-pane来生成TUI的截图。

在tmux中运行你的TUI，并将其调整到你想要捕获的状态。然后，使用capture-pane捕获窗格并将其通过管道传递给freeze。

hx # 在单独的窗格中
tmux capture-pane -pet 1 | freeze -c full

配置

Freeze还支持通过JSON文件进行配置，可以使用--config / -c标志传递。通常，所有的--flag选项都直接映射到配置文件中的键和值。

Freeze还内置了一些默认配置，可以通过名称传递。

base：简单的代码截图。
full：类似macOS的截图。
user：使用~/.config/freeze/user.json。

如果你使用--interactive模式，将会在~/.config/freeze/user.json创建一个配置文件。这将作为你截图的默认配置文件。

freeze -c base main.go
freeze -c full main.go
freeze -c user main.go # ~/.config/freeze/user.json的别名
freeze -c ./custom.json main.go

以下是一个示例配置：

{
  "window": false,
  "border": {
    "radius": 0,
    "width": 0,
    "color": "#515151"
  },
  "shadow": false,
  "padding": [20, 40, 20, 20],
  "margin": "0",
  "font": {
    "family": "JetBrains Mono",
    "size": 14
  },
  "line_height": 1.2
}