Erwin's Arduboy Collection
You can browse this repo here: http://arduboy.ried.cl
Json file for the repository: http://arduboy.ried.cl/repo.json
Play games
Windows
-
Install Arduboy Uploader
-
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
-
Install Arby Utility
-
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.
Submit your game
- Fork this repo (If you do not get what this step means, stop and follow this steps) and also Star this repo
- Create a new unique folder (case insensitive) for your game under an existent category folder (i.e. Arcade, RPG, etc)
- 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 |
- 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
- Open your code in Arduino IDE
- Click
Sketch / Export compiled Binary - 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