whatisgithub

What is gb-studio?

chrismaltby/gb-studio — explained in plain English

Analysis updated 2026-06-24

9,274TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A drag-and-drop desktop app for Mac, Windows, and Linux that lets you create Game Boy games without writing code, then compiles a real ROM file you can play on original hardware, emulators, or as a web build.

Mindmap

mindmap
  root((repo))
    What It Does
      Create Game Boy games
      No coding needed
      Export to ROM
    Output Formats
      Game Boy ROM
      Web build
      Analogue Pocket ROM
    Tools
      Visual drag-drop editor
      CLI compiler
      Language JSON files
    Use Cases
      Make retro games
      Share online
      Automate builds
    Audience
      Hobbyist game makers
      Retro game fans
      No-code creators
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Design and export a playable Game Boy ROM without writing any C or assembly code using the visual editor.

USE CASE 2

Use the CLI to compile a ROM from a GB Studio project file in an automated build pipeline.

USE CASE 3

Export your game as a web build to share it online without requiring a physical cartridge or emulator download.

USE CASE 4

Translate the GB Studio interface into a new language by editing the JSON language files in the repository.

What is it built with?

TypeScriptElectronGBDK

How does it compare?

chrismaltby/gb-studioopencti-platform/openctimularahul/keyviz
Stars9,2749,2789,265
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/54/52/5
Audiencegeneralops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min
Free to use, modify, and distribute for any purpose including commercial projects, as long as the MIT license notice is kept.

So what is it?

GB Studio is a desktop application that lets you create retro-style adventure games for the original Game Boy handheld console without writing code. It is available for Mac, Windows, and Linux. You design your game using a visual editor and the tool compiles everything into a ROM file, which is the format the Game Boy reads. That ROM can be played on original hardware using a cartridge flasher, on a Game Boy emulator, or as a web build you can share online. The application is built on Electron, which is a framework for making desktop apps with web technologies, and under the hood it uses GBDK, a development kit for writing Game Boy games in C. When you publish your game, GB Studio handles all of that compilation work so you do not have to deal with the underlying toolchain yourself. Aside from the graphical editor there is also a command-line interface for users who want to automate parts of the workflow. The CLI can export a project to GBDK source code, compile a Game Boy ROM file, compile a file for the Analogue Pocket handheld, or produce a web build, all from a project file created in the visual editor. The project is open source under the MIT license and has been actively developed since 2019. It has a community on Reddit and Discord, and the author accepts support through Patreon. Documentation lives on the GB Studio website. Translations for the interface into other languages can be contributed by editing JSON language files in the repository. GB Studio is aimed at people who want to make games in the style of classic Game Boy titles without learning the low-level programming those games originally required. The barrier to entry is intentionally low.

Copy-paste prompts

Prompt 1
I want to make a simple top-down adventure game in GB Studio, walk me through setting up scenes, sprites, and player movement without writing code.
Prompt 2
How do I use the GB Studio CLI to compile a ROM file from my project.gbsproj file without opening the desktop app?
Prompt 3
Export my GB Studio game as a web build I can share on itch.io, what are the exact steps?
Prompt 4
How do I add a new language translation to GB Studio by editing the JSON language files in the repo?
Prompt 5
What is the difference between exporting a Game Boy ROM and an Analogue Pocket ROM in GB Studio?

Frequently asked questions

What is gb-studio?

A drag-and-drop desktop app for Mac, Windows, and Linux that lets you create Game Boy games without writing code, then compiles a real ROM file you can play on original hardware, emulators, or as a web build.

What language is gb-studio written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, GBDK.

What license does gb-studio use?

Free to use, modify, and distribute for any purpose including commercial projects, as long as the MIT license notice is kept.

How hard is gb-studio to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is gb-studio for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.