napi-gif-encoder

A faster GIF Encoder for Node JS using Rust

This library is a fork of @tyrone-sudeium/napi-gif-encoder.
I made this fork because the original is not currently being maintained, and I needed a new feature added.

Install

npm install @gomander/napi-gif-encoder

Support matrix

Operating Systems

Linux x64/aarch64	Windows x64
✓	✓

NodeJS

Theoretically, any version of Node that supports N-API should work. The CI is validated against LTS versions of Node:

Node 18	Node 20	Node 22
✓	✓	✓

Building

If you are using this as a dependency, since we use N-API, you don't need to build anything! However, if you want to tinker with this code or submit a PR, read below.

Developing

• Install latest Rust using rustup. If on Windows, use WSL for an easier time.
• Install NodeJS@18+. LTS versions suggested.
• Install [email protected].
• Install dependencies with yarn.

You can then compile the rust code with yarn build.

After running yarn build, you will see a napi-gif-encoder.<PLATFORM>.node file in the project root. This is the native addon built from lib.rs.

Try out using sample project

• yarn
• yarn build
• cd sample
• yarn
• node .

You'll then see output.gif, which was encoded using the rust encoder.

You can compare this to a Node-based GIF encoder by running node . --js.

Performance

This data is a ten-run average of the time it took to encode the sample project on a Ryzen 7 7800X3D.
Historical data from the original author also suggests that this library scales better with more cores than Node-based GIF encoders.

Encoder	Time
gif-encoder-2	692ms
@gomander/napi-gif-encoder	250ms