Skip to content
ahmedsaedPublic

About

An IPTV player for LG and Samsung TVs

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

806 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pleione icon

Pleione

A free IPTV player for your own M3U playlists and Xtream accounts, made for the remote.

webOS 4+ Tizen 5.5+ Latest release GitHub downloads Apache-2.0

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
Home Live
Guide Player
Guide Player
Movie detail Search
Movie detail Search

Highlights

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 .m3u file 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.

Install

  • LG Content Store — coming soon. Once listed, search for Pleione on your TV.

  • Developer Mode — download the latest .ipk from Releases and install it with the webOS CLI. Full HD (non-4K) LG TVs, mostly 32″ and some 43″ sets, take the _fhd file 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.wgt from Releases, switch on the TV's Developer Mode (Apps, then 1 2 3 4 5) with your computer's IP address, and install it with sdb and tizen from 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 .wgt with 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.

Supported TVs

Supported webOS versions

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.

Supported Samsung TVs

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.

Development

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 Docker

The 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.

Docs

Credits and license

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.

About

An IPTV player for LG and Samsung TVs

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages