{"id":15651693,"url":"https://github.com/flozz/img2gb","last_synced_at":"2025-06-17T00:32:53.732Z","repository":{"id":34743172,"uuid":"156384301","full_name":"flozz/img2gb","owner":"flozz","description":"Converts images to GameBoy tiles","archived":false,"fork":false,"pushed_at":"2025-06-10T11:02:02.000Z","size":6551,"stargazers_count":35,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-10T12:19:34.001Z","etag":null,"topics":["gameboy","tilemap","tileset"],"latest_commit_sha":null,"homepage":"https://flozz.github.io/img2gb/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flozz.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":"flozz","custom":["https://www.paypal.me/0xflozz","https://www.buymeacoffee.com/flozz"]}},"created_at":"2018-11-06T13:00:40.000Z","updated_at":"2025-06-10T11:01:59.000Z","dependencies_parsed_at":"2023-01-15T08:54:52.121Z","dependency_job_id":"41a170b6-09b0-4543-9a52-797f62f1425e","html_url":"https://github.com/flozz/img2gb","commit_stats":{"total_commits":123,"total_committers":3,"mean_commits":41.0,"dds":"0.22764227642276424","last_synced_commit":"c3575d9a9815a9e0f39ed89c40972fb18a9b037b"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/flozz/img2gb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flozz%2Fimg2gb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flozz%2Fimg2gb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flozz%2Fimg2gb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flozz%2Fimg2gb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flozz","download_url":"https://codeload.github.com/flozz/img2gb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flozz%2Fimg2gb/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260268197,"owners_count":22983599,"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":["gameboy","tilemap","tileset"],"created_at":"2024-10-03T12:39:44.914Z","updated_at":"2025-06-17T00:32:53.693Z","avatar_url":"https://github.com/flozz.png","language":"Python","readme":"img2gb - Converts Images to GameBoy Tileset and Tilemap\n=======================================================\n\n|GitHub| |Lint and Tests| |PYPI Version| |License| |Discord| |Black|\n\n    img2gb generates GameBoy Tilesets and Tilemaps from standard image (PNG,\n    JPEG,...). It converts the images into the GameBoy image format and\n    generates C code (``.c`` and ``.h`` files) that can be used in GameBoy\n    projects.\n\n.. image:: ./doc/_static/banner.png\n\n* Documentation: https://flozz.github.io/img2gb/\n* HowTo: https://flozz.github.io/img2gb/howto.html\n\n\nDependencies\n------------\n\n* Python \u003e= 3.9\n* Pillow \u003e= 5.0\n\n\nInstall\n-------\n\n* See https://flozz.github.io/img2gb/install.html\n\n\nUsage\n-----\n\n* See https://flozz.github.io/img2gb/cli.html\n\n\nHacking\n-------\n\nSetup\n~~~~~\n\nTo work on img2gb first create a virtualenv::\n\n    python3 -m venv __env__\n\nand activate it::\n\n    source __env__/bin/activate\n\nThen install the project with all dev dependencies::\n\n    pip install -e .[dev]\n\n\nCommands\n~~~~~~~~\n\nYou can lint the code and check coding style with::\n\n    nox -s lint\n\nYou can fix coding style using Black with::\n\n    nox -s black_fix\n\nYou can run test on all supported Python versions or on a specific Python\nversion with::\n\n    nox -s test       # Run on all Python version\n\n    nox -s test-3.9   # Run on Python 3.9\n    nox -s test-3.10  # Run on Python 3.10\n    nox -s test-3.11  # Run on Python 3.11\n    nox -s test-3.12  # Run on Python 3.12\n    nox -s test-3.12  # Run on Python 3.13\n\nAnd you can build the documentation with (result in ``build/html/``)::\n\n    nox -s gendoc\n\n\nLinks\n-----\n\n* Examples of GameBoy programs that uses img2gb for graphics:\n  * https://github.com/flozz/gameboy-examples/tree/master/05-graphics2\n  * https://github.com/flozz/gameboy-examples/tree/master/06-graphics3-background\n* Article about the tile encoding and img2gb: https://blog.flozz.fr/2018/11/19/developpement-gameboy-5-creer-des-tilesets/ (French)\n\n\nSupport this project\n--------------------\n\nWant to support this project?\n\n* `☕️ Buy me a coffee \u003chttps://www.buymeacoffee.com/flozz\u003e`__\n* `💵️ Give me a tip on PayPal \u003chttps://www.paypal.me/0xflozz\u003e`__\n* `❤️ Sponsor me on GitHub \u003chttps://github.com/sponsors/flozz\u003e`__\n\n\nChangelog\n---------\n\n* **[NEXT]** (changes on ``master``, but not released yet):\n\n  * Nothing yet ;)\n\n* **v1.3.0:**\n\n  * feat: Added binary export of tilesets and tilemaps (@duysqubix, #44)\n  * misc: Added Python 3.13 support (@flozz)\n  * misc!: Removed Python 3.8 support (@flozz)\n\n* **v1.2.0:**\n\n  * fix: Fixed wrong version displayed (@flozz, #3)\n  * chore: Added Python 3.11 and 3.12 support\n  * chore!: Removed Python 2.7 and 3.7 support\n\n* **v1.1.0:**\n\n  * Removes arbitrary size limit for tilmaps\n  * Implements ``offset`` option (#2)\n\n* **v1.0.0:**\n\n  * Refacto of the Python API, with new high-level fuction to be easier to use\n  * Refacto of the CLI: now tileset and tilemap are generated separately, this allow more options for both and covers more usecases.\n  * New option to handle alternative palette\n  * New option to handle 8x16px sprites\n  * Documentation\n  * Unit test (everything is not coverd but it is better than nothing :))\n\n* **v0.10.0:** Adds non-RGB image support (indexed images,...)\n* **v0.9.1:** Fixes an issue with Python 3\n* **v0.9.0:** Initial release (generates tiles, tilesets and tilemaps)\n\n\n.. |GitHub| image:: https://img.shields.io/github/stars/flozz/img2gb?label=GitHub\u0026logo=github\n   :target: https://github.com/flozz/img2gb\n\n.. |Lint and Tests| image:: https://github.com/flozz/img2gb/actions/workflows/python-ci.yml/badge.svg\n   :target: https://github.com/flozz/img2gb/actions\n\n.. |PYPI Version| image:: https://img.shields.io/pypi/v/img2gb.svg\n   :target: https://pypi.python.org/pypi/img2gb\n\n.. |License| image:: https://img.shields.io/pypi/l/img2gb.svg\n   :target: https://github.com/flozz/img2gb/blob/master/LICENSE\n\n.. |Discord| image:: https://img.shields.io/badge/chat-Discord-8c9eff?logo=discord\u0026logoColor=ffffff\n   :target: https://discord.gg/P77sWhuSs4\n\n.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg\n   :target: https://black.readthedocs.io/en/stable\n","funding_links":["https://github.com/sponsors/flozz","https://www.paypal.me/0xflozz","https://www.buymeacoffee.com/flozz"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflozz%2Fimg2gb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflozz%2Fimg2gb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflozz%2Fimg2gb/lists"}