webOS (LG TV)

Install the native Pelagica app on an LG Smart TV.

Pelagica is also available as a native app for LG Smart TVs running webOS. Since LG doesn’t allow sideloading apps directly, installing it requires enabling the TV’s Developer Mode, then installing the .ipk with either a GUI app or the command-line tools.

Requirements

  • An LG Smart TV with Developer Mode enabled (see below).
  • A Windows, macOS, or Linux computer on the same network as the TV.

1. Enable Developer Mode on your TV

  1. On your TV, open the LG Content Store and install the Developer Mode app.
  2. Open the Developer Mode app and sign in with an LG account (create one for free if needed).
  3. Toggle Developer Mode on and restart the TV when asked.
  4. After the restart, reopen the Developer Mode app. It displays the TV’s IP address and a passphrase, which you’ll need in the next step.

NOTE

Developer Mode sessions expire after a while and need to be re-enabled from the same app if the TV stops accepting installs.

2. Install the app

Pick whichever of the two options below suits you. Both end with Pelagica installed on the TV.

Option A: webOS Dev Manager (GUI)

webOS Dev Manager is a free community GUI app that connects to the TV over the network and lets you install .ipk files by dragging and dropping them, no command line needed.

  1. Download pelagica-webos.ipk from the Releases page.
  2. Download and install webOS Dev Manager for your platform from its Releases page.
  3. Open webOS Dev Manager and click New Device, then enter the TV’s IP address and the passphrase from the Developer Mode app.
  4. Once connected, drag pelagica-webos.ipk onto the app window (or use its Install button) to install it.

Once installation finishes, Pelagica will appear alongside your other apps on the TV’s home screen.

Option B: webOS TV CLI (command line)

If you’d rather script the install or already have Node.js set up, use LG’s official CLI instead.

  1. Install the CLI:

    npm install -g @webos-tools/cli

  2. Register the TV as an install target, using the IP address and passphrase from the Developer Mode app:

    ares-setup-device -a pelagica-tv -i "host=<TV_IP>" -i "port=9922" -i "username=prisoner" -i "passphrase=<PASSPHRASE>" -i "default=true"
ares-novacom --device pelagica-tv --getkey

  3. Download pelagica-webos.ipk from the Releases page, then install and launch it:

    ares-install -d pelagica-tv pelagica-webos.ipk
ares-launch app.pelagica.pelagica -d pelagica-tv

NOTE

Like the desktop app, the webOS app connects to a Jellyfin server the same way the web app does. It doesn’t need a self-hosted Pelagica instance.