TermCap

TermCap 是一个 Python 终端录制与渲染工具：把 PTY 会话保存为 asciicast v2，并输出 SVG 动画、静态 SVG 帧或 GIF。

核心能力

交互 shell 与单命令 PTY 录制
exec wrapper：运行原命令时自动保存 CAST，并可直接渲染 SVG/GIF
ChatEnv profile 可管理默认执行环境，自动 source ChatArch 入口脚本
兼容 asciinema 的 .cast 格式
ANSI 颜色、光标、文本样式和宽字符渲染
模板化 SVG 动画与 16 套内置主题
CAST→SVG、CAST→GIF、SVG→GIF
关键帧确定性采样和 Chrome viewport 自动校正

安装

TermCap 支持 Linux、macOS 和 BSD，需要 Python 3.10 或更高版本。GIF 导出需要 Google Chrome。

python -m pip install termcap
termcap --version

最短工作流

termcap record demo.cast -g 80x20
termcap render demo.cast demo.svg
termcap render demo.cast demo.gif --format gif

录制单条命令：

termcap record tests.cast -g 100x24 -c "python -m pytest -q"

像命令 wrapper 一样执行并录制，同时渲染 SVG：

termcap exec -g 96x16 --media-output hello.svg -- python3 -c 'print("hello")'

配置默认执行环境入口：

mkdir -p ~/.chatarch/config/termcap/exec-env.d
printf 'source ~/.nvm/nvm.sh\n' > ~/.chatarch/config/termcap/exec-env.sh
chatenv set TERMCAP_EXEC_ENV_SCRIPTS='~/.chatarch/config/termcap/exec-env.sh'

已有 SVG 转 GIF：

termcap svg2gif demo.svg demo.gif --speed 1 --loop 0

文档开发

python -m pip install -e '.[dev,docs]'
mkdocs serve
mkdocs build --strict

许可证

MIT License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

termcap-0.2.4.tar.gz (149.7 kB view details)

Uploaded Aug 20, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

termcap-0.2.4-py3-none-any.whl (155.3 kB view details)

Uploaded Aug 20, 2026 Python 3

File details

Details for the file termcap-0.2.4.tar.gz.

File metadata

Download URL: termcap-0.2.4.tar.gz
Upload date: Aug 20, 2026
Size: 149.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for termcap-0.2.4.tar.gz
Algorithm	Hash digest
SHA256	`8010d5ec96a3120c5dcdba2eeb1e992985f99cdabb9c94800c9d04daa3b2ed4b`
MD5	`62d5011537ac154132dad0d084d81378`
BLAKE2b-256	`a586637017190767d196587e38505ad864cc85d520872e93787535ffbbc24c4c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for termcap-0.2.4.tar.gz:

Publisher: publish.yml on ChatArch/TermCap

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: termcap-0.2.4.tar.gz
- Subject digest: 8010d5ec96a3120c5dcdba2eeb1e992985f99cdabb9c94800c9d04daa3b2ed4b
- Sigstore transparency entry: 2536326658
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: ChatArch/TermCap@3206ed6a57e99c5558a86d21f616b670f636118c
- Branch / Tag: refs/tags/v0.2.4
- Owner: https://github.com/ChatArch
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@3206ed6a57e99c5558a86d21f616b670f636118c
- Trigger Event: push