Skip to content

ralenjor/dmg_image_convert

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

Game Boy Sprite Converter

A Python tool for converting standard image files (JPG, PNG, GIF, BMP, etc.) into Game Boy–compatible graphics.
This script converts an image into the Game Boy 4-shade palette, slices it into 8×8 tiles, generates a Game Boy–accurate preview image, and outputs ROM-ready 2bpp tile binary.


Features

  • Converts any common image format to the 4-color Game Boy palette
  • Slices the image into 8×8 tiles and encodes them in Nintendo 2bpp format (16 bytes per tile)
  • Produces a preview PNG showing how the image will look on a DMG Game Boy
  • Outputs a raw .bin file containing tile data ready for INCBIN or other toolchains
  • Works for sprites, tilesets, UI art, backgrounds, and logos

Requirements

Install the dependency:

pip install pillow

---

## Usage

Run the script:

python3 convertimage.py input_image.jpg output_sprite.bin preview.png

About

This script will convert common image formats to 4-color Game Boy palette

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages