OUYA game data
Meta data of games for the OUYA console. Use them to populate your own "Discover" server.
.apk files are hosted on The OUYA library in the Internet Archive.
How to help
Add a new version
Locate the JSON game data file in the
Open it in a text editor
"releases"and duplicate the current release, then adjust it:
nameto the new version
versionCodeyou need to have the Android SDK tool
$ aapt dump badging game.apk package: name='example.game' versionCode='23' versionName='1.23'
Create a random
uuidwith a web service or the
uuidcommand line tool
dateto the time the version has been released
truefor the new version, and
falsefor all others.
urlmust be a HTTP URL, not HTTPS!
sizeis the apk file size in bytes
md5sumcan be created with the
md5sumcommand line tool.
Check if everything is correct -> See "validating the game files"
You can also create a patch/pull request; Github will run the checks automatically.
Add a new game/app
You can use the script
bin/create-from-apk.php to generate the JSON.
Only adjust the FIXME fields afterwards!
example-game.json to the
new/ folder and adjust it.
You can get
aapt as described above.
Note that all URLs have to be plain
http, HTTPS is not supported!
Use a random
uuid as developer UUID.
0 for the first 8 characters so we can distinguish original UUIDs
from self-generated ones.
On the command line:
$ unzip -j game.apk res/drawable-xhdpi-v4/ouya_icon.png
This image has a size of 732x412 pixels.
Media images need to have a full size of 1280x720, while thumbnails have a size of 852x479.
Games in demo mode
When you start a game, it should be unlocked (full version) automatically.
If a game is stuck in demo mode despite that you installed the ouya-plain-purchases module, this can have the following reasons:
- The game data file has no purchasable products (most often)
- The developer UUID is wrong. Fix it! (sometimes)
- The game does not fetch receipts from the server when starting up (seldom)
- We have no game data file for it (seldom)
We do not have all developer UUIDs which are required for in-game purchases
Dummy UUIDs begin with
UUIDs that are not important because the game has no IAPs begin with
When there are no products in the game data file, we have to get them from the game itself.
- Add a new line
ouya_config.propertiesfile and reboot.
- Connect the OUYA to your PC and run
- Start the game and look at the logcat output
There will be lines like this:
D/HTTP ( 604): Request 33: GET /api/v1/developers/b8b9eb6d-.../products/?auth_token=...&only=overkill2_om_1%2Coverkill2_om_2
&only= are product IDs.
%2C is an URL-encoded comma, so in the example we have two product IDs.
Now have a look at the
example-game.json file and add new products to
your game's data file (in the
If you do not know what price the product had, use
Validating the game files
We provide a JSON schema file:
- Install php-json-schema to get the
- Use python's
pip3to install the jsonschema cli tool
Self-hosted OUYA servers: