Home

Awesome

Dithery-cli

Command-line image dithering tool written in C#. Dithering part is done with CSharp-Dithering

Build status

Print help

dotnet run -- --help

Sample commands

Save single Atkinson dithered image, with true colors to web safe color reduction to PNG file
dotnet run -- half.png -m atkinson -c TrueColorToWebSafe -f SingleImage -o dither.png
or
dithery half.png -m atkinson -c TrueColorToWebSafe -f SingleImage -o dither.png

Save single Stucki dithered image, with true colors to web safe color reduction to HTML file (includes both original and dithered images in one HTML file)
dotnet run -- half.png -m stucki -c TrueColorToWebSafe -f HTMLBasic -o dither.html
or
dithery half.png -m stucki -c TrueColorToWebSafe -f HTMLBasic -o dither.html

Save all ditherings to HTML file, with true colors to web safe color reduction for PNG file
dotnet run -- half.png -m All -c TrueColorToWebSafe -f HTMLBasic -o dither.html
or
dithery half.png -m All -c TrueColorToWebSafe -f HTMLBasic -o dither.html

Save all ditherings to separate .png files, with true colors to web safe color reduction for PNG file
dotnet run -- half.png -m all -c TrueColorToWebSafe -f SingleImage -o dither.png
or
dithery half.png -m all -c TrueColorToWebSafe -f SingleImage -o dither.png

How to install

Easiest option is to use dotnet global install
dotnet tool install -g Dithery-cli
and after that you can run Dithery-cli from any location with dithery

You can also download Windows release (an .exe file) and Linux release from Releases page

How to build

dotnet build

How to package

dotnet pack

Linux issues

Input files

In theory SkiaSharp should support e.g. BMP, GIF, JPG, PNG and Webp file formats. I have only tested it with PNG and JPG files.

Output files

Output can be either PNG file(s) or HTML file with embedded PNG images.

License

Text in this document and source code files are released into the public domain. See LICENSE file.
License for SkiaSharp is MIT.