50 releases (11 stable)
|2.1.2||Aug 12, 2018|
|2.0.2||Jul 28, 2018|
|1.0.4||May 2, 2018|
|1.0.2||Mar 5, 2018|
|0.2.2||Mar 21, 2016|
#23 in Compression
682 downloads per month
Oxipng is a multithreaded lossless PNG compression optimizer. It can be used via a command-line interface or as a library in other Rust programs.
Oxipng can be downloaded from the Releases link on the GitHub page.
Oxipng can also be installed from Cargo, via the following command:
cargo install oxipng
Alternatively, oxipng can be built from source using the latest stable or nightly Rust:
git clone https://github.com/shssoichiro/oxipng.git cd oxipng cargo build --release cp target/release/oxipng /usr/local/bin
The current minimum supported Rust version is 1.27.0. Oxipng may compile on earlier versions of Rust, but there is no guarantee.
Oxipng follows Semantic Versioning.
Oxipng is a command-line utility. Basic usage looks similar to the following:
oxipng -o 4 -i 1 --strip safe *.png
The most commonly used options are as follows:
-o 6, lower is faster, higher is better compression. The default (
-o 2) is sufficiently fast on a modern CPU and provides 30-50% compression gains over an unoptimized PNG.
-o 4is 6 times slower than
-o 2but can provide 5-10% extra compression over
-o 2. Using any setting higher than
-o 4is unlikely to give any extra compression gains and is not recommended.
-i 1will enable Adam7 PNG interlacing on any images that are processed.
-i 0will remove interlacing from all processed images. Not specifying either will keep the same interlacing state as the input image. Note: Interlacing can add 25-50% to the size of an optimized image. Only use it if you believe the benefits outweight the costs for your use case.
- Strip: Used to remove metadata info from processed images. Used via
--strip [safe,all]. Can save a few kilobytes if you don't need the metadata. "Safe" removes only metadata that will never affect rendering of the image. "All" removes all metadata that is not critical to the image. You can also pass a comma-separated list of specific metadata chunks to remove.
-scan be used as a shorthand for
More advanced options can be found by running
Although originally intended to be used as an executable, oxipng can also be used as a library in
other Rust projects. To do so, simply add oxipng as a dependency in your Cargo.toml,
extern crate oxipng in your project. You should then have access to all of the library
functions documented here. The simplest
method of usage involves creating an
Options struct and
passing it, along with an input filename, into the
Oxipng began as a complete rewrite of the OptiPNG project, which was assumed to be dead as no commit had been made to it since March 2014. (OptiPNG has since released a new version, after Oxipng was first released.) The name has been changed to avoid confusion and potential legal issues.
The core goal of rewriting OptiPNG was to implement multithreading, which would be very difficult to do within the existing C codebase of OptiPNG. This also served as an opportunity to choose a more modern, safer language (Rust).
Any contributions are welcome and will be accepted via pull request on GitHub. Bug reports can be filed via GitHub issues. Please include as many details as possible. If you have the capability to submit a fix with the bug report, it is preferred that you do so via pull request, however you do not need to be a Rust developer to contribute. Other contributions (such as improving documentation or translations) are also welcome via GitHub.
Oxipng is open-source software, distributed under the MIT license.
Tested oxipng 2.1.4 (compiled on rustc 1.29.1 (b801ae664 2018-09-20)) against OptiPNG version 0.7.7 on Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz with 8 logical cores
Benchmark #1: ./target/release/oxipng -P ./tests/files/rgb_16_should_be_grayscale_8.png
Time (mean ± σ): 76.1 ms ± 2.2 ms [User: 165.1 ms, System: 26.9 ms]
Range (min … max): 71.1 ms … 80.4 ms
Benchmark #2: optipng -simulate ./tests/files/rgb_16_should_be_grayscale_8.png
Time (mean ± σ): 274.9 ms ± 2.3 ms [User: 272.8 ms, System: 2.0 ms]
Range (min … max): 271.8 ms … 278.1 ms
'./target/release/oxipng -P ./tests/files/rgb_16_should_be_grayscale_8.png' ran 3.61x faster than 'optipng -simulate ./tests/files/rgb_16_should_be_grayscale_8.png' Benchmark #1: ./target/release/oxipng -o4 -P ./tests/files/rgb_16_should_be_grayscale_8.png
Time (mean ± σ): 103.1 ms ± 3.1 ms [User: 444.9 ms, System: 25.2 ms]
Range (min … max): 98.6 ms … 111.4 ms
Benchmark #2: optipng -o 4 -simulate ./tests/files/rgb_16_should_be_grayscale_8.png
Time (mean ± σ): 931.3 ms ± 8.7 ms [User: 929.6 ms, System: 1.1 ms]
Range (min … max): 920.4 ms … 943.3 ms
'./target/release/oxipng -o4 -P ./tests/files/rgb_16_should_be_grayscale_8.png' ran 9.03x faster than 'optipng -o 4 -simulate ./tests/files/rgb_16_should_be_grayscale_8.png'