/ArduboyCollection

Collection of Arduboy compiled games, demos and applications. Fork the repo and add your own games via Pull requests.

BSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Erwin's Arduboy Collection

paypal

You can browse this repo here: http://arduboy.ried.cl

Json file for the repository: http://arduboy.ried.cl/repo.json

Play games

Windows

  1. Install Arduboy Uploader

  2. Browse this repository using http://arduboy.ried.cl, if you clicked yes to the arduboy: protocol association when installing Arduboy Uploader, you can click "Upload to my Arduboy", otherwise just download the games and open Arduboy Uploader manually

Also, check out alternatives for this platform.

Android

  1. Install Arby Utility

  2. Click "Upload to my Arduboy" in http://arduboy.ried.cl and follow Arduboy Utility steps in your phone

Also, check out alternatives for this platform.

Demo

Submit your game

  1. Fork this repo (If you do not get what this step means, stop and follow this steps) and also Star this repo
  2. Create a new unique folder (case insensitive) for your game under an existent category folder (i.e. Arcade, RPG, etc)
  3. Inside your folder, place:
Filename Description
anything.hex Your compiled game for the Arduboy (check below for more details)
anything.png Banner image / screenshot of the game
anything.url Game details URL (using the typical browser format for bookmark files, check below)
game.ini Information of the game (check below for format details)
source.url (Optional) Contains the URL of the source code of the game
  1. Sync your fork and Create a Pull request

game.ini format

title=Game name
date=yyyy-MM-ddTHH:mm:ssZ
author=Author
description=Description of the game
license=Identifier of the license used in the game

Instead of typing the date and time for the date variable, you can use: https://www.utctime.net/

For the license variable, you need to use one of the identifiers defined here: https://spdx.org/licenses/

You can also add the following entry to reference a remote file. If you are linking to github, make sure it is the "Raw" version of the url and not the github details for the file. You can include extra files, but they wont appear anywhere and your Pull Request may not be accepted if the commit is too messy.

hex=http://url.to/your/own/server-with-the/game.hex

This file is parsed by php's parse-ini-file function, try to avoid trailing spaces.

.url format

TIP: You can drag from the left side of your browser's address bar to a folder to get the .url file of the current webpage

[InternetShortcut]
URL=https://url.to/the/website

A webhook updates the repository static json file after a commit automatically.

Get your game.hex file

  1. Open your code in Arduino IDE
  2. Click Sketch / Export compiled Binary
  3. Click Sketch / Show Sketch Folder

WARNING: Do not use the with_bootloader.leonardo.hex file. This file may brick your Arduboy. Arduboy Uploader will protect your Arduboy from this kind of issues, but if you manage to brick your device, check the following instructions