Dither me like one of your French girls.

Ditheridoo is a multicolor bitmap editor for Commodore 64. It runs on Linux, MacOS, Windows and other systems supported by Python.

For a list of quick keyboard shortcuts and other information see file cheatsheet.md or the full documentation in /doc.

Ditheridoo v1.1.0 [build 251229-234134] *** by WolF
usage: ditheridoo.py [-h] [-i IMAGE_FILENAME]

Ditheridoo is a multicolor bitmap editor for Commodore 64.

options:
  -h, --help            show this help message and exit
  -i, --image IMAGE_FILENAME
						koala image filename

Example: ./ditheridoo.py -i image.koa

The multicolor bitmap is stored in the widely-spread KoalaPainter (C64) format:

• 2 bytes load address
• 8000 bytes raw bitmap data
• 1000 bytes raw "Video Matrix" (screen) data
• 1000 bytes raw "Color RAM" data
• 1 byte background data

• fieserWolF/Abyss-Connection - code, graphics - https://github.com/fieserWolF https://csdb.dk/scener/?id=3623
• The Mysterious Art/Abyss-Connection - graphics - https://csdb.dk/scener/?id=3501
• Pararaum/The 7th Division - example image - https://csdb.dk/scener/?id=31223
• Mirage/Booze Design - example image - https://csdb.dk/scener/?id=739

Ditheridoo comes in two flavors:

• standalone executable for 64-bit systems Linux and Windows (see releases)
• Python3 script

Just download your bundle at releases, extract the zip file and enjoy.

Python3 is needed to run PetPet. Everything else needed should be provided in your Python3 installation by default:

• tkinter
• argparse

• Download Python from https://www.python.org.
• Install Python on your computer.

On my Debian GNU/Linux machine I use apt to install everything needed:

apt update
apt install python3 python3-tk

Alternatively, you can use pip to install missing modules:

pip3 install argparse

• Go to https://github.com/fieserWolF/ditheridoo.
• Click on the green "Code" button and "Download ZIP".
• Extract the downloaded ZIP-file to any folder.

• implement sanity check: accept only standard koala format files
• implement real undo for all functions
• implement hires drawing mode
• implement different pencil sizes
• maybe: preview window: indicate current view with a visible frame
• maybe: preview window: move visible frame by dragging the mouse
• maybe: "draw mode: select": avoid moving of the controls

Any help and support in any form is highly appreciated.

If you have a feature request, a bug report or if you want to offer help, please, contact me:

http://csdb.dk/scener/?id=3623 or [email protected]

(next release candidate)

• preview window zoom: more options, zoom with mouse wheel in preview window
• responsive GUI, removed fixed editor dimensions from preferences window
• removed extra color selector when choosing draw mode "select", can be selected with radiobuttons next to the colors now
• toggle grid
• safety questions when quitting and creating new image
• bug fixes

• great speed improvement
• no Pillow libraries used any more
• added: PPM image export
• bug fixes

• mostly rewritten code, split up into segments
• commandline options
• bug fixes

• initial release

Ditheridoo multicolor bitmap editor for Commodore 64.

Copyright (C) 2026 fieserWolF / Abyss-Connection

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

See the LICENSE file for details.

For further questions, please contact me at http://csdb.dk/scener/?id=3623 or [email protected]

For Python3 and Tcl/Tk licenses see file LICENSE_OTHERS.