{"id":20647155,"url":"https://github.com/bbbbbr/gimp-rom-bin","last_synced_at":"2025-10-03T19:24:21.312Z","repository":{"id":83821405,"uuid":"132937083","full_name":"bbbbbr/gimp-rom-bin","owner":"bbbbbr","description":"GIMP plug-in to read/write SNES / NES / GB / GBA / NGP / MD / etc ROM image, tile and sprite files","archived":false,"fork":false,"pushed_at":"2024-11-18T10:35:08.000Z","size":387,"stargazers_count":87,"open_issues_count":1,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-31T12:09:36.160Z","etag":null,"topics":["game-boy","game-boy-advance","genesis","gimp","gimp-plugin","graphics","megadrive","nes","retrodev"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbbbbr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-10T18:05:53.000Z","updated_at":"2025-03-31T11:18:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"d9c05e40-4bba-47b1-8355-116e31385635","html_url":"https://github.com/bbbbbr/gimp-rom-bin","commit_stats":{"total_commits":100,"total_committers":2,"mean_commits":50.0,"dds":0.14,"last_synced_commit":"2705c9d072a9ae8c8e88568c20be0a672b707131"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-rom-bin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-rom-bin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-rom-bin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-rom-bin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbbbbr","download_url":"https://codeload.github.com/bbbbbr/gimp-rom-bin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675597,"owners_count":20977376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game-boy","game-boy-advance","genesis","gimp","gimp-plugin","graphics","megadrive","nes","retrodev"],"created_at":"2024-11-16T16:29:22.135Z","updated_at":"2025-10-03T19:24:21.305Z","avatar_url":"https://github.com/bbbbbr.png","language":"C","readme":"gimp file-rom-bin plugin\n===========\n\nGIMP plugin for reading, writing and converting ROM images and tile files. Useful in emulation ROM modding, hacks and extracting/inserting artwork.\n\nDownload compiled executables here: \n * [Linux GIMP 2.8+](/bin/linux)\n * [Windows GIMP 2.10.12+](/bin/windows)\n\n![GIMP Image Editor opening Super Nintendo Image Tiles](https://raw.githubusercontent.com/bbbbbr/gimp-rom-bin/master/info/gimp-rom-image-plugin.png)\n\nSupported image formats:\n * NES 1bpp / 2bpp\n * SNES 2bpp / 3bpp / 4bpp / 8bpp\n * GB 2bpp\n * NGP 2bpp\n * GBA 4bpp / 8bpp\n * GG/SMS/WSC 4bpp\n * MD 4bpp\n \nSupported file extensions:\n * .bin\n * .chr (nes 2bpp)\n * .nes (nes 2bpp)\n * .gb/c (gb 2bpp)\n\n  \n\n\n## Acknowledgement:\n * Source uses some webp gimp plugin code from Nathan Osman (Copyright 2012)\n * Some format documentation from: https://mrclick.zophar.net/TilEd/download/consolegfx.txt\n * YYchr was used for a lot validating format input/output\n\n\n## Quick instructions:\n\nNative compile/install on Linux using below.\n\n```\nIf GIMP \u0026 build tools not yet installed:\n(example for debian/ubuntu/mint)\n * sudo apt install gimp\n * sudo apt install build-essential\n * sudo apt install libgimp2.0-dev\n \nThen: \n* cd gimp-rom-bin\n* make\n\nThen copy the resulting \"file-rom-bin\" to your GIMP plugin folder, depends on version\n\nPlug-in folder locations:\n Linux: ~/.gimp-2.8/plug-ins  , or ~/.config/GIMP/2.10/plug-ins\n Windows: C:\\Program Files\\GIMP 2\\lib\\gimp\\2.0\\plug-ins\n\n```\nGuide for [Cross-compiling to Windows on Linux](https://github.com/bbbbbr/gimp-rom-bin/blob/master/doc/GIMP%20jhbuild%20for%20Windows%20on%20Linux.md)\n\n## Known limitations \u0026 Issues:\n* Palettes: Does not yet import palettes and defaults to internal standard palettes. Which can then be changed using the GIMP color map and Palette tools.\n\n* Image size: ROMs and tile files that are not an even multiple of tile width will get padded with transparent pixels at the end of the image, and have any trailing data stored as gimp image metadata. The plugin will attempt to preserve original file size and integrity as much as possible. Setting transparent pixels (in tiles) at the end of the image to non-transparent will cause those tiles to get written to the file and therefore increase the file size. Be careful. \n\n\n## GIMP usage hints:\n* Set paintbrush tool to:\n  * Brush: Pixel\n  * Opacity: 100%\n  * Size: 1\n\n* Set grid to 8x8\n\n* Colormap \u0026 Palette changing:\n  * Colormap (Palette for current image)  \n    * Show the Palette: --\u003e Menu --\u003e Windows --\u003e Dockable Dialogs --\u003e Show Colormap\n    * Assign a Palette: --\u003e Menu --\u003e Colors --\u003e Map --\u003e Set Color Map\n  * Palette (GIMP system wide palettes available for use)\n    * Show the Palettes Dialog: --\u003e Menu --\u003e Windows --\u003e Dockable Dialogs --\u003e Show Palettes\n    * Import: Palettes Dialog --\u003e Pop-out menu at top -\u003e Palettes Menu -\u003e Import (must be 768 bytes?)\n  * Changing \n    * Assign a palette, convert to RGB and then back to indexed to shrink down and discard unused colors\n    1. Menu -\u003e Colors -\u003e Map -\u003e Set Color Map -\u003e Select desired color map (could be imported or from another image)\n    2. Menu -\u003e Image -\u003e Mode -\u003e RGB\n    3. Menu -\u003e Image -\u003e Mode -\u003e Indexed -\u003e Use Custom Palette + check Remove unused -\u003e Select desired color map (could be imported or from another image)\n\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbbbbr%2Fgimp-rom-bin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbbbbr%2Fgimp-rom-bin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbbbbr%2Fgimp-rom-bin/lists"}