Releases: ItzSwirlz/Ristretto
1.1
Breaking Changes
- The
/title/list
endpoint no longer returns titles in the MCP_APP_TYPE_ACCOUNT_SETTINGS app type. (9b66cd8) This is because these titles fail to launch or throw an error preventing it from launching (like Account Settings) and it also contains the System Transfer title, which should not be exposed anyways.- HomeKit/homebridge-wiiu Users should refresh and update their title lists to ensure they don't have extra inputs that may launch a completely different title due to an ID offset.
New Features
-
Endpoint for retrieving the GamePad battery level (b348179)
- Note: The values returned are 0 if charging, and 1-6 otherwise. Currently there is no other way to retrieve an actual accurate value.
-
Endpoint for getting the hardware version from the BSP (472461b)
- Note: These values are returned as decimal format, but they do correspond to specific meanings. See the wut documentation for the value identifiers.
-
Individual endpoints for launching titles/applications that have functions for them.
-
Endpoint for opening the Home Button Menu (7ae959f)
- Be careful with this, as currently it can only open the HBM but not get out of it.
-
Endpoint for launching vWii Menu and Data Management (81a69fb)
- Note: Just like Wii VC titles, Ristretto will not be active when in vWii mode. This includes for these titles.
-
Endpoint for getting the title ID in the ODD (c6c69e9)
- Note: Only returns title IDs for Wii U games. This only displays "0" for a Wii game, just like it would for no disc in the drive. However this can still be used for a sensor.
-
The Notification Module is now used. You will need to have the Notification Module installed for Ristretto to function. It is currently used for two purposes:
-
Titles sent from Ristretto (such as in the title list) can now use a configured language (b0665f3)
Bug Fixes
- Switching to the electronic manual of a title now only will do so if there is a manual (d242773).
- When there's no manual, Cafe OS falls back to the "Disc cannot be read" screen.
- If trying to launch a title that does not exist, Ristretto will refuse to launch it. (part of facf776)
Full Changelog: 1.0...1.1
1.0 - The Initial Release
This is the start of probably a really dumb but creative project that I hope will help take the Wii U to the level that Nintendo couldn't reach. The Wii U was definitely made with the design or thought of being used for home automation like the other consoles of its generation. That is what Ristretto is - an Aroma plugin to facilitate just that via an HTTP server.
I chose the name "Ristretto" since it is a "short shot of Espresso", Espresso being the Wii U CPU. So in a way, we are taking a short sip of what the Wii U has to offer and exploring it.
Currently, it supports:
- Powering off
- Reboot
- Switching/launching system titles and applications (not Homebrew yet)
With this you can use something like homebridge-wiiu for Homebridge users or ha-wiiu for Home Assistant users*
The server runs on the Wii U's IP address which you can find via ftpiiu and it runs on port :8572. Hook up Homebridge or Home Assistant and you should be good to go!
- You will need to install HACS and clone manually, as of writing the HA integration is still a heavy WIP
Currently Ristretto is licensed under BSD because I forgot to switch it to GPL v3.0+ but I might just leave it as is.
Big thanks to Maschell, TraceEntertains, and DanielKO for their help with this. I seriously could not do this without them.