我开源了一个屏幕录 GIF 工具:框选任意区域直接出图,只有 2 个依赖(Python)

RectGif是一款开源的Python屏幕录制GIF工具,支持框选任意区域直接生成GIF,仅依赖mss和Pillow两个库。其核心特性包括逐帧延迟写入以保障播放流畅、全局自适应调色板提升颜色一致性并减小体积、全平台兼容及自产自销演示GIF。工程上规避了GIF最小帧延迟(20ms)和GitHub空仓库API限制等关键问题。

我开源了一个屏幕录 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 化,不需要真屏幕
CIGitHub Actions 矩阵:3.9 / 3.11 / 3.13 × Ubuntu / Windows
Lintruff,全绿
发布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 全流程。

和同类工具对比

RectGifGifCamScreenToGif
开源✅ MIT❌✅
CLI 脚本化✅❌部分
依赖体积2 个纯 Python 库单 exe.NET/WPF
JSON 元数据✅❌❌
跨平台✅WindowsWindows

结语

仓库直达:[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]

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址