我开源了一个屏幕录 GIF 工具:框选任意区域直接出图,只有 2 个依赖(Python)
写技术博客的都知道一个真理:**演示 GIF 是文章的命**。我自己发的前几篇文章里,GIF 全是用闭源小工具录的——要么全家桶安装包 200MB,要么免费版水印糊脸,要么只能在 Windows 用。
一气之下,我用纯 Python 写了 **RectGif**:框选屏幕任意矩形,直接录成 GIF,两个依赖,全平台。
**GitHub(点击直达):**[github.com/yund229/RectGif](https://github.com/yund229/RectGif)
本文所有技术点都能在上面的仓库找到源码,全 MIT 协议,执 exe 免装 Python 版在 Release 里。
30 秒上手
pip install git+https://github.com/yund229/RectGif.git
# 交互式:全屏十字准星,按住左键拖个框,松手就录
rectgif --select -o demo.gif
# 精确坐标:录 5 秒
rectgif --rect 100,80,800,600 --duration 5 -o demo.gif
# 高帧率 + 限宽 600px(发博客/群聊刚刚好)
rectgif --rect 0,0,1280,720 --fps 24 --max-width 600 -o out.gif
# 先预览一帧确认没选歪,再正式录
rectgif --rect 100,80,800,600 --preview
录完终端直接报账:
12 frames @ 12fps -> demo.gif (342.1 KiB, 1.2s)
同时在旁边生成一个 out.json,区域、帧数、耗时、文件大小全在里面——给脚本和流水线用的,别的录屏工具可没这个。
四个值得说的设计细节
1. GIF 卡顿了,播放不会卡——逐帧时长写入
屏幕抓帧不是匀速的:窗口多了某帧可能抓 200ms,下一帧只要 30ms。naive 做法是按平均帧率排播,结果就是画面忽快忽慢。
RectGif 把每帧的真实间隔写成 GIF 的 per-frame delay,抓帧抖动**只影响录制节奏,不影响播放节奏**。GIF 格式本来就支持逐帧延迟,只是大多数工具没这么用。
2. 全局自适应调色板:颜色一致还省体积
每帧独立量化 256 色,相邻帧的调色板不一致,播放时会看到颜色"跳变"。RectGif 从整段序列里采样最多 9 帧拼成一张图,用中位数切分算法生成**一个共享调色板**,所有帧都对着它量化 + Floyd-Steinberg 抖动:
- 相邻帧颜色不再跳变
- 调色板只存一份,文件更小
--colors 64还能压档位,适合纯文字演示
3. 只有 mss + Pillow 两个依赖
录屏工具的技术选型里,opencv-python 带 60MB 的 DLL,PyQt 全家桶 200MB,而 RectGif 全部原生能力只靠:
- **mss**:跨平台快速截屏,纯 Python 绑定
- **Pillow**:GIF 编码 + 图像处理
装完 pip list 干干净净,PyInstaller 打包出来 exe 也只有 15MB 左右。
4. 演示 GIF 是它自己编码的(自产自销)
README 里那个演示动画,是 assets/make_gif.py 用 PIL 合成 24 帧画面,再交给 RectGif 自己的 encoder 编码的。一个工具能不能打,先用它给自己干一遍活。
工程化清单
老规矩,新项目的"金含量配置"一样不少:
| 项 | 配置 |
| 单元测试 | 64 个,抓帧/编码/CLI 全部 mock 化,不需要真屏幕 |
| CI | GitHub Actions 矩阵:3.9 / 3.11 / 3.13 × Ubuntu / Windows |
| Lint | ruff,全绿 |
| 发布 | tag v1.0.0 自动 PyInstaller 打包 exe 传 Release |
| 文档 | 中英双语 README,互链跳转 |
分享两个这次踩的坑:
**坑一:GIF 的最小帧延迟约 20ms。** 也就是说 GIF 理论上最高约 50fps,超过这个值高帧率毫无意义,--fps 超过 50 的部分会被铳制。
**坑二:空仓库不能直接用 Git Data API 传 blob。** GitHub 的 blobs 接口在仓库任何没有 commit 时返回 409,需要先用 Contents API 推一个文件初始化,再走 blobs→tree→commit 全流程。
和同类工具对比
| RectGif | GifCam | ScreenToGif | |
| 开源 | ✅ MIT | ❌ | ✅ |
| CLI 脚本化 | ✅ | ❌ | 部分 |
| 依赖体积 | 2 个纯 Python 库 | 单 exe | .NET/WPF |
| JSON 元数据 | ✅ | ❌ | ❌ |
| 跨平台 | ✅ | Windows | Windows |
结语
仓库直达:[github.com/yund229/RectGif](https://github.com/yund229/RectGif) · exe 在 [Releases](https://github.com/yund229/RectGif/releases)
这是我开源的第四个小工具,前面三个:
- [Windows 截图取字工具 SnapOCR:全局热键 + 离线 OCR](https://github.com/yund229/SnapOCR) ([配套文章](https://blog.csdn.net/w_2345678/article/details/170815864))
- 下载文件夹自动整理器 DirTidy:预览 + 一键撤销](https://github.com/yund229/DirTidy) ([配套文章](https://blog.csdn.net/w_2345678/article/details/170816591))
觉得有用的话给个 Star ⭐,下一个项目选题在愣了,欢迎评论区点菜。
[Click the image button to upload demo.gif]
RectGif是一款开源的Python屏幕录制GIF工具,支持框选任意区域直接生成GIF,仅依赖mss和Pillow两个库。其核心特性包括逐帧延迟写入以保障播放流畅、全局自适应调色板提升颜色一致性并减小体积、全平台兼容及自产自销演示GIF。工程上规避了GIF最小帧延迟(20ms)和GitHub空仓库API限制等关键问题。
7817

被折叠的 条评论
为什么被折叠?



