meienberger / nextgba

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

NextGBA - All you gameboy games in a browser window

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 project.

⚡ Getting Started

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

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

❤️ 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.

nextgba's Issues

Dark mode

It would be nice to have a dark mode in the app too.

Added Entries not appearing in the list

Hello, I have a few ROMs that I uploaded and have not appeared in the list, and if I attempt to reupload them, I am notified that the game has already been added. If I change the name slightly to upload the rom under a new name, I see the notification that the game was added, but the list does not reflect this.

If I navigate to the folder where the games are held /nextgba/data/games/ the files are in the directory.

I have tried clearing my cache and using different devices and browsers.