Eried's Unofficial Repository :)


Joking :crazy_face:

1 Like

Ah :sweat_smile:

I just submitted a pull request with all the good stuff, even made some fun promo images. Should be all set now!

1 Like

Don’t even get me started, the ambiguity is real. :P

For future record (and to anyone reading this),
if you want to open up the source code but keep the assets closed you can license them separately.

In particular, if you want to make the code open source but keep the graphics closed off,
you can license the code as MIT, BSD-3, Apache 2.0 et cetera,
whilst licensing the graphics and/or other assets under something restrictive like CC BY-NC-ND.

The interesting result of this approach is that the restrictions placed on the graphics then affect the game.
In the case of CC BY-NC-ND this has two notable effects:

  • The game cannot be sold as long as it retains the original graphics (NC)
  • The game must be distributed with the level of attribution afforded by a CC BY clause
  • Anyone modifying the code must completely remove the original graphics before being allowed to either profit from the code (NC), avoid the extended attribution (BY) or in fact distribute a modified version of the game (ND)
  • Code from the game can still be ‘borrowed’ for use in other games under the terms of the code licence

I am honoured… and I’ll probably fork your repo and do the right thing lol. Nice stats too :slight_smile:


Before the year ends, here are the month stats:

There is two times more visits, with China beating all other regions combined. There are lots of “landings” from weird (CDN?) URLs like https://oracle<number> and other https://oracle.<domain>.<domain>.dev/

As new sources for Arduboy players, there is a bunch from

But the king now is which surpassed by a big margin and as ardu-sources.

End of the Arduboy Collection report for Q2-Q4 xD

PS: New games entries have slowed down, but there is 280 games now:


any games update so far? )

Indeed, but not many more new games (284 total). Traffic in the other hand is increasing, with China as the leader:

Something very uncommon is to see that everyone is actually typing my URL instead of getting there by redirections, with most of the traffic being Direct:


can i get the list of the all games with the “more info” links somehow?
want to check it to port all of them ))

More likely they’ve bookmarked the page, which is what I’ve done.

Some of those referrers indirectly explain the high China traffic.
(I’d honestly be tempted to try to block refers from certain URLs just to screw with the clone-making companies. :P)

Gitee is actually quite an interesting one - it’s basically Chinese GitHub.
I’m beginning to think we’re missing a trick by not having a 中文 section on the forum.
(Assuming the ‘great firewall’ isn’t blocking the forum.)

(Note: the refers from altronics can also be linked to Keyestudio. I’m beginning to think Keyestudio might be behind the attempt to squat the Arduboy trademark in China.)


You can fork the repo and easily create a script for filtering them out in your local copy

1 Like

and it should be a private project pointing to the repo…

It’s this project primarily. It’s just another homemade Arduboy (though quite a well made one).

Question on cleaning up the repo for use with the FX (and ArduManFX).

There’s been a lot of extensive work in making FX compatible title screens for each game (at least those in the Gold Cart). I was trying to figure out a good way to submit a PR to the repo to accommodate this. These are the two methods I thought of:

  • Replace all banner images with a proper FX compatible image.
  • Add the FX compatible image as the first screenshot (no games currently have screenshots).

There’s also a lot of newer games that haven’t been added to the repo. As I finalize ArduManFX and possibly incorporate the FX title images into the repo I could also add as many of these as I can locate. If they don’t have an FX title image I should be able to make one using a screenshot easily enough (simply removing any menu options so it doesn’t look like the game is already running).

I like this format and since we don’t have any FX enabled games yet (ones that have data files) I’ll go ahead and setup ArduManFX to use expect this method for now, unless anyone has a better alternative.

When I do the update to the repo it might be a good idea to re-organize the categories to match those from the Gold Cart.

As it stands I’m almost done with the FX cart building routines (allowing games from within the repo and games not in the repo). There’s also the ability to export a .FX (compressed json file) that will embed any files not in the repo so it can be distributed to others (who can then use it as a base and add/remove stuff as they see fit).

I’ve got a little bit of time on my hands at the moment and am hoping to really push myself to get ArduManFX finalized (at least as far as managing FX carts). Additional features will be implemented as I have time.


My original idea was to make a gif of each game so I made a macro with some button presses (3 set of them) and then I was going to select one of the 3 gif recorded by the emulator.

After a while I figured out that it was a gigantic problem to deal with, because the emulator had issues being consistent generating the gif, etc so I aborted the idea.

So, go ahead with any cleanup :slight_smile:

or maybe fx.png could be specific for using in the FX games? then if people do not add that one, they wont get it listed on the FX but new people is not forced to anything extra

Looking over the different options for enhancing ArduManFX’s support for this repo. Currently I’m downloading the json file pointed to on the website, then parsing it and downloading all necessary hex files, images, and FX data (if present). However, it might actually work out better to instead use something like libgit2 (possibly libqgit2 since it’s libgit2 with Qt wrappers) and then simply update the local copy with the master repo. Looking over the repo I should actually be able to parse it as is without needing the json file. The parsing would be something like:

  • Folders in the root folder are categories (except the ‘docs’ folder)
  • Folders inside the categories are games (one folder per game and one game per folder)
  • There should only be a single HEX file which will be marked as the game
  • If FX data is present it should be a DAT file (since BIN is used for compiled flash carts it would be good to avoid using the same extension to lessen accidental uploads of whole flash carts).
  • Category/Game/game.ini has things like the title, author, and description (and the id used for the ratings is simple and clever "id"=>substr(md5($author . '_' . $title),2,6)
  • All images can be classed as screenshots (if only one image is present then it’ll be the banner image otherwise I could try and determine the correct image). If an fx.png is present it will serve as the title image for the ArduManFX UI as well as the title image for the FX UI.
  • Being able to easily generate the game ids from the contents of game.ini will make it possible to still include the user ratings for each game.

Currently the repo updater doesn’t actually populate the screenshots array for each game, nor does it have anyway to detect FX enabled games. If I switch to using the raw git repo then downloading a cache of the latest updates would be a lot faster as it won’t be downloading each individual hex/image files one at a time.

With all of that it means I will be able to clone the repo and work on adding all the appropriate fx.png images as well as comb through any new games released that haven’t been added yet. This also makes it so people can provide their own repos by simply creating a new folder and structuring it the same (later a handy GUI will be made to manage local repos).


Encountering some interesting issues with the repo (all are being fixed as I’m doing a massive update to the repo to better support the new FX mod).

Notable issues:

  • Games with no title: some games don’t specify a title parameter in the game.ini file. While not a major issue as my ArduManFX tool defaults to the game’s folder name if no title is present, it would be better to have consistency across all games.
  • Images saved with the wrong file extension: Surprisingly I’m actually encountering a number of images saved with the .png extension that are actually BMPs, GIFs, and a couple JPGs. A tool such as pngcrush can help make sure the images are properly formatted png images.

While I’m updating the repo (mostly to add some new games and add the FX images) I was thinking it would be a good idea to re-organize the categories to match the ones from the gold cart.

I think it would be a good idea, but are those categories now standard?. I still need to work on the github updater :confused: because github changed the way to access stuff and every time I generate a repo update I get some email warnings about deprecation of api access…

Not sure, but there was a lot of discussion on them for the Gold Cart so I figured it’d be a good place to start. Though looking at how your updater determines the category based on the folder name and I’ve got ArduManFX setup to do the same it wouldn’t be difficult to add/remove categories. I kind of figured if a category starts to get a bit too many games it can always be split into multiple categories.

The way I’ve setup ArduManFX is the user can manually move a game to a different category, otherwise it will stay in whatever category it currently is in the repo (including adjusting if the category changes).

Well the only slight changes I’m doing is adding an fx.png image for the FX loader image and an anything.dat file for FX data if a game utilizes the FX mod for more data.

It seems that by selecting “Play in emulator” on the website, the emulator runs, but the game does not ( Is this my local problem or something really broke?

it seems the emulator is down, or maybe is github? or related to facebook/instagram/whatsapp being down? (for some reason…)