This Python script applies the Atkinson dithering algorithm to images, converting them to a stylized 1-bit grayscale format. The output is available in PNG and optionally in SVG formats.

• Atkinson Dithering: Applies the Atkinson dithering algorithm for a classic dithered look.
• Output Formats: Generates PNG files, with an option to also generate SVG files.
• Configurable Width: Allows setting a custom width for the output image.
• Output Directory: Specify a directory for output files.
• Optional SVG Output: Control whether to generate SVG files alongside PNG files.

To run this script, you need Python installed on your system along with the following libraries:

• PIL (Pillow)
• Numpy
• svgwrite (only if SVG output is enabled)
• tqdm

You can install these dependencies using:

pip install pillow numpy svgwrite tqdm

1. Set Parameters:

   • Edit the set_input_file, set_width, set_output_directory, and set_svg_export variables at the top of the script as per your requirements.

2. Run the Script:

   • Execute the Python script. Output files (PNG and optionally SVG) will be generated in the specified output directory.

• PNG File: Stored in the specified output directory with the format originalfilename_dither_width.png.
• SVG File (if enabled): Stored in the same directory with the format originalfilename_dither_width.svg.

The suffix _dither_width in the filenames represents the width setting used during dithering.

Given an input file foobar.jpg, a width setting of 512, and output directory output, with SVG export enabled, the output files will be named output/foobar_dither_512.png and output/foobar_dither_512.svg.

• The script is optimized for 1-bit grayscale images. For best results, use images with a clear contrast.
• SVG output is optimized for smaller sizes and may not be suitable for very large images.
• Ensure the output directory exists or modify the script to create it if necessary.

Feel free to fork this repository, make changes, and submit pull requests. For major changes, please open an issue first to discuss what you would like to change.

This project is open source and available under the ISC License.

Happy Dithering! 🌈👨‍🎨 🖤 izzy