https://github.com/mcraiha/dithery-cli
Command-line image dithering tool written in C#
https://github.com/mcraiha/dithery-cli
dithered-images dithering dotnet-tool
Last synced: about 1 year ago
JSON representation
Command-line image dithering tool written in C#
- Host: GitHub
- URL: https://github.com/mcraiha/dithery-cli
- Owner: mcraiha
- License: unlicense
- Created: 2020-08-05T11:29:29.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-19T18:17:40.000Z (about 2 years ago)
- Last Synced: 2025-02-10T15:17:16.006Z (over 1 year ago)
- Topics: dithered-images, dithering, dotnet-tool
- Language: C#
- Homepage:
- Size: 84 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGE-LOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Dithery-cli
Command-line [image dithering](https://en.wikipedia.org/wiki/Dither#Digital_photography_and_image_processing) tool written in C#. Dithering part is done with [CSharp-Dithering](https://github.com/mcraiha/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](https://github.com/mcraiha/Dithery-cli/releases) page
## How to build
`dotnet build`
## How to package
`dotnet pack`
## Linux issues
## Input files
In theory SkiaSharp [should support](https://learn.microsoft.com/en-us/dotnet/api/skiasharp.skencodedimageformat?view=skiasharp-2.88) 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](https://github.com/mcraiha/Dithery-cli/blob/master/LICENSE) file.
License for [SkiaSharp](https://github.com/mono/SkiaSharp) is [MIT](https://github.com/mono/SkiaSharp/blob/main/LICENSE.md).