Repolode
homeport

homeport/termshot

一个命令行工具,运行终端命令并把带颜色的 ANSI 输出渲染成窗口风格的 PNG 截图。

Star
976
Fork
42
未关闭 Issue
37
最近提交
上个月

这是什么?

termshot 在伪终端中运行命令,捕获包括 ANSI 颜色和格式码在内的输出,并渲染成类似终端窗口的图片。它不是对粘贴文本做语法高亮,而是直接解析命令自身输出的转义码,因此 ls、figlet、lolcat 等工具的原始配色都能保留。

使用方式很简单:在任意命令前加上 termshot,默认生成 out.png。参数可以调整外观(窗口装饰、阴影、外边距、内边距、按列数换行、是否显示命令),设置输出(文件路径,或在支持的平台上写入系统剪贴板),也可以在 $EDITOR 中编辑捕获的内容以删除敏感信息。它还能运行完整的交互式 shell,并在退出时生成整个会话的截图。

项目仍在开发中。许多 ANSI 序列已可解析,但部分输出以及会重置光标位置的命令可能无法正确渲染。

核心功能

  • 01直接渲染真实的 ANSI 颜色和格式码,而非套用语法高亮。
  • 02生成终端风格窗口,可选择装饰、阴影、外边距和内边距。
  • 03生成图片前可在 $EDITOR 中编辑捕获的输出。
  • 04支持对完整的交互式 shell 会话截图。
  • 05可通过 Homebrew 安装,也提供 macOS 和 Linux 预编译二进制。

适用场景

  • 为博客文章、技术文档或发布说明制作命令行输出截图。
  • 分享命令输出到社交媒体或聊天工具前,先删除敏感内容。
  • 展示 figlet、lolcat 等彩色命令行工具的原始样式。

快速上手

  1. 1

    在 macOS 或 Linux 上通过 Homebrew 安装

    brew install homeport/tap/termshot
  2. 2

    在任意命令前加上 termshot 即可生成 out.png

    termshot ls -a

使用前须知

  • README 称该项目仍在开发中,部分 ANSI 转义序列或会重置光标的命令可能无法正确渲染。

标签

常见问题

termshot 是什么?
一个命令行工具,运行终端命令并把带颜色的 ANSI 输出渲染成窗口风格的 PNG 截图。 termshot 在伪终端中运行命令,捕获包括 ANSI 颜色和格式码在内的输出,并渲染成类似终端窗口的图片。它不是对粘贴文本做语法高亮,而是直接解析命令自身输出的转义码,因此 ls、figlet、lolcat 等工具的原始配色都能保留。
termshot 可以免费使用吗?用的什么许可证?
termshot 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
termshot 还在维护吗?
半年内有更新。termshot 最近一次提交是在 2026年9月15日。
termshot 适合用来做什么?
为博客文章、技术文档或发布说明制作命令行输出截图。 分享命令输出到社交媒体或聊天工具前,先删除敏感内容。 展示 figlet、lolcat 等彩色命令行工具的原始样式。
termshot 怎么安装和运行?
在 macOS 或 Linux 上通过 Homebrew 安装: brew install homeport/tap/termshot 在任意命令前加上 termshot 即可生成 out.png: termshot ls -a
在哪里获取 termshot?
源代码和安装说明在 GitHub 上:https://github.com/homeport/termshot

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目