Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/meienberger/nextgba

Self-hosted app to play Gameboy games in your browser 🕹ī¸
https://github.com/meienberger/nextgba

gameboy-emulator retrogaming self-hosted

Last synced: 2 months ago
JSON representation

Self-hosted app to play Gameboy games in your browser 🕹ī¸

Awesome Lists containing this project

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.