Installation and Sideloading

Installation and Sideloading

Smart TVs do not offer Moonfin in their app stores, so it is installed by sideloading a package you download from Releases.

Which file do I need?

Platform	File	Supported devices
Tizen Regular	Moonfin_Tizen_Regular_*.wgt	Samsung Smart TVs (2017+, square icon)
Tizen Oblong	Moonfin_Tizen_Oblong_*.wgt	Samsung Smart TVs (2017+, oblong icon)
Tizen Legacy	Moonfin_Tizen_Legacy_*.wgt	Samsung Smart TVs (2016, Tizen 2.4)
webOS	Moonfin_webOS_*.ipk	LG Smart TVs (2016+, webOS 3.0+)

Regular and Oblong differ only in the shape of the launcher icon, so pick whichever matches how your TV draws app tiles. Legacy exists for Tizen 2.4 sets and does not include Smart Hub Preview.

Samsung (Tizen)

The easiest route is the Apps2Samsung tool, which handles the packaging and install for you.

1. Download Apps2Samsung by @PatrickSt1991.
2. Enable Developer Mode on your TV:
   • Go to Settings, General, System Manager, Developer Mode.
   • Turn Developer Mode on.
   • Enter your PC's IP address.
   • Restart the TV.
3. Run the tool, select the Moonfin .wgt file, enter your TV's IP address, and install.

LG (webOS)

1. Enable Developer Mode on your TV through the LG Developer portal.
2. Install the webOS CLI tools: npm install -g @webos-tools/cli
3. Register your TV as a device: ares-setup-device
4. Install the package: ares-install --device <your-tv> moonfin.ipk

Notes

• Developer Mode on both platforms expires after a period of time and needs to be re-enabled, which does not remove installed apps but can block new installs until you renew it.
• Packaged apps bypass the browser CORS restrictions that affect running the app from a plain web server.
• To update Moonfin, install the newer package the same way. There is no in-app updater.