WiiOS
A Wii-inspired Home screen for LG webOS TVs, featuring customizable channels, application artwork, background music, sound effects, and remote-control navigation.
- Sideload / dev mode
- Beta
- Low brick risk
- Reversible
This project hasn't been claimed by its maintainer yet, so its details come from the community. Is it yours? Claim it
Before you start
- How hard is it?
- HardUses the command line or developer tools.
- What you need
- Comfort with the command line
- A computer
- Can it break my device?
- Very unlikely to break anything.
- Can I undo it?
- Yes. You can go back to the official software.
Did it work for you?
Did WiiOS v0.3.39 work on your LG OLED C3?
No reports yet for v0.3.39.
One-tap reports from owners. Bricked reports are checked before they count.
Compatibility
Devices: LG OLED C3.
No compatibility information yet.
Getting started
From the project's README ("Installation"):
Download the WiiOS IPK and wiios-installer.pyz from the latest release. Keep both files in the same directory.
The installer provides a full-screen terminal interface with separate screens for device information, firmware compatibility, installation plans, approval, progress, diagnostics, and results.
Requirements
- Python 3.10 or newer on your computer.
- OpenSSH (ssh, ssh-keygen, and ssh-keyscan).
- An LG webOS TV reachable over the local network.
- An authorized Developer Mode or root SSH connection.
- A terminal with curses support for the full-screen TUI.
The standalone .pyz does not require installing Python dependencies. Linux is covered by automated installer tests; macOS and Windows require device-level validation.
Verify the installer
Before connecting to your TV, confirm that the current installer is being executed:
python3 ./wiios-installer.pyz --version
Expected output for the compatibility installer r10.4:
WiiOS Installer 0.3.38-compat-r10.4 (2026-10-28-compat-r10.4)
If this command reports an unknown option or requires a subcommand, replace the old .pyz with the latest release file. You can also run the uniquely named wiios-installer.pyz from the same release without renaming it.
Developer Mode SSH
Follow the official LG Developer Mode setup and configure your authorized SSH credentials.
python3 ./wiios-installer.pyz tui
--host TVIP
--transport developer-mode
--user prisoner
--port 9922
--identity DEVKEY
…
Risk and recovery
- Brick risk
- Low
- Reversible
- Yes
- Requires opening the device
- No
From the project's README ("Updates, recovery, and troubleshooting"):
The installer includes options to update the application, launch WiiOS, inspect compatibility, export diagnostics, reconcile interrupted installations, and restore the original Home when a supported recovery transaction exists.
If an operation is interrupted, use Reconcile Interrupted Installation instead of repeatedly reinstalling the same package. For command-line recovery, use the transaction identifier shown in the diagnostic output:
python3 ./wiios-installer.pyz reconcile
--host TVIP
--transport root-ssh
--user root
--port 22
--transaction TRANSACTIONIDIf the terminal unexpectedly displays an old menu or --version is unavailable, verify the exact installer path and replace the outdated file:
realpath ./wiios-installer.pyz python3 ./wiios-installer.pyz --version
Releases
| Version | Name | Released |
|---|---|---|
| v0.3.39 | WiiOS 0.3.39Latest | 28 October 2026 |
| v0.3.38 | WiiOS 0.3.38 | 28 October 2026 |
| v0.3.32 | WiiOS 0.3.32 | 27 October 2026 |
| v0.3.30 | WiiOS 0.3.30 | 24 October 2026 |
Credits, license and support
- License
- Apache-2.0