{"id":16188572,"url":"https://github.com/konsumer/docker-gb-dev","last_synced_at":"2025-04-07T13:35:10.279Z","repository":{"id":142067930,"uuid":"246828915","full_name":"konsumer/docker-gb-dev","owner":"konsumer","description":"docker-based full toolkit for developing gameboy games","archived":false,"fork":false,"pushed_at":"2020-05-18T22:49:22.000Z","size":143,"stargazers_count":10,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-13T16:22:49.907Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/konsumer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-03-12T12:30:23.000Z","updated_at":"2022-04-15T12:11:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"8931458f-8e7d-4bf6-a513-8957415904d8","html_url":"https://github.com/konsumer/docker-gb-dev","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Fdocker-gb-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Fdocker-gb-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Fdocker-gb-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/konsumer%2Fdocker-gb-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/konsumer","download_url":"https://codeload.github.com/konsumer/docker-gb-dev/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247662646,"owners_count":20975286,"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":[],"created_at":"2024-10-10T07:28:03.108Z","updated_at":"2025-04-07T13:35:10.244Z","avatar_url":"https://github.com/konsumer.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is a docker-based full toolkit for developing gameboy games.\n\n![screeenshot](./screenshot.png)\n\nAll you need is docker, and it should run on any OS:\n\n```sh\nmkdir work\ndocker run --name='gb' --rm -it -p 8080:8080 -v \"${PWD}/work:/home/gbdev\" konsumer/gb\n```\n\nThen open http://localhost:8080\n\nA bunch of tools are installed, with an X-windows server, that runs VNC. It's got fluxbox and some windows tools setup with wine.\n\nI also included [gbtdg](https://github.com/chrisantonellis/gbtdg) which is great for making splash images, at http://localhost:8080/gbtdg/\n\n`/home/gbdev` is meant to be your working directory, as you are logged in as `gbdev`. This helps with permissions on mac/linux, as it makes it all run as user-1. In the above `docker run` example, I am volume-mounting it to a dir `work/`, so I can compile stuff in that dir. You can mount it however you like, though.\n\nSome useful things to do:\n\n```sh\n# run text-mode bash inside container\ndocker exec -it gb bash\n\n## inside container\n\n# run Gameboy Tile Designer\nwine /opt/gbtd/GBTD.EXE\n\n# run Gameboy Map Builder\nwine /opt/gbmb/GBMB.EXE\n\n# run BGB Gameboy Emulator\nwine /opt/bgb/bgb.exe\n```\n\nThere is also GBDK/RGBDS installed in `/opt`, so you can use those in your makefiles. I also added some of these tools to the fluxbox menu (right-click on desktop.)\n\nIf you want to try it out, put the `example/` dir in your work folder, and run this:\n\n```sh\ndocker run --name='gb' -d --rm -p 8080:8080 -v \"${PWD}/work:/home/gbdev\" konsumer/gb\ndocker exec -it konsumer/gb bash\ncd example\nmake\nwine /opt/bgb/bgb.exe demo.gb\ndocker kill gb\n```\n\n## more info\n\nHere are the tools installed in your environment:\n\n- [gbdk-2020](https://github.com/Zal0/gbdk-2020)\n- [rgbds](https://github.com/rednex/rgbds)\n- [gameboy tile designer](http://www.devrs.com/gb/hmgd/gbtd.html) (via wine)\n- [gameboy map builder](http://www.devrs.com/gb/hmgd/gbmb.html) (via wine)\n- [bgb gameboy emulator](https://bgb.bircd.org/) (via wine)\n- [gameboy tile data generator](https://github.com/chrisantonellis/gbtdg) (running [on web](http://localhost:8080/gbtdg/))\n\n\n## TODO\n\n* make a tutorial with demo project","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonsumer%2Fdocker-gb-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkonsumer%2Fdocker-gb-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkonsumer%2Fdocker-gb-dev/lists"}