https://github.com/nicotsx/nextgba

Self-hosted app to play Gameboy games in your browser 🕹️
https://github.com/nicotsx/nextgba

gameboy-emulator retrogaming self-hosted

Last synced: about 1 month ago
JSON representation

Self-hosted app to play Gameboy games in your browser 🕹️

• Host: GitHub
• URL: https://github.com/nicotsx/nextgba
• Owner: nicotsx
• License: gpl-3.0
• Created: 2024-02-20T20:19:34.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-03T19:25:21.000Z (7 months ago)
• Last Synced: 2025-03-19T23:29:24.643Z (about 2 months ago)
• Topics: gameboy-emulator, retrogaming, self-hosted
• Language: TypeScript
• Homepage:
• Size: 1.14 MB
• Stars: 24
• Watchers: 2
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-homelab - NextGBA - hosted app to play Gameboy games in your browser 🕹️ | (Apps / Gaming)

README

        
# NextGBA - All you gameboy games in a browser window

[![License](https://img.shields.io/github/license/meienberger/nextgba)](https://github.com/meienberger/nextgba/blob/main/LICENSE)

[![Version](https://img.shields.io/github/v/release/meienberger/nextgba?color=%235351FB&label=version)](https://github.com/meienberger/nextgba/releases)

![Issues](https://img.shields.io/github/issues/meienberger/nextgba)

Have you ever wanted to play your favorite gameboy games in a self-hosted web app that can save the game state and can be accessed from anywhere on your network? **NextGBA** is your friend!

It emphasize a simple UI with all the features you could ever need. The game player is based on the very famous [EmulatorJS](https://emulatorjs.org/) project.

![Preview](screenshots/main.png)

![Upload](screenshots/upload.png)

![Ingame](screenshots/ingame.png)

## ⚡ Getting Started

To get started simply create a docker-compose file with the following content:

```YAML

services:

  nextgba:

    container_name: nextgba

    image: ghcr.io/meienberger/nextgba:latest

    ports:

      - 3000:3000

    volumes:

      - ./data/games:/data/games

```

You can also spin it up through a tipi instance so everything will be preconfigured for you. Check out tipi [here](https://runtipi.io)

## ❤️ Contributing

Any kind of contributions are welcome on this project! If you encounter any issues or have any ideas for new features, feel free to open an issue or a pull request.

## 📜 License

NextGBA is licensed under the GNU General Public License v3.0. TL;DR — You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.