基于 pngquant 的最高质量 GIF 编码器。
gifski 利用 pngquant 的高级功能将视频帧转换为 GIF 动画,实现跨帧调色板和时间抖动。它可以生成每帧使用数千种颜色的 GIF 动画。
这是一个命令行工具,但也可以编译为 C 库以便在其他应用中无缝使用。
下载和安装
可执行文件请查看发布页面。
如果你安装了 Homebrew,也可以使用 brew install gifski
安装。
如果你安装了 Rust(来自 rustup)(1.63+版本),也可以通过源代码构建:cargo install gifski
。
使用方法
gifski 是一个命令行工具。如果你不熟悉终端操作,可以尝试 Windows 或 macOS 的图形界面版本。
从 ffmpeg 视频
提示:你可以将文件拖放到终端窗口,而不必手动输入文件路径!
如果你安装了 ffmpeg,可以通过添加 -f yuv4mpegpipe
参数将视频直接流式传输到 gifski 命令:
ffmpeg -i video.mp4 -f yuv4mpegpipe - | gifski -o anim.gif -
将上述代码中的 "video.mp4" 替换为你的实际视频路径。
注意命令末尾的 -
。这告诉 gifski
从标准输入读取数据。从磁盘读取 .y4m
文件也可以,但这些文件通常非常大。
如果视频分辨率过高,gifski
可能会自动缩小视频。如果你能接受较大的文件大小,可以使用 --width=1280
。
从 PNG 帧
也可以使用包含 PNG 帧的目录作为输入。你可以从任何动画软件导出这些帧。如果安装了 ffmpeg
,也可以用它导出帧:
ffmpeg -i video.webm frame%04d.png
然后从这些帧生成 GIF:
gifski -o anim.gif frame*.png
注意 *
是一个特殊的通配符,放在引号内("*"
)不起作用。
你还可以调整帧的大小(使用 -W <宽度(像素)>
选项)。如果输入曾经使用有损视频编解码器编码,建议至少将帧大小减半,以隐藏压缩伪影并抵消视频编解码器进行的色度抽样。
更多选项请查看 gifski --help
。
生成更小 GIF 文件的技巧
请注意,为了获得较小的文件大小,可能会损失大量质量。无论如何妥协,GIF 的压缩效果都不是很好。
- 使用
--width
和--height
缩小动画尺寸。这是最有效的方法。 - 添加
--quality=80
(或更低的数值)来降低整体质量。你可以通过以下参数微调质量:--lossy-quality=60
较低的值会使动画更加嘈杂/粗糙,但可以减小文件大小。--motion-quality=60
较低的值会导致运动帧出现模糊或条带,但可以减小文件大小。
如果你需要生成符合预定义文件大小的 GIF,你必须尝试不同的尺寸和质量设置。命令行工具会在压缩过程中显示估计的总文件大小,但请注意这个估计值并不十分精确。
构建
- 通过 rustup 安装 Rust。本项目仅支持最新版本的 Rust。如果编译器版本过旧,可能会出现关于"不稳定"特性的错误。运行
rustup update
更新。 - 克隆仓库:
git clone https://github.com/ImageOptim/gifski
- 在克隆的目录中运行:
cargo build --release
。这将在./target/release
中构建。
在 C 中使用
查看 gifski.h
了解 C API。要构建库,请运行:
rustup update
cargo build --release
并链接 target/release/libgifski.a
。请遵守 LICENSE。
面向包维护者的 C 动态库
构建过程使用 cargo-c
正确构建动态库并生成 pkg-config 文件。
rustup update
cargo install cargo-c
# 构建
cargo cbuild --prefix=/usr --release
# 安装
cargo cinstall --prefix=/usr --release --destdir=pkgroot
如果尚未完成构建,cinstall
命令会触发构建,因此可以省略 cbuild
命令。
许可证
AGPL 3 或更高版本。我可以提供其他许可选项,包括商业许可。如果你想在与此许可不兼容的产品中使用它,请联系我。
内置视频支持
该工具可选择直接支持视频解码,但不幸的是它依赖于 ffmpeg 6.x,这可能非常难以使用,因此默认不启用。
你必须安装 ffmpeg
和 libclang
,并且它们的 C 头文件必须安装在默认系统包含路径中。具体细节取决于平台和版本,但通常需要安装 libavformat-dev
、libavfilter-dev
、libavdevice-dev
、libclang-dev
、clang
等包。请注意,这些依赖项的安装可能相当困难。特别是在 macOS 和 Windows 上,仅仅安装它们就需要专业知识,否则可能会浪费几个小时在无休止的愚蠢安装和编译错误上,这些我无法帮助解决。如果你在交叉编译,请尝试取消注释 Cargo.toml
末尾的 [patch.crates-io]
部分,其中包含一些针对 ffmpeg 的实验性修复。
一旦安装了依赖项,使用 cargo build --release --features=video
或 cargo build --release --features=video-static
进行编译。
当编译时包含视频支持,需遵守 ffmpeg 许可证。你可能需要获得专利许可才能使用 H.264/H.265 视频(我建议使用 VP9/WebM 替代)。
gifski -o out.gif video.mp4
iOS 交叉编译
简单的方法是使用包含的 gifski.xcodeproj
文件自动为所有 Apple 平台构建库。将其作为子项目添加到你的 Xcode 项目中,并链接 gifski-staticlib
Xcode 目标。有关如何集成库的示例,请参阅 GUI 应用。
手动为 iOS 交叉编译
确保通过 rustup 安装了 Rust。运行一次:
rustup target add aarch64-apple-ios
然后构建库:
rustup update
cargo build --lib --release --target=aarch64-apple-ios
构建过程可能会打印 "dropping unsupported crate type cdylib
" 警告。这在为 iOS 构建时是正常的。
这将在 ./target/aarch64-apple-ios/release/libgifski.a
中创建一个静态库。你可以将这个库添加到你的 Xcode 项目中。有关如何在 Swift 中使用 libgifski 的示例,请参阅 gifski.app。