A free IPTV player for your own M3U playlists and Xtream accounts, made for the remote.
Website · Setup guide · Support · Privacy
Pleione plays the IPTV service you already have on your LG or Samsung TV: live TV with a program guide and catch-up, movies and series, all laid out for the remote. It runs on LG TVs with webOS 4.0 (2018) and newer, and on Samsung TVs from 2020 (Tizen 5.5) on.
Pleione does not include any channels, playlists, or content. You add a playlist or an account from a provider of your own, and you are responsible for having the right to watch it.
| Home | Live |
|---|---|
![]() |
![]() |
| Guide | Player |
![]() |
![]() |
| Movie detail | Search |
![]() |
![]() |
Live TV
- M3U/M3U8 playlists and Xtream Codes accounts, several at once, one shown at a time
- A program guide (XMLTV) found from your playlist or added by hand, with per-source time correction
- Catch-up for programs that already aired, and pause and rewind where the stream allows it
- A live preview beside the channel list, favorites, Recently Watched, number-key tuning, and reminders that fire even with the app closed
Movies and Series (Xtream accounts)
- Browse by category, sorted by name, date added, rating, or year
- Detail pages with plot, cast, rating, seasons, and episodes
- Continue Watching and a Watchlist; episodes play on into the next one
Search
- One search across channels, guide programs, movies, and series
- Arabic-aware matching that ignores differences in hamza, final letters, diacritics, and digits
Playback
- Streams go straight to the TV's own player, so HDR10, HLG, Dolby Vision®, and Dolby Atmos® pass through (why native)
- HLS, MPEG-TS, and MPEG-DASH, including PlayReady, Widevine, and ClearKey protected streams (details)
- Audio and subtitle tracks, remembered per channel and per title, plus optional online subtitle search
- Automatic recovery from streams that fail to start or stall
Make it yours
- 12 languages, with a fully mirrored layout for Arabic: English, العربية, Deutsch, Español, Français, Italiano, Polski, Português (Brasil), Русский, Türkçe, Українська, and 简体中文
- Interface size from 90% to 130% and text size from 80% to 150%
- Light and dark color themes
- Full D-pad and Magic Remote support
Set up from your phone
- Scan the QR code on the TV, enter the pairing code, and type your account
details or upload an
.m3ufile on your phone instead of the remote. It works on your home network, only while Pleione is open (how it works).
Private
- No account, no analytics, no ads. Your accounts and history stay on the TV, and Pleione talks only to your own providers and the optional services you turn on.
Some things webOS does not allow, or that are out of scope, are listed in unsupported features.
-
LG Content Store — coming soon. Once listed, search for Pleione on your TV.
-
Developer Mode — download the latest
.ipkfrom Releases and install it with the webOS CLI. Full HD (non-4K) LG TVs, mostly 32″ and some 43″ sets, take the_fhdfile instead:npm install -g @webos-tools/cli ares-setup-device --add tv -i "username=prisoner" -i "host=<TV IP>" -i "port=9922" ares-novacom --device tv --getkey # enter the passphrase Developer Mode shows ares-install --device tv ./com.merope.pleione_<version>_all.ipk
A Developer Mode session expires unless you renew it in the Developer Mode app, and the TV then removes sideloaded apps.
-
Homebrew Channel (rooted TVs) — add this repository to Homebrew Channel:
https://raw.githubusercontent.com/ahmedsaed/pleione/pleione/homebrew-repository.json -
Samsung TVs — coming to Samsung's app store, in the US first. Until then, download the latest
_tizen.wgtfrom Releases, switch on the TV's Developer Mode (Apps, then 1 2 3 4 5) with your computer's IP address, and install it withsdbandtizenfrom Tizen Studio:sdb connect <TV IP> tizen install -n Pleione_<version>_tizen.wgt -t <device name from sdb devices>
TVs from 2023 on (Tizen 7+) install only apps signed for that TV: sign the
.wgtwith your own Samsung certificate first (docs/tizen.md). On Samsung, live TV does not pause or rewind yet, and reminders appear only while Pleione is open.
The setup guide walks through every step, adding your first account or playlist, and finding your way around with the remote.
The baseline is the Chromium 53 engine on webOS 4; every later release ships a newer Chromium, so the app is forward-compatible. Features only newer engines support natively get feature-detected fallbacks on older ones.
| webOS version | Released | Chromium engine | Bundled service Node.js | Supported |
|---|---|---|---|---|
| webOS 4.x | 2018–2019 | 53 | 0.12.2 | ✅ (minimum) |
| webOS 5.0 | 2020 | 68 | 8.12.0 | ✅ |
| webOS 6.0 | 2021 | 79 | 8.12.0 | ✅ |
| webOS 22 | 2022 | 87 | 12.21.0 | ✅ |
| webOS 23 | 2023 | 94 | 12.22.2 | ✅ |
| webOS 24 | 2024 | 108 | 16.19.1 | ✅ |
| webOS 25 | 2025 | 120 | 16.20.2 | ✅ |
| webOS 26 | 2026 | 132 | 20.12.2 | ✅ |
webOS 3.x and older are not supported.
The Samsung build targets Tizen 5.5 (2020 models, Chromium 69) and newer,
tested on a 2020 TV. Older Tizen versions meet the same Chromium 53
baseline and may work, but are not tested. What each Samsung TV showed is
in docs/tizen.md.
Pleione is vanilla TypeScript bundled with esbuild, plus a small bundled webOS service for phone setup. You need Node.js 22+, the webOS CLI to package or install on an LG TV, and Docker for the Samsung build's Tizen CLI.
npm install
npm run preview # build and serve at http://localhost:3000
npm test # unit and integration tests
npm run lint # Chromium 53 compatibility gate
npm run test:e2e # Playwright, including a Chromium 53 simulation
npm run xtream:demo # local demo Xtream server (needs ffmpeg)
./build.sh # package the .ipk
./build.sh --install # package, install, and cold-restart on the default TV
TIZEN_TV=<ip> scripts/tizen.sh install # the Samsung build, through DockerThe desktop preview plays through hls.js, mpegts.js, and Shaka; on the TV
everything plays natively. scripts/tv.sh streams logs, evaluates code,
captures screenshots, sends remote keys, and collects a redacted diagnostics
report from a TV in Developer Mode (usage is at the top of
scripts/tv.sh).
Read AGENTS.md for the architecture, conventions, and webOS gotchas, and CONTRIBUTING.md before opening a pull request.
- Native playback vs. hls.js
- Audio track selection
- HLS subtitles
- VOD subtitles
- MPEG-DASH
- Storage and data
- LAN setup service
- Right-to-left layout
- Demo Xtream server
- Unsupported features
Pleione is made by Merope and licensed under Apache-2.0. It started as a fork of webOS IPTV Player by lennylxx; see NOTICE.
Third-party software and artwork keep their own licenses, listed in
THIRD_PARTY_NOTICES.txt. Every build ships
LICENSE, NOTICE, THIRD_PARTY_NOTICES.txt, and licenses/ inside the
package.





