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