Skip to content
JavaScript Game Boy Color emulator for iOS
HTML JavaScript CSS Python
Branch: master
Clone or download

Latest commit

imethorsen Merge pull request #135 from cclauss/patch-1
Use print() function in both Python 2 and Python 3
Latest commit d24346a Mar 18, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Remove the debug flag and check in the new build output. Dec 1, 2019
ansible Introducing a new ansible deployment. Apr 5, 2016
build Update the authorization callback. Dec 2, 2019
cores Catching up to the new GameBoy-Online. Mar 31, 2016
graphics Adding now deployment targets, an alpha icon and cleaning up the sign… Jun 1, 2015
icons Adding now deployment targets, an alpha icon and cleaning up the sign… Jun 1, 2015
scripts Use print() function in both Python 2 and Python 3 Mar 17, 2020
service Better paths and add a title. Dec 2, 2019
settings Update the authorization callback. Dec 2, 2019
src Better paths and add a title. Dec 2, 2019
.gitignore Ignore *.pyc. Dec 2, 2019
.gitmodules Change to an HTTPS submodule. Nov 30, 2019
LICENSE Re-licensing under the MIT now that GameBoy-Online has been relicense… Oct 9, 2016
Procfile Introduce a lightweight service for hosting on Heroku. Nov 30, 2019 Merge pull request #109 from EmmanuelRoyOurBoy/patch-1 Nov 30, 2019
brew.txt Updating the README.txt to include mention of submodules. Mar 20, 2016
gameplay.sublime-project Updating the sublime project. Apr 4, 2016
ubuntu.txt Add instructions for installing dependencies on Ubuntu. Nov 30, 2019

Game Play

A JavaScript Game Boy and Game Boy Color emulator for iOS, based on the GameBoy-Online emulator core.

If you just want to play Game Play, you can find it online at


Check out the project, update the submodules, install the brew-based dependencies, and install the additional Python dependencies:

git clone
cd gameplay
git submodule update --init --recursive


cat brew.txt | xargs brew install
cd scripts
pipenv install


cat ubuntu.txt | xargs sudo apt install
cd scripts
pipenv install

It may be necessary to install pipenv as follows:

pip3 install pipenv


Game Play is built using a custom Python build script which inlines and minifies HTML, CSS and JavaScript, and binds in the settings for a given deployment.

For example, building the release version of Game Play as hosted on can be done by running the following command from the root of the repository:

scripts/build build settings/release.json

The build will be created in the build directory, and a corresponding *.tar.gz will be creatd in archives, tagged with the git sha and settings name (e.g., build-168bd9d0d8d309a1efb1983bd61ec34ff22951b5-release.tar.gz).


Version 2.3.8

  • Fix audio playback on iOS 11.

Version 2.3.7

  • Updating Google Drive authentication.

Version 2.3.6

  • Improving the first run messaging.

Version 2.3.5

  • Fixing the icon on the sign in page.

Version 2.3.4

  • Fixing some crashes.

Version 2.3.3

  • Re-enable crash reporting.
  • Bug fixes.

Version 2.3.2

  • Fixing a small bug in artwork lookup.
  • Minor improvements to logging.

Version 2.3.1

  • Adding a mechanism to email logs.

Version 2.3.0

  • New improved game library.

Version 2.2.3

  • Catching up to upstream GameBoy-Online.
  • Some UI improvements.

Version 2.2.2

  • Don't animate the console when restoring games.
  • Temporarily disabling button animations to improve audio performance.

Version 2.2.1

  • New in-game menu.
  • Menu option for resetting the current game.
  • Menu option for Zelda fans: A + B + Select + Start.

Version 2.2.0

  • Support for diagonal directions using the d-pad.
  • Improved scrolling in the game library.

Version 2.1.7

  • Setting for console color.
  • Work-around for audio playback issues on iPhone 6.

Version 2.1.6

  • Adding support for different emulation speeds.

Version 2.1.5

  • Adding scrolling to the settings dialog on small screens.
  • Adding the version to the settings dialog.

Version 2.1.4

  • Moving the account sign out and 'Say Thanks' into a new settings dialog.
  • Adding the option to disable sound; use this to listen to your own music!

Version 2.1.3

  • Fixing early Google Drive session expiry.
  • Minor UI tweaks.

Version 2.0.13

  • Show release notes when informing users about updates.
  • Only display errors if no update is available.

Version 2.0.12

  • Improving guards against loading corrupt ROMs.

Version 2.0.11

  • Correcting the characters used on the d-pad and in the 'Say Thanks' link on iOS 8.3.

Version 2.0.10

  • Adding the application version, screen size and the user agent string into the logs.

Version 2.0.9

  • Improved logging.
  • Better error handling of missing ROMs.

Version 2.0.8

  • Improving information available in crash log emails.
  • Fixing some bugs which resulted in an attmept to play and save ROMs that had failed to download.
  • Introduced a recovery mechanism for the above scenario.
  • Improved debugging tools.

Version 2.0.7

  • Layout support for iPhone 4 and 4S.

Version 2.0.6

  • Changing the default error handler to ignore errors from cross-origin scripts.

Version 2.0.5

  • Fixed crash when inspecting Google Drive files with no extension.
  • Preventing application from running if the user cancels database creation.
  • Fixed crash when Google Drive returned an empty response.
  • Fixed crash due to incorrectly named logging call.

Version 2.0.0

  • Initial release of Game Play.

Version 1.0.0

  • Initial release of Game Play.


Many thanks to:


  1. Game Boy and Game Boy Color are trademarks of Nintendo Co., Ltd.. All rights reserved.
  2. Downloading copied ROMs is illegal: only use images you have created from ROMs you own yourself.
  3. InSeven Limited is an independent software company and is in no way affiliated with Nintendo Co., Ltd..


Game Play and its dependencies are licensed under the MIT license. See LICENSE for more details.

Third Party Sources

Game Play includes the following third party sources:

  • jQuery - Copyright (C) 2013 jQuery Foundation and other contributors
  • GameBoy-Online - Copyright (C) 2010-2016 Grant Galitz
You can’t perform that action at this time.