You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Christian Weiske 35656081d3 Keep original order of custom game lists 1 month ago
bin Keep original order of custom game lists 1 month ago
data/templates Use developer URL in game details page and all games list 2 months ago
src Add IPv6 support for push-to-my-ouya 2 months ago
www Do not show an error in make>builds 2 months ago
.gitignore "Push to my OUYA" support 2 months ago
README.rst Explain push-to-my-ouya 2 months ago
config.php.dist "Push to my OUYA" support 2 months ago

README.rst

**************************
stouyapi - Static OUYA API
**************************

A static API for the OUYA gaming console that still lets you sign in
and install games, despite the OUYA server shutdown in 2019.


=====
Setup
=====

OUYA config change
==================
- Mount via USB (Micro USB cable)
- Create file ``ouya_config.properties``
- Add::

OUYA_SERVER_URL=http://stouyapi.boo
OUYA_STATUS_SERVER_URL=http://stouyapi.boo/api/v1/status

The changes should take effect immediately.
If they do not, reboot the OUYA once.


OUYA setup
==========

1. User registration: "Existing account"
2. Enter any username, leave password empty. Continue.
3. Skip credit card registration


Apache setup
============
Virtual host configuration::

Script PUT /empty-json.php
Script DELETE /api/v1/queued_downloads_delete.php

``mod_actions`` need to be enabled for apache 2.4.

The virtual host's document root needs to point to the ``www`` folder.


Building API data
=================
Download the OUYA game data repository from
https://github.com/ouya-saviors/ouya-game-data
and then generate the API files with it::

$ git clone https://github.com/ouya-saviors/ouya-game-data.git
$ ./bin/import-game-data.php ouya-game-data/folders


Building the web discover store
===============================
After building the API files, generate the HTML::

$ ./bin/build-html.php


===============
Push to my OUYA
===============
stouyapi's HTML game detail page have a "Push to my OUYA" button that
allows anyone to tell his own OUYA to install that game.
It works without any user accounts, and is only based on IP addresses.

If your PC that you click the Push button on and your OUYA have the same
public IP address (IPv4 NAT), or the same IPv6 64bit prefix, then
the OUYA will install the game within 5 minutes.

It will also work if you run stouyapi inside your local network, because
all private IP addresses are mapped to a special "local" address.

You can inspect your own download queue by simply opening
``/api/v1/queued_downloads`` in your browser.


========
See also
========

- https://gitlab.com/devirich/BrewyaOnOuya - alternative storefront
- https://archive.org/details/ouyalibrary - Archived OUYA games
- https://github.com/ouya-saviors/ouya-game-data/ - OUYA game data repository


===========
Discoveries
===========

- data/data/tv.ouya/cache/ion/

- image cache for main menu image

- Don't put a trailing slash into ``OUYA_SERVER_URL`` - it will make double slashes