{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/557", "result": {"data":{"issuesJson":{"id":"aadcdd1a-ee2e-5b8e-a8cb-7ada9ec524b8","title":"homeport/termshot: 根据终端命令输出创建屏幕截图","number":557,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposhomeport/termshot
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

termshot

\n

\"License\"
\n\"Go
\n\"Tests\"
\n\"Codecov\"
\n\"Go
\n\"Release\"

\n

Generate beautiful screenshots of your terminal, from your terminal.

\n
termshot --show-cmd -- lolcat -f <(figlet -f big foobar)
\n

This command generates this screenshot:

\n

\"example\"

\n

Installation

\n

To install with Homebrew on macOS or Linux:

\n
brew install homeport/tap/termshot
\n

See Releases for pre-compiled binaries for Darwin and Linux.

\n

Usage

\n

This tool reads the console output and renders an output image that resembles a user interface window. It's inspired by some other web-based tools like carbon.now.sh, and codekeep.io/screenshot. Unlike those tools, termshot does not blindly apply syntax highlighting to some provided text; instead it reads the ANSI escape codes (\"rich text\") logged by most command-line tools and uses it to generate a high-fidelity \"screenshot\" of your terminal output.

\n

Like time, watch, or perf, just prefix the command you want to screenshot with termshot -- .

\n
termshot -- ls -a
\n

This will generate an image file called out.png in the current directory.

\n

\"basic

\n

In some cases, if your target command contains pipes—there may still be ambiguity, even with --. In these cases, wrap your command in double quotes.

\n
termshot -- \"ls -l | grep go\"
\n

\"termshot

\n

Flags to control the look

\n

--show-cmd/-c

\n

Include the target command in the screenshot.

\n
termshot --show-cmd -- \"ls -a\"
\n

\"termshot

\n

--columns/-C

\n

Enforce that screenshot is wrapped after the provided number of columns. Use this flag to make sure that the screenshot does not exceed a certain horizontal length.

\n

--no-decoration

\n

Do not draw window decorations (minimize, maximize, and close button).

\n

--no-shadow

\n

Do not draw window shadow.

\n

Flags for output related settings

\n

--clipboard/-b (only on selected platforms)

\n

Do not create an output file with the screenshot, but save the screenshot image into the operating system clipboard.

\n

Note: Only available on some platforms. Check termshot help to see if flag is available.

\n

--filename/-f

\n

Specify a path where the screenshot should be generated. This can be an absolute path or a relative path; relative paths will be resolved relative to the current working directory.

\n
termshot -- \"ls -a\" # defaults to <cwd>/out.png\ntermshot --filename my-image.png -- \"ls -a\"\ntermshot --filename screenshots/my-image.png -- \"ls -a\"\ntermshot --filename /Desktop/my-image.png -- \"ls -a\"
\n

Defaults to out.png.

\n

Flags to control content

\n

--edit/-e

\n

Edit the output before generating the screenshot. This will open the rich text output in the editor configured in $EDITOR, using vi as a fallback. Use this flag to remove unwanted or sensitive output.

\n
termshot --edit -- \"ls -a\"
\n

Miscellaneous flags

\n

--raw-write <file>

\n

Write command output as-is into the file that is specified as the flag argument. No screenshot is being created. The command-line flag --filename has no effect, when --raw-write is used.

\n

--raw-read <file>

\n

Read input from provided file instead of running a command. If this flag is being used, no pseudo terminal is being created to execute a command. The command-line flags --show-cmd, and --edit have no effect, when --raw-read is used.

\n

--version/-v

\n

Print the version of termshot installed.

\n
$ termshot --version\ntermshot version 0.2.5
\n

\"out\"

\n

Multiple commands

\n

In order to work, termshot uses a pseudo terminal for the command to be executed. For advanced use cases, you can invoke a fully interactive shell, run several commands, and capture the entire output. The screenshot will be created once you terminate the shell.

\n
termshot /bin/zsh
\n
\n

Please note: This project is work in progress. Although a lot of the ANSI sequences can be parsed, there are definitely commands in existence that create output that cannot be parsed correctly, yet. Also, commands that reset the cursor position are known to create issues.

\n
","updatedAt":"2025-05-22T01:50:33Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"命令行工具","color":"e05879"}},{"node":{"name":"homeport","color":"2e7af2"}}]},"comments":{"edges":[]}}},"pageContext":{"number":557,"previous":{"title":"TermoraDev/termora: 一个终端模拟器和 SSH 客户端，支持 Windows，macOS 和 Linux。","number":556},"next":{"title":"kbst/terraform-kubestack: Kubestack 是一个面向 Kubernetes 平台工程团队的框架，它允许在一个 Terraform 代码库中定义完整的云原生技术栈，并通过 GitOps 实现平台的安全持续发展。","number":558}}}, "staticQueryHashes": ["151096407","2861350382"]}