<img width="100%" src="https://yellow-cdn.veclightyear.com/835a84d5/92bf219a-bd80-4652-bc43-d067e46f1fd9.svg" alt="gif.ski">

基于 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，你必须尝试不同的尺寸和质量设置。命令行工具会在压缩过程中显示估计的总文件大小，但请注意这个估计值并不十分精确。

构建

1. 通过 rustup 安装 Rust。本项目仅支持最新版本的 Rust。如果编译器版本过旧，可能会出现关于"不稳定"特性的错误。运行 rustup update 更新。
2. 克隆仓库：git clone https://github.com/ImageOptim/gifski
3. 在克隆的目录中运行：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。