{"id":13561313,"url":"https://github.com/gbdk-2020/gbdk-2020","last_synced_at":"2025-05-14T07:09:38.423Z","repository":{"id":37599288,"uuid":"253045857","full_name":"gbdk-2020/gbdk-2020","owner":"gbdk-2020","description":"An updated version of GBDK, C compiler, assembler, linker and set of libraries for the Nintendo Gameboy, Nintendo Entertainment System, Sega Master System, Sega Game Gear.","archived":false,"fork":false,"pushed_at":"2025-05-06T10:40:17.000Z","size":28589,"stargazers_count":1886,"open_issues_count":8,"forks_count":129,"subscribers_count":34,"default_branch":"develop","last_synced_at":"2025-05-06T11:50:34.721Z","etag":null,"topics":["gameboy","gbdk","sdcc"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gbdk-2020.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,"zenodo":null}},"created_at":"2020-04-04T16:28:58.000Z","updated_at":"2025-05-06T10:40:22.000Z","dependencies_parsed_at":"2023-02-19T05:46:18.477Z","dependency_job_id":"423cda73-797e-4661-a268-a4227d1bb360","html_url":"https://github.com/gbdk-2020/gbdk-2020","commit_stats":{"total_commits":1646,"total_committers":33,"mean_commits":"49.878787878787875","dds":0.5856622114216281,"last_synced_commit":"d20401df9bb8e8269d0740b177be31f021bf0424"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbdk-2020%2Fgbdk-2020","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbdk-2020%2Fgbdk-2020/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbdk-2020%2Fgbdk-2020/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbdk-2020%2Fgbdk-2020/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gbdk-2020","download_url":"https://codeload.github.com/gbdk-2020/gbdk-2020/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254092787,"owners_count":22013290,"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","gbdk","sdcc"],"created_at":"2024-08-01T13:00:54.776Z","updated_at":"2025-05-14T07:09:33.412Z","avatar_url":"https://github.com/gbdk-2020.png","language":"C","funding_links":[],"categories":["Development"],"sub_categories":["Game Development","Engine"],"readme":"# GBDK-2020\nGBDK is a cross-platform development kit for sm83, z80 and 6502 based gaming consoles. It includes libraries, toolchain utilities and the [SDCC](http://sdcc.sourceforge.net/) C compiler suite.\n\n__Supported Consoles:__ [(see docs)](https://gbdk-2020.github.io/gbdk-2020/docs/api/docs_supported_consoles.html)\n- Nintendo Game Boy / Game Boy Color\n- Analogue Pocket\n- Sega Master System \u0026 Game Gear\n- Mega Duck / Cougar Boy\n- NES\n\nExperimental consoles (not yet fully functional)\n  - MSXDOS\n\n\n## Current Release\n\n[![Current Release](https://img.shields.io/github/v/release/gbdk-2020/gbdk-2020?label=Current%20Release)](https://github.com/gbdk-2020/gbdk-2020/releases/latest)\n![Downloads](https://img.shields.io/github/downloads/gbdk-2020/gbdk-2020/total?label=Total%20Downloads)\n\n\u003ca href=\"https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-linux64.tar.gz\"\u003e\u003cimg src=\"https://img.shields.io/badge/Linux-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black\" alt=\"GBDK-2020 Linux Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-macos.tar.gz\"\u003e\u003cimg src=\"https://img.shields.io/badge/mac%20os%20intel-000000?style=for-the-badge\u0026logo=apple\u0026logoColor=white\" alt=\"GBDK-2020 MacOS Intel Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-macos-arm64.tar.gz\"\u003e\u003cimg src=\"https://img.shields.io/badge/mac%20os%20arm%20(m*)-000000?style=for-the-badge\u0026logo=apple\u0026logoColor=white\" alt=\"GBDK-2020 MacOS ARM Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-win64.zip\"\u003e\u003cimg src=\"https://img.shields.io/badge/Windows%2064%20Bit-0078D6?style=for-the-badge\u0026logo=windows\u0026logoColor=white\" alt=\"GBDK-2020 Windows 64 Bit Release\"\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-win32.zip\"\u003e\u003cimg src=\"https://img.shields.io/badge/32%20Bit-0078D6?style=for-the-badge\u0026logo=windows\u0026logoColor=white\" alt=\"GBDK-2020 Windows 32 Bit\"\u003e\u003c/a\u003e \n\n\u003c!-- \u003ca href=\"https://hub.docker.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docker-2CA5E0?style=for-the-badge\u0026logo=docker\u0026logoColor=white\" alt=\"Docker\"\u003e\u003c/a\u003e --\u003e\n\nUpgrading to a new version? Check the [Migration notes](https://gbdk-2020.github.io/gbdk-2020/docs/api/docs_migrating_versions.html). You can find older versions [here](https://github.com/gbdk-2020/gbdk-2020/releases).\n\nFor a full list of changes see the [ChangeLog](https://github.com/gbdk-2020/gbdk-2020/blob/master/docs/ChangeLog) file or [online Docs](https://gbdk-2020.github.io/gbdk-2020/docs/api/docs_releases.html).\n\n\n## Build status\n[![GBDK Build and Package](https://github.com/gbdk-2020/gbdk-2020/actions/workflows/gbdk_build_and_package.yml/badge.svg?branch=develop)](https://github.com/gbdk-2020/gbdk-2020/actions/workflows/gbdk_build_and_package.yml)\n\n## Made with GBDK-2020\nSee our gallery showcasing [Games and Programs made with GBDK](https://gbdk-2020.github.io/gbdk-2020-gallery/), including open source and cart release filters.\n\n[![GBDK Showcase Preview](/docs/gbdk_gallery_preview.jpg)](https://gbdk-2020.github.io/gbdk-2020-gallery/)\n\n\n## Docs\nGBDK includes extensive [documentation](https://gbdk-2020.github.io/gbdk-2020/docs/api). A good place to begin is the [Getting Started Section](https://gbdk-2020.github.io/gbdk-2020/docs/api/docs_getting_started.html).\n\nCheck the [Links and Third-Party Tools Section](https://gbdk-2020.github.io/gbdk-2020/docs/api/docs_links_and_tools.html) for a list of recommended emulators, graphics tools, music drivers and more.\n\nFor SDCC you can check its [website](http://sdcc.sourceforge.net/) and the [manual](http://sdcc.sourceforge.net/doc/sdccman.pdf)\n\n\n## Usage\nMost users will only need to download and unzip the latest [release](https://github.com/gbdk-2020/gbdk-2020/releases)\n\nThen go to the examples folder and build them (with `compile.bat` on Windows or running `make`). They are a good starting point.\n\nThe sources in this repo are only needed if you want to re-compile GBDK-2020 yourself instead of using the release binaries linked above.\n\n\n## Discord servers\n* [gbdk/zgb Discord](https://discord.gg/XCbjCvqnUY) - For help with using GBDK (and ZGB), discussion and development of gbdk-2020\n\n* [gbdev Discord](https://discordapp.com/invite/tKGMPNr) - There is a #gbdk channel and also people with a lot of Game Boy development knowledge\n* [SMS Power! Discord](https://discord.gg/h5xrKUK) - Additional SMS \u0026 Game Gear discussion and resources.\n\n## Forums\n- [The Game Boy Development Forum](https://gbdev.gg8.se/forums/) - A good place to search for Game Boy related answers. \n- [SMS Power! Forum](https://www.smspower.org/) - Additional SMS \u0026 Game Gear discussion and resources.\n\n\n## Current status\n- Updated CRT and library that suits better for game development\n- SDCC Versions\n  - A [custom build of SDCC](https://github.com/gbdk-2020/gbdk-2020-sdcc/releases) is used with [patches](https://github.com/gbdk-2020/gbdk-2020-sdcc/releases/tag/patches) to support Sega GG/SMS and the Nintendo NES. See the [github workflow](https://github.com/gbdk-2020/gbdk-2020-sdcc/tree/main/.github/workflows) for details of how to patch and build SDCC.\n  - The default calling convention changed in `SDCC 4.2`. This is supported starting with `GBDK-2020 4.1.0`. Older versions of GBDK should use SDCC builds #12539 or older (see per-version GBDK notes).\n- The compiler driver **lcc** supports the latest sdcc toolchain.\n\n\n## Origin\nOver the years people have been complaining about all the GBDK issues caused by a very old version of SDCC (the compiler). This is a proper attempt of updating it while also keeping all the old functionality working, like support for banked code and data and so on.\n\nThe last version in the OLD repo is [2.96](https://sourceforge.net/projects/gbdk/files/gbdk/2.96/) although releases are available until 2.95-3. Version [2.96](https://sourceforge.net/projects/gbdk/files/gbdk/2.96/) is the starting point of this repo.\n\n\n# Build instructions\nUnless you are interested on recompiling the sources for some reason (like fixing some bugs) **you don't need to build GBDK**\n\n- **Windows only**: Download and install [mingw](http://mingw-w64.org/)\n- Clone, download this repo or just get the source from the [releases](https://github.com/gbdk-2020/gbdk-2020/releases)\n- Download and install the **PATCHED** [sdcc builds](https://github.com/gbdk-2020/gbdk-2020-sdcc/releases) from the separate repo for that (https://github.com/gbdk-2020/gbdk-2020-sdcc).\n- On Linux **don't use package managers** The latest release available won't work, you need to compile or download one of the nightlies\n- Create **SDCCDIR** environment variable, that points into the folder, where you installed sdcc\n- Open command prompt or a terminal, go to the root directory of the repo and run **make**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgbdk-2020%2Fgbdk-2020","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgbdk-2020%2Fgbdk-2020","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgbdk-2020%2Fgbdk-2020/lists"}