nyko0311 / gameplay

JavaScript Game Boy Color emulator for the iOS

Game Play Color

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

If you just want to play Game Play Color, you can find it online at https://gameplaycolor.com.

Dependencies

Game Play Color has the following dependencies:

• yuicompressor
• pngcrush
• htmlcompressor

Using Homebrew, you can install these as follows:

brew install yuicompressor pngcrush htmlcompressor

You will also need to include the additional Python dependencies:

pip install --user -r requirements.txt

Building

Game Play Color 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 Color as hosted on gameplaycolor.com can be done by running the following command from the root of the repository:

scripts/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).

Changelog

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

Version 1.0.0

• Initial release of Game Play.

Thanks

Many thanks to:

• Grant Galitz for the GameBoy-Online emulator and core.
• Pedro Ladaria for writing the JSGB core.
• David McLeod for graphical inspiration on Dribbble and for letting me know about MicrogrammaD-MediExte.
• Paul Ledger for suggesting the name 'Game Play'.

Legal

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

License

Game Play Color contains code licensed under the GPL and MIT licenses. See LICENSE.md for more details.