# plx-native (plxnative/plx-native)

> PlxNative is a fast, unofficial Plex client built specifically for LG webOS TVs. It draws its interface directly on the GPU at 60 fps and hands video off to the TV's own hardware decoder, instead of running as a web app inside the TV's Chromium browser like the official Plex client.

- GitHub: https://github.com/plxnative/plx-native
- GitHub.Locker page: https://github.locker/plxnative/plx-native
- Stars: 1.3K
- Language: Rust
- License: GPL-3.0
- Last push: 2026-11-18

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**How do I get it installed on my TV?**

Enable LG Developer Mode on the TV and connect with webOS Dev Manager from a computer, then either install PlxNative directly (future .ipk updates come from your computer) or install Homebrew Channel first so updates come from the remote. If you already have Homebrew Channel, you can just find PlxNative in its catalogue.

**Do I need to root my TV first?**

No. A regular TV in Developer Mode runs everything, with one exception: a repair for a specific sandbox bug on some 2019 LG k5lp/k3lp-chip sets only works if the TV has Homebrew Channel (root) installed.

**Will it work on any LG webOS TV?**

It needs webOS 4.0 or newer; a 2016 set on webOS 3.4.3 works via Developer Mode but with slower seeking, and anything older than 3.4 is untested. Some 2019 sets with LG's k5lp/k3lp chip can't play video at all through Developer Mode due to a sandbox limitation Kodi and Moonlight also hit.

**Where does my viewing and library data go?**

PlxNative only talks to your Plex server, to plex.tv for sign-in, and to discover.provider.plex.tv for cast bios — your library data never reaches the developer. Crash reports and usage analytics are off by default, each a separate opt-in that can be reversed later, and no title, search term, or server address can appear in them.

**Does it support 4K and Dolby Vision?**

Yes — it can direct play H.264 and HEVC including 4K, 10-bit, and Dolby Vision profiles 5 and 8 with E-AC-3 Atmos when the TV's codec table supports it. Anything else falls back to the server transcoding, and playback can be switched to Auto to follow a link whose speed changes.

**What's the difference between nightly builds and release candidates?**

Nightlies are CI builds cut daily from the main branch and install side-by-side as a separate 'PlxNative Nightly' app that auto-deletes 30 days after publishing. Release candidates are full release builds that install as the regular PlxNative app itself, replacing your current version ahead of the final release.

**Can I use it for music or photos too?**

No — the scope is intentionally narrow to movies and TV shows only, with no support for music, photos, or live TV/DVR.

**Why build a whole new client instead of improving the official Plex app?**

The official LG Plex app is really a web app running in the TV's Chromium browser, so scrolling and navigation hit a performance ceiling that patching can't fix. PlxNative throws out the browser entirely and draws straight on the GPU while handing video to the TV's native decoder.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/plxnative/plx-native/blob/main/README.md

# PlxNative

A fast, unofficial [Plex](https://www.plex.tv/) client for LG webOS televisions. Native, not a web
page — the interface is drawn straight on the GPU at 60 fps, and video plays on the TV's own decoder.

**Website: [plxnative.com](https://plxnative.com/)** · [Install guide](https://plxnative.com/install/) ·
[Troubleshooting](https://plxnative.com/troubleshooting/)

<a href="https://trendshift.io/repositories/244171?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-244171" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/244171" alt="plxnative/plx-native | Trendshift" width="250" height="55"/></a>

*In daily use on a 2019 LG set. PlxNative is an independent project and is not affiliated with Plex, Inc.
or LG. The same install steps are in the repo: [installation guide](docs/install-and-verify.md).*

## Why this exists

The official Plex app on my old LG is slow. Scrolling a shelf stutters, opening a poster takes a
beat too long. It behaves like a web page because it is one: a web app running in the television's
Chromium. Patching it doesn't help — the ceiling isn't the code, it's the browser.

So I threw the browser away.

PlxNative draws straight on the GPU and hands video to the same silicon the built-in apps use. No
Chromium, no JavaScript, no web view. It just draws. Almost all of it is Rust, and I use it every
day to watch things off my server in the next room.

## What it looks like

Real captures of the app, not mockups: the same code that runs on the television, on the desktop
simulator, browsing a demo library of openly licensed films
([credits](docs/screenshots/CREDITS.md)). `make screenshots` regenerates them.

![Home](docs/screenshots/home.jpg)

**Home** — a rotating hero from what you're partway through and what's just landed, shelves under it.

![Library](docs/screenshots/library.jpg)

**Library** — a library opens on its full poster grid, with an A–Z rail down the side and one
header row for sort & filter (including unwatched-only), a Collections page and a Recommended
page. The shelves live on Recommended: what you're partway through, with the time left under
the focused card, and what just landed
([pictured here](docs/screenshots/ux-library-grid.jpg)).
Settings → Libraries → Under posters also has a **Sort value** switch (on by default, per
profile). In a movie or TV show library sorted by something other than Title or Random (its movies, shows, seasons or
episodes), every card shows the value it is sorted by on one line under it (a score, a length, a date as Today,
Yesterday, 27 Oct or Oct 2024), in place of the title and details line; a sort with no value to show, such as
the Show order of Seasons and Episodes, keeps the usual captions. It uses the existing sort menu; other poster
surfaces keep their usual captions.

![Search](docs/screenshots/search.jpg)

**Search** — one query across every server you can reach, results grouped by kind.

![Player](docs/screenshots/player.jpg)

**Player** — the transport with chapters and track menus, drawn over video the television decodes
itself. (In this capture the frame under it was decoded by the simulator.)

## What it does

- **An interface that keeps up with the remote.** 60 fps on the 2019 set I develop on, with
  frame-rate regression scenes that measure it on the television rather than trusting it.
- **Sign in on the TV** with an on-screen QR code and pick a Plex Home profile.
- **Browse and search your libraries** — on your own servers and on ones shared with you. Your
  servers' libraries, that is, plus the plex.tv Watchlist as its own tab, where any title can be added or
  removed; search covers servers only.
- **Direct play** H.264 and HEVC — 4K, 10-bit, Dolby Vision profiles 5 and 8, E-AC-3 Atmos, and AV1 or VP9 (10-bit VP9 only on webOS 4 sets)
  on televisions whose codec table lists that decoder — decided against your television's own
  codec table where it publishes one. Anything else the server transcodes, and you can switch a
  playback to Auto to follow a link whose speed changes.
- **Everything you expect while watching**: resume, seek and scrub, chapters, audio and subtitle
  tracks (including image subtitles), Skip Intro, Skip Credits, Up Next with auto-advance, and
  progress reported back to your server.

## Will it work on my television?

**It needs webOS 4.0 or newer**, with two tested exceptions: a 2016 set on **webOS 3.4.3** signs
in, browses, searches and plays (direct play, transcodes, subtitles and seeking) through Developer
Mode, and a 2018 set on **webOS 3.9.3** plays direct play the same way when built from source at
or after [`60f99c7`](https://github.com/plxnative/plx-native/commit/60f99c7) — the catalogue's
prebuilt v0.8.0 predates that fix (see [Known issues](#known-issues)). Other 3.x releases are
untested, and anything older than 3.4 is unknown. Past that, it most
likely will. I develop and test on a 2019 set, and opt-in usage reports show
video playing on sets from 2018 through the newest, on webOS 11 — both direct play and server
transcodes, Developer Mode installs included.

Owners' reports, set by set, are in the [compatibility list](docs/compatibility.md).

### Known issues

| Where | What happens |
|---|---|
| **Some 2019 sets on LG's k5lp or k3lp chip**, installed through Developer Mode | Video won't play. On these sets LG's Developer Mode sandbox can withhold a device the video path needs — Kodi and Moonlight hit the same wall. The app checks for it and says so instead of crashing; other sets on the same chip play normally. On a rooted TV with Homebrew Channel, the failure screen offers **Repair**, which applies the Homebrew Channel fix to the sandbox (one owner fixed it this way from a root shell; the button itself hasn't been run on an affected set yet). Without root there is no fix. |
| **2018 sets on firmware that reports platform release 3.9.3** | Sign-in and browsing work. The prebuilt **v0.8.0** holds a strong ELF reference to the cxx11 `StarfishMediaAPIs::Feed` symbol, which 3.x `libplayerAPIs` does not export, so on the prebuilt video never starts and no error is reported: [#249](https://github.com/plxnative/plx-native/issues/249). A source build at or after [`60f99c7`](https://github.com/plxnative/plx-native/commit/60f99c7) resolves Feed with a dual-ABI `dlsym` and plays direct play on a 2018 C7 (W17H chassis, 3.9.3). |
| **webOS 3.x** | Seeking jumps in place through LG's public `Seek`, as on webOS 5 and newer (tested on platform release 3.9.3 only). The in-place path webOS 4 uses depends on the internal layout of LG's 4.x media player, which differs on 3.x, so it is not used there. A set that refuses `Seek` falls back to restarting the stream at the new position, as all 3.x sets did before. Menus can drop frames at 1920x1080 on these sets; **Settings → System → Interface resolution** trades sharper text for smoother menus. |
| **Sets on LG's k6hp chip** | A crash seen in opt-in crash reports and not reproduced here, because I have no such set: [#174](https://github.com/plxnative/plx-native/issues/174). |

### Rooted or not

**No root is needed.** A regular TV in Developer Mode runs everything except the k5lp/k3lp Repair
above. What Developer Mode costs you is renewal: if the session lapses, LG removes the apps
installed through it ([how to keep them](docs/install-and-verify.md#important-developer-mode-expires)).
A rooted TV with Homebrew Channel has no expiry.

If something goes wrong, check [Troubleshooting](docs/troubleshooting.md) first, then
[tell me what happened](https://github.com/plxnative/plx-native/issues/new/choose) — and if you own one of the
sets above, it working is as useful a report as it failing: post it under
[Discussions > Compatibility](https://github.com/plxnative/plx-native/discussions/categories/compatibility).

## Installing

**First time installing an app outside the LG Content Store?** Follow the
[**step-by-step installation guide**](docs/install-and-verify.md). It starts with a regular LG
webOS TV, a computer on the same network, and a Plex account with access to your own or a shared
server. **No root is required.**

Set up LG Developer Mode and connect with webOS Dev Manager, then choose:

- **Install PlxNative directly:** add only PlxNative to the TV; install future `.ipk` updates from
  your computer.
- **Install Homebrew Channel first:** get an app catalogue on the TV, then install PlxNative and
  its updates with the remote.

**Already have Homebrew Channel?** Find [PlxNative in its catalogue](https://repo.webosbrew.org/apps/com.beb.plxnative/)
and select **Install**. Skip the computer setup.

**Developer Mode needs periodic renewal.** If it expires and LG disables Developer Mode, apps
installed through it are removed. Installing Homebrew Channel through Developer Mode does not
remove that requirement. The guide explains [how to renew the session](docs/install-and-verify.md#important-developer-mode-expires).

For manual `.ipk` downloads, [verify the release checksum](docs/install-and-verify.md#verifying-the-package)
before installing. Homebrew Channel verifies catalogue downloads for you.

## Also for LG webOS

Want a cleaner home screen for your LG TV? [**Clean Your TV**](https://github.com/Razdva122/clean-your-tv-lg-webos),
a separate project by another developer, lets you rearrange your apps, customize the dock and pick a
theme. The launcher has no sponsored rows, and on a regular TV it installs through LG Developer Mode.

[Explore Clean Your TV →](https://github.com/Razdva122/clean-your-tv-lg-webos)

## Nightly builds

Every day `main` moves, CI cuts a nightly `.ipk` from wherever it stands. It installs beside the
regular app as **"PlxNative Nightly"** — its own tile, its own sign-in — so trying it never touches
the release you already trust.

**With Homebrew Channel:** under Settings choose **Add repository**, enter
`https://plxnative.com/nightly/repo.json`, then install PlxNative Nightly. Every later nightly
appears there as an update. The [nightly builds guide](docs/nightly-builds.md) has the steps, how
the versions work and what to do if something goes wrong.

**Without it:** each build is a release of
[plxnative/plx-native-nightly](https://github.com/plxnative/plx-native-nightly/releases), and the
newest is always linked from
[plxnative.com/nightly/latest.json](https://plxnative.com/nightly/latest.json). Install
it with Dev Manager; a package installed that way does not update itself.

**It is not tested on a television.** It passes the same automated build and packaging checks a
release does, but nobody has watched it play. Each nightly is deleted 30 days after it is
published, so link to a specific `.ipk` at your own risk.

## Release candidates

Before a release, CI may publish a release candidate as a
[prerelease](https://github.com/plxnative/plx-native/releases?q=rc) named like `PlxNative 0.8.0-rc.1`.
It is the release build itself, so it **installs as the regular PlxNative app**, replacing the one
you have the way an update would. It is not in the Homebrew Channel, and the Channel will not offer
the final release over it either: reinstall the final by hand once it is out.

## Privacy

**Your library data never reaches me.** The app talks to your Plex server, to `plex.tv` to sign in,
and to `discover.provider.plex.tv` for cast biographies, for the Watchlist (reading it, and adding or
removing a title when you ask, with the active profile's plex.tv token) and for the cover artwork of
each title in Continue Watching (which tells Plex which titles are in that row for the profile in use).

**Crash reports and usage analytics are off until you turn them on** — two separate first-run
questions, each answerable with Don't Share, both reversible later under Account → Settings →
Privacy & data. No title, search term, subtitle line, server name or address can appear in any
report. [`PRIVACY.md`](PRIVACY.md) is the whole statement, including the schemas.

ASS/SSA subtitles render natively during direct play, including styles, positioning, overlapping
signs and dialogue, karaoke, and embedded fonts. External ASS files retain their original scripts.
A re-encode still burns the selected subtitle on the server; over a remux the app draws a sidecar, and an embedded track when the link is local and the Part is 1..=30000 kbps, and otherwise the server burns it.

## The honest scope

I built this for how *I* watch, so it's narrower than Plex's:

- **Movies and TV shows.** No music, no photos, no live TV or DVR.
- **No typing in server addresses.** Servers come from your Plex account; set them up on a phone or
  PC and choose from what's there. Servers reached through Plex's relay, or that require an
  encrypted connection, are supported but haven't been watched end to end.
- **One person's spare time.** There will be bugs I haven't hit, because I don't watch the way you do.

If that fits, it's genuinely nice to use. If it doesn't, the official app will serve you better.

## Contributing

Issues and pull requests are welcome, especially from anyone whose television or library differs
from mine — [**docs/building.md**](docs/building.md) is the build and the test loop, and says what
hardware I most need help with. Feature ideas go to [Discussions >
Ideas](https://github.com/plxnative/plx-native/discussions/categories/ideas). Security issues go
through [`SECURITY.md`](SECURITY.md) rather than a public issue.

## Acknowledgements

Error monitoring for PlxNative is sponsored by [Sentry](https://sentry.io/for/good/).

<a href="https://sentry.io/for/good/">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/sentry-wordmark-light.svg">
    <source media="(prefers-color-scheme: light)" srcset="docs/assets/sentry-wordmark-dark.svg">
    <img alt="Sentry" src="docs/assets/sentry-wordmark-dark.svg" width="160">
  </picture>
</a>

## Licence

[GPL-3.0-or-later](LICENSE), © 2026 Gleb Linnik. The PlxNative name and its brand artwork are excluded — see
[`TRADEMARKS.md`](TRADEMARKS.md), which also carries the Plex and LG non-affiliation statements.
Third-party components and their licences are in
[`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md) and `licenses/` — notably the app ships its own
LGPL build of FFmpeg. Those notices and licence texts ship inside the `.ipk` too, so they travel
with the binary and not only with this repository.

This is an unofficial client, not affiliated with, endorsed by, or sponsored by Plex GmbH or LG
Electronics. "Plex", "Rotten Tomatoes", "IMDb", "TMDB", "LG" and "webOS" are trademarks of their
respective owners; where they appear in the app, they identify whose service or score is being shown.

## Star history

<a href="https://www.star-history.com/?repos=plxnative%2Fplx-native&type=date&legend=bottom-right">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=plxnative/plx-native&type=date&theme=dark&legend=bottom-right">
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=plxnative/plx-native&type=date&legend=bottom-right">
    <img alt="Star history chart" src="https://api.star-history.com/chart?repos=plxnative/plx-native&type=date&legend=bottom-right">
  </picture>
</a>

