stouyapi - OUYA API server

A static API for the OUYA gaming console that still lets you sign in and install games, despite the OUYA server shutdown in 2019. It brings the "DISCOVER" store back.

This is a static dummy server. It will not store any user data. Your votes and likes will not influence anything. Your username will always be "stouyapi".

Have a look a the OUYA games list!

How to use

If you boot up your OUYA and see the main menu (not the language setup), then all you need is to point your OUYA to this server:

  1. Power the OUYA on
  2. Attach the OUYA via USB (Micro USB cable) to your computer
  3. Create a text file ouya_config.properties in the OUYA's top-level directory with the following content:
    OUYA_SERVER_URL=http://ouya.cweiske.de
    OUYA_STATUS_SERVER_URL=http://ouya.cweiske.de/api/v1/status
    (If you do that via adb shell or directly on the OUYA, then the file path must be /sdcard/ouya_config.properties.)

The changes should take effect immediately (except in the OUYA setup). If they do not, reboot the OUYA once.

Hints

  1. Do not try to use HTTPS because the OUYA does not support SNI.
  2. The OUYA connects to your PC in MTP mode
  3. If your PC does not see the OUYA, use a data transfer micro USB cable with 4 wires instead of a charging-only cable with 2 wires

Factory reset

The config file alone does not help on a factory-reset OUYA gaming console, because OUYA's setup ("OOBE") does not use it for its network connectivity check. You will be stuck at the "network selection" screen with one of the following error messages:

It seems we're unable to connect to the OUYA servers at the moment. We'd recommend confirming your Ethernet and Wi-Fi settings before trying again.

or

Cannot establish a connection with the OUYA Servers. To turn on Wi-Fi, unplug your Ethernet cable and proceed. To retry ethernet, please check your connection and then unplug and re-plug your cable.

There are multiple ways to get over the connectivity check, all involve changing some DNS-related things. The most simple option is to modify your internet router's DNS server setting:

  1. Open your internet router's web interface and change the DNS server temporarily to 83.169.45.222.
  2. Finish the OUYA setup including registration.
  3. Change the router's DNS server setting back to the previous setting or the one provided by the ISP - otherwise you cannot open most web pages anymore.

If you cannot do that, have a look at the other options.

Registration

You can "register" a factory-reset OUYA:

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

Screenshots

An OUYA running in November 2019:

About

This OUYA API server was written by Christian Weiske. The stouyapi code is open source: git.cweiske.de/stouyapi.git (github mirror). It was built with the help of the OUYA store API documentation and uses the OUYA game data repository.

If you want to say "thanks", send a postcard to the address shown at my "about me" page.