ASCII 视频转换器

将视频转换为带抖动模式、彩色输出与帧率控制的 ASCII 动画。

关键词：ascii、video、animation、terminal、cli、art、python、open-source、agent、automation、MIT

属于 itsPremkumar Hermes / OpenClaw / Paperclip 代理工具栈的一部分 —— 共 31 个免费、MIT 许可、CI 测试通过的原生 agent 工具。

功能说明

在终端或 README 中直接分享视频，常规格式无法实现。ASCII 视频转换器解决了这一问题：将视频转换为支持抖动模式、彩色输出与帧率控制的 ASCII 动画。

最适合：创意开发者、终端艺术家，以及为文档/README 添加视觉效果的用户。

特性

• 将视频片段转为 ASCII 动画
• 控制输出宽度与帧率（fps）
• 选择抖动字符集（dithering charset）
• 启用彩色输出
• 提取单帧图像

安装

# 需要 Python 3.8+。无需 pip install。
curl -O https://raw.githubusercontent.com/itsPremkumar/ascii-video/main/ascii_video.py
# 或将该文件复制到任意位置 —— 它是自包含的。

快速上手

python ascii_video.py self-test     # 端到端验证是否正常工作
python ascii_video.py convert --help   # 查看 convert 子命令帮助
python ascii_video.py frame --help     # 查看 frame 子命令帮助
python ascii_video.py image --help     # 查看 image 子命令帮助

使用场景

1. 将视频片段转为 ASCII 动画
2. 控制输出宽度与帧率（fps）
3. 选择抖动字符集（dithering charset）
4. 启用彩色输出
5. 提取单帧图像

为何选择本工具而非其他方案

常见问题（SEO / AEO）

Q：支持哪些输入格式？
A：通过 convert 和 image 子命令支持常见视频/图像格式。

Q：支持彩色输出吗？
A：支持 — 使用 --color 模式即可。

Q：能否离线使用？
A：可以。

Q：提供自检功能吗？
A：提供 — 可端到端验证整个处理流程。

地域 / 本地覆盖范围

由 @itsPremkumar（印度金奈）开发与维护，面向全球开发者提供服务。
个人与团队均可免费使用。文档为英文；工具输出不依赖本地化设置（locale-neutral）。

CI 集成

# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Self-test ascii-video
        run: python ascii_video.py self-test

支持

免费 + MIT-0 许可（自由使用、可修改、无需署名）。如觉有用，欢迎赞助：

• GitHub Sponsors：https://github.com/sponsors/itsPremkumar
• Buy Me a Coffee：https://buymeacoffee.com/itsPremkumar

⭐ 在 GitHub 上点 Star