Java Desktop Image-to-ASCII Converter, Containerised

Apps & experiments · Creator, sole engineer · shipped

An image-to-ASCII converter where the engineering is in the responsiveness and the output quality.

Code: https://github.com/vasu-devs/PixelForge

The detail

Rendering runs multi-threaded in the background so the interface never blocks, and the quality slider is debounced so a single render fires when you stop dragging rather than dozens as you move.

Full-colour mode samples the original image's pixel colours and applies them per character, recreating the image through typography. Export triggers a separate high-resolution render pass at the source image's original dimensions - so a 4K input produces a 4K ASCII image rather than an upscaled screenshot of the preview.

The deployment side was the harder problem: packaging a desktop GUI application into a container with a multi-stage build so it can run from a browser tab.

Java 17, JavaFX, Maven, Docker, Docker Compose.

What I did

  • Built a multi-threaded rendering engine so the interface never blocks during conversion
  • Implemented slider debouncing so one render fires when the user stops dragging rather than per pixel of movement
  • Built a full-colour mode sampling original pixel colours per character
  • Added a dedicated high-resolution export pass at the source image's original dimensions
  • Containerised a desktop GUI application with a multi-stage build so it runs from a browser tab

Stack

Java, JavaFX, Maven, Docker, Multithreading, Image Processing, CI/CD

Case study: https://www.siddhvasudev.com/projects/java-desktop-image-to-ascii-converter