stremiok 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+What changed in each version of StremioK, newest first. How everything works is in the
+[user guide](docs/USER-GUIDE.md).
+
+## 2.2.0 — 2026-10-23
+- **A TV guide for your IPTV channels:** what's on now and next on each channel's card, in
+  Home's details strip and while a channel plays, and its schedule when you hold OK on it. From
+  the guide a playlist names, an Xtream account's own, or a *Guide link* you set (Settings ›
+  Content › IPTV).
+- **A Guide tab:** your channels as a grid across 2½ hours that follows the clock; OK on what's
+  on now plays it, and CH+ / CH− then go through the Guide's channels. The remote's GUIDE key
+  opens it.
+- **Guide-only channels** (`tvg-type="guide"`): a channel you watch elsewhere (a cable box, say)
+  on the Guide tab with its schedule; OK on a film finds it in your addons.
+- **Xtream accounts:** add one with its server, username and password (checked with the server
+  first). Its channels play as MPEG-TS; *Format* switches the account to HLS, or one channel
+  while it plays (the player's menu), kept for that channel.
+- **★ Favorite channels:** hold OK on a channel card, *Add to favorites*: a row of their own,
+  first on the IPTV and Guide tabs.
+- **Closed captions on live channels:** captions inside an HLS channel's picture (CC1–CC4, the
+  kind VLC shows) are offered in the subtitle menu, and turn into subtitles when you pick them.
+  On an Xtream channel, switch *Format* to HLS for them.
+- **In the player:** picture mode kept per channel; *Reload* and a *Sleep timer* in the menu;
+  the time of day at the top right.
+- **More channels play:** more ways a playlist gives a channel's User-Agent and Referer, Xtream
+  channels that lead to YouTube, and channel logos from the TV guide.
+- **Put the top menu in your own order:** Settings › Appearance › *Menu*.
+- **The IPTV tab has live TV only:** a catalog of films or series sits on Movies or Series.
+- **Fixes:** USB downloads checked part by part; a broken subtitle file or TV guide can't hold
+  the remote; a first playlist shows the IPTV tab at once.
+
+## 2.1.0 — 2026-10-20
+- **Live channels reconnect** when their connection drops, as often as *Reconnect live channels*
+  says (Settings › Playback › Seeking & buffering): Off, A few times or Keep trying.
+- **Trakt:** your whole watched history is read again (Trakt now sends it a page at a time, and
+  shows without their episodes unless asked), and an episode you left part-way no longer hides
+  the show's next one once you've watched past it, on any device.
+- **Addons:** turn one off or on, as you can a playlist, each shown with its logo (Settings ›
+  Content › Addons); "No sources found" says why, addon by addon; an addon's error page is no
+  longer shown as a title.
+- **A YouTube tab on Home:** StremioK's YouTube began as a way to watch TV channels that stream
+  on YouTube rather than through an M3U playlist, so its catalogs sat in the IPTV tab. Now that
+  it also covers channels, playlists, searches and other addons' YouTube catalogs, it has a tab
+  of its own, between Sports and Local.
+- **Reordering:** ⇈ / ⇊, beside ▲ / ▼, move an item straight to the top or bottom of any list you
+  put in order: addons, playlists, YouTube catalogs, Home feeds, Search results and source
+  ranking.
+- **Playback:** a source counts as started only once it plays, so one that fails right after
+  opening gives way to the next; video quality for streams that need their own headers; skip
+  times from TheIntroDB's new API.
+- **A faster start:** your addons don't wait for the IPTV playlists, and Home's rows appear as
+  each is ready.
+- **Security and privacy fixes:** USB drives and downloads; the TV itself off-limits to
+  downloads and live relays; AIOManager's key kept to its own server, and addons you added
+  yourself left alone by its sync.
+
+## 2.0.0 — 2026-10-17
+The first public version of StremioK, a Stremio-addon client for Samsung Tizen TVs (Tizen 3.0
+and later). What it does is in the [README](README.md#highlights); installing it, in the
+[installation guide](docs/INSTALL.md).
+
+- **Your addons:** catalogs, title details, sources and subtitles from the Stremio addons you add
+  by link, or import from your Stremio account, AIOManager or a configuration file.
+- **Finding something to watch:** Home with Watching, Calendar, Movies, Series, IPTV, Radio,
+  Sports and Local tabs; Discover; Search across every addon that can search, and people by
+  name.
+- **Title pages:** ranked sources with ▶ Play best, filters by addon and resolution, trailers,
+  ratings, Cast & more, collections, episode pages and an episode ratings grid.
+- **Playing:** resume, skip intros, recaps and credits, the next episode on its own, the next
+  source when one doesn't start, subtitles from addons, the file, YouTube and your USB drive,
+  with timing and sync by ear, audio tracks remembered, private viewing.
+- **Trakt:** watched marks and viewing progress sync with Trakt; Up next and watchlist rows
+  are read from your account.
+- **IPTV and radio** from your M3U playlists; **YouTube** channels, playlists, searches and live
+  streams, with SponsorBlock, DeArrow, chapters and captions; **a USB drive's** videos matched
+  to their titles, and downloads to it.
+- **Documentation** for every reader: the [user guide](docs/USER-GUIDE.md), a
+  [settings reference](docs/SETTINGS.md), [troubleshooting](docs/TROUBLESHOOTING.md),
+  [privacy and data](docs/PRIVACY.md), a [technical reference](docs/TECHNICAL-REFERENCE.md)
+  and the [developer guide](docs/DEVELOPER-GUIDE.md). Settings' on-screen hints say the effect
+  in a sentence or two.

package/README.md

@@ -22,7 +22,7 @@ video through Samsung's AVPlay API.
 - **Your addons:** catalogs, details, sources and subtitles from the Stremio addons you add
   (Cinemeta and OpenSubtitles to start with), in the order you choose.
 - **Home** with Watching (Continue Watching, synced with **Trakt** if you connect it), Movies,
-  Series, IPTV, Radio, Sports and Local tabs; **Discover** to browse any catalog in full;
+  Series, IPTV, Guide, Radio, Sports, YouTube and Local tabs; **Discover** to browse any catalog in full;
   **Search** across every addon that can search, and people by name.
 - **Title pages:** ranked sources with **▶ Play best**, trailers, ratings (IMDb, Rotten
   Tomatoes, Metacritic… with your own API keys), seasons and episodes with their own pages,
@@ -30,7 +30,7 @@ video through Samsung's AVPlay API.
 - **The player:** resume where you stopped, skip intros, recaps and credits, next episode,
   subtitles (addons', the file's own, and your own files on a USB drive) with your choice of look, audio
   tracks remembered, switching source mid-playback, private viewing.
-- **IPTV and radio** from your M3U playlists, with CH+ / CH−.
+- **IPTV and radio** from your M3U playlists and Xtream accounts, with CH+ / CH−.
 - **YouTube:** live channels, trailers, and your own YouTube channels, playlists and searches,
   with SponsorBlock, DeArrow, chapters and captions.
 - **Local:** the videos on a USB drive, matched to their titles.
@@ -55,7 +55,8 @@ Three ways, all covered step by step in the **[installation guide](docs/INSTALL.
 2. **API keys**, optional: your own TMDB, OMDb and MDBList keys add ratings, *Cast & more*,
    *where to watch* and episode trailers.
 3. **Trakt**, optional: connect your account to share watched marks and Continue Watching.
-4. **IPTV**, optional: your M3U playlist links.
+4. **IPTV**, optional: your M3U playlist links, or an Xtream account (its server, username and
+   password).
 5. **A USB drive**, optional: plug it in and the Local tab appears.
 
 [Getting started](docs/USER-GUIDE.md#getting-started) in the user guide walks through each.
@@ -73,17 +74,16 @@ a direct HTTP(S)/HLS/DASH URL, and this app embeds no torrent or debrid engine.
 > shows that notice on it); its results are rent/buy/subscription *links to external
 > services*, not video URLs. Add stream addons that return HTTP/HLS URLs for actual playback.
 
-The **IPTV** feature likewise hosts no content: you supply your own M3U playlist URLs. For
-YouTube entries, the bundled service finds the video's stream; the video itself comes
-straight from YouTube. No video or audio is kept: everything plays straight from its source,
-unless you download it to your own USB drive. What StremioK does keep, on the TV, is your
-progress, settings and copies that let it start faster (see
+The **IPTV** feature likewise hosts no content: you supply your own M3U playlist URLs or Xtream
+accounts. For YouTube entries, the bundled service finds the video's stream; the video itself
+comes straight from YouTube. No video or audio is kept: everything plays straight from its
+source, unless you download it to your own USB drive. What StremioK does keep, on the TV, is
+your progress, settings and copies that let it start faster (see
 [Privacy and data](docs/PRIVACY.md#what-stays-on-the-tv)).
 
 ## Known limitations
 
 - AVPlay behavior varies by TV generation, codec and HLS provider.
-- No TV guide (now / next) for IPTV channels yet.
 - No torrent playback: sources need a direct HTTP(S)/HLS/DASH URL (e.g. through a debrid
   addon).
 - Home rows show a catalog's first page (up to 30 titles); Discover pages through the rest.

package/config.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <widget xmlns="http://www.w3.org/ns/widgets" xmlns:tizen="http://tizen.org/ns/widgets"
-        id="http://stremiok.tizen/StremioKTizen" version="2.1.0" viewmodes="maximized">
+        id="http://stremiok.tizen/StremioKTizen" version="2.2.0" viewmodes="maximized">
     <tizen:application id="StremioK01.StremioK" package="StremioK01" required_version="3.0"/>
     <content src="index.html"/>
     <feature name="http://tizen.org/feature/screen.size.all"/>

package/css/style.css

@@ -513,3 +513,30 @@ html, body {
 .src-s { background: #7b5bf5; }
 .src-a { background: #0f9f8f; }
 .src-c { background: #6b7280; }
+/* an IPTV channel card: what's on now (its TV guide), and how far along it is, along its top (its name is at the bottom) */
+.card-epg { position: absolute; left: 0; right: 0; top: 0; padding: 5px 8px 4px; background: rgba(10, 12, 18, 0.82); }
+.card-epg-t { font-size: 15px; color: #e6e9ef; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.card-epg-bar { height: 3px; margin-top: 3px; background: rgba(255, 255, 255, 0.18); border-radius: 2px; overflow: hidden; }
+.card-epg-fill { display: block; height: 100%; background: #818cf8; }
+/* the Guide tab (js/view-guide.js): the hours along the top, then a row a channel; programs
+   placed by their time (left / width in %), what's on now lighter, a line at the time now */
+.guide { padding: 0 60px 20px 60px; }   /* (the same sides as Home's rows: .row-title, .row-scroller) */
+.guide-head { display: flex; height: 34px; }
+.guide-corner { width: 230px; flex: none; font-size: 17px; color: #8b93a5; line-height: 34px; }
+.guide-hours { position: relative; flex: 1; }
+.guide-time { position: absolute; top: 0; font-size: 17px; color: #aeb6c4; line-height: 34px; padding-left: 6px; border-left: 2px solid #2a3346; }
+.guide-row { display: flex; height: 62px; margin-bottom: 6px; }
+.guide-ch { width: 230px; flex: none; padding: 0 12px; font-size: 19px; font-weight: bold; line-height: 62px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; background: #121722; border-radius: 8px 0 0 8px; }
+.guide-track { position: relative; flex: 1; overflow: hidden; background: #0e1219; }
+.guide-prog { position: absolute; top: 0; bottom: 0; padding: 0 10px; font-size: 18px; line-height: 56px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; background: #161b26; border: 3px solid #0e1117; border-radius: 6px; color: #c7cbd4; }
+.guide-prog.now { background: #222b3d; color: #fff; }
+.guide-prog.guide-wait { color: #8b93a5; font-style: italic; }   /* (a row whose programs are still being read) */
+.guide-prog.focusable.focused { background: #818cf8; color: #0e1117; border-color: #fff; }
+.guide-nowline { position: absolute; top: 0; bottom: 0; width: 2px; margin-left: -1px; background: #f87171; }
+.guide-ch-logo { height: 34px; max-width: 56px; margin-right: 10px; vertical-align: middle; object-fit: contain; }
+/* a program's picture (the TV guide), at the strip's right; its text kept clear of it */
+.home-info-pic { position: absolute; right: 16px; top: 50%; height: 118px; width: 210px; margin-top: -59px; object-fit: cover; border-radius: 8px; }
+.home-info.has-pic { padding-right: 240px; }
+.home-info-pic.hidden { display: none; }
+#osd-clock { position: fixed; top: 40px; right: 60px; font-size: 34px; font-weight: bold; color: #fff; text-shadow: 0 2px 8px rgba(0,0,0,0.9); }   /* (the time of day, top right, while the bar shows) */
+#osd-clock:empty { display: none; }

package/index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=1920, height=1080, user-scalable=no">
     <title>StremioK</title>
-    <link rel="stylesheet" href="css/style.css?v=2.1.0">
+    <link rel="stylesheet" href="css/style.css?v=2.2.0">
 </head>
 <body>
     <!-- CSS-applied sentinel (kept off-screen); app.js waits for its width before rendering -->
@@ -32,6 +32,7 @@
         <div id="osd-chapter" class="hidden"></div>
         <div id="osd-bar"><div id="osd-progress"></div><div id="osd-sponsor"></div><div id="osd-chapters"></div><div id="osd-buffer"></div><div id="osd-scrub-range" class="hidden"></div><div id="osd-scrub" class="hidden"><div id="osd-scrub-time"></div></div></div>
         <div id="osd-times"><span id="osd-cur">00:00</span><span class="osd-right"><span id="osd-tags"></span><span id="osd-dur">00:00</span></span></div>
+        <div id="osd-clock"></div>
         <div id="osd-hint">OK: Play/Pause &nbsp; &larr;/&rarr;: Seek &nbsp; RETURN: Back</div>
     </div>
 
@@ -52,35 +53,37 @@
 
     <!-- Load order matters: polyfills -> util -> iptv -> data -> input -> tvapps -> player parts -> player -> ytplay -> view parts -> views -> app -->
     <!-- ?v= busts the TV webview cache on every release (keep in sync with package.json) -->
-    <script src="js/polyfills.js?v=2.1.0"></script>
-    <script src="js/util.js?v=2.1.0"></script>
-    <script src="js/iptv.js?v=2.1.0"></script>
-    <script src="js/youtube.js?v=2.1.0"></script>
-    <script src="js/stremio.js?v=2.1.0"></script>
-    <script src="js/trakt.js?v=2.1.0"></script>
-    <script src="js/keys.js?v=2.1.0"></script>
-    <script src="js/focus.js?v=2.1.0"></script>
-    <script src="js/tvapps.js?v=2.1.0"></script>
-    <script src="js/player-core.js?v=2.1.0"></script>
-    <script src="js/player-store.js?v=2.1.0"></script>
-    <script src="js/player-lang.js?v=2.1.0"></script>
-    <script src="js/player-quality.js?v=2.1.0"></script>
-    <script src="js/player-subs.js?v=2.1.0"></script>
-    <script src="js/player-audio.js?v=2.1.0"></script>
-    <script src="js/player-controls.js?v=2.1.0"></script>
-    <script src="js/player.js?v=2.1.0"></script>
-    <script src="js/ytplay.js?v=2.1.0"></script>
-    <script src="js/local.js?v=2.1.0"></script>
-    <script src="js/downloads.js?v=2.1.0"></script>
-    <script src="js/stremio-account.js?v=2.1.0"></script>
-    <script src="js/view-core.js?v=2.1.0"></script>
-    <script src="js/view-home.js?v=2.1.0"></script>
-    <script src="js/view-detail.js?v=2.1.0"></script>
-    <script src="js/view-search.js?v=2.1.0"></script>
-    <script src="js/view-settings.js?v=2.1.0"></script>
-    <script src="js/view-discover.js?v=2.1.0"></script>
-    <script src="js/views.js?v=2.1.0"></script>
-    <script src="js/app.js?v=2.1.0"></script>
-    <script src="js/hubpreview.js?v=2.1.0"></script>
+    <script src="js/polyfills.js?v=2.2.0"></script>
+    <script src="js/util.js?v=2.2.0"></script>
+    <script src="js/iptv.js?v=2.2.0"></script>
+    <script src="js/epg.js?v=2.2.0"></script>
+    <script src="js/youtube.js?v=2.2.0"></script>
+    <script src="js/stremio.js?v=2.2.0"></script>
+    <script src="js/trakt.js?v=2.2.0"></script>
+    <script src="js/keys.js?v=2.2.0"></script>
+    <script src="js/focus.js?v=2.2.0"></script>
+    <script src="js/tvapps.js?v=2.2.0"></script>
+    <script src="js/player-core.js?v=2.2.0"></script>
+    <script src="js/player-store.js?v=2.2.0"></script>
+    <script src="js/player-lang.js?v=2.2.0"></script>
+    <script src="js/player-quality.js?v=2.2.0"></script>
+    <script src="js/player-subs.js?v=2.2.0"></script>
+    <script src="js/player-audio.js?v=2.2.0"></script>
+    <script src="js/player-controls.js?v=2.2.0"></script>
+    <script src="js/player.js?v=2.2.0"></script>
+    <script src="js/ytplay.js?v=2.2.0"></script>
+    <script src="js/local.js?v=2.2.0"></script>
+    <script src="js/downloads.js?v=2.2.0"></script>
+    <script src="js/stremio-account.js?v=2.2.0"></script>
+    <script src="js/view-core.js?v=2.2.0"></script>
+    <script src="js/view-home.js?v=2.2.0"></script>
+    <script src="js/view-guide.js?v=2.2.0"></script>
+    <script src="js/view-detail.js?v=2.2.0"></script>
+    <script src="js/view-search.js?v=2.2.0"></script>
+    <script src="js/view-settings.js?v=2.2.0"></script>
+    <script src="js/view-discover.js?v=2.2.0"></script>
+    <script src="js/views.js?v=2.2.0"></script>
+    <script src="js/app.js?v=2.2.0"></script>
+    <script src="js/hubpreview.js?v=2.2.0"></script>
 </body>
 </html>

package/js/app.js

@@ -181,6 +181,7 @@ var App = (function () {
             if (nowb - _lastBackAt < 500) { return true; }
             _lastBackAt = nowb;
         }
+        if (action === 'GUIDE') { guideKey(); return true; }
         if (Player.isActive()) { return Player.handleKey(action); }   // (a held OK too: the player's Cast & more has a menu behind it)
         if (Views.moveKey && Views.moveKey(action)) { return true; }   // (a Continue Watching card being moved)
         switch (action) {
@@ -213,16 +214,27 @@ var App = (function () {
         }
     }
 
-    // Number keys away from the player: 0 Settings, 1–8 Home's tabs as they show (1: Watching).
-    // Not over a popup, nor on a page where something's being typed.
+    // The remote's GUIDE key: the Guide tab (once a TV guide is read: it's in the top menu), the
+    // player closed first. Not over a popup, nor while an addon's link is typed.
+    function guideKey() {
+        var on = (Views.menuItems ? Views.menuItems() : []).some(function (m) { return m.key === 'guide'; });
+        if (!on) { U.toast('No TV guide yet (Settings › Content › IPTV › Guide link)', 3000); return; }
+        if (Player.isActive()) { Player.exit(); }
+        else if (Views.isModalOpen() || _current === 'addaddon') { return; }
+        goHome('guide');
+    }
+
+    // Number keys away from the player: 0 Settings, 1–9 the top menu's items as they show (1:
+    // Watching, the rest in your order: Views.menuItems). Not over a popup, nor on a page where
+    // something's being typed.
     function numberKey(n) {
         if (Views.isModalOpen() || _current === 'addaddon') { return; }
         if (n === 0) { if (_current !== 'settings') { openSettings(); } return; }
-        // the top menu's items, left to right: the tabs showing, then Discover, then Search
-        var tabs = Views.availableTabs ? Views.availableTabs() : [], t = tabs[n - 1];
-        if (t) { goHome(t.key); }
-        else if (n === tabs.length + 1) { if (_current !== 'discover') { openDiscover(); } }
-        else if (n === tabs.length + 2) { if (_current !== 'search') { openSearch(); } }
+        var m = (Views.menuItems ? Views.menuItems() : [])[n - 1];
+        if (!m) { return; }
+        if (m.key === 'discover') { if (_current !== 'discover') { openDiscover(); } }
+        else if (m.key === 'search') { if (_current !== 'search') { openSearch(); } }
+        else { goHome(m.key); }
     }
 
     function actualStart() {

package/js/epg.js

@@ -0,0 +1,320 @@
+/* TV guide (XMLTV) for IPTV channels. Global namespace: EPG
+   Which guide a playlist has (guideUrl: the Guide link you set, else the one the playlist
+   names, else an Xtream playlist's own), read by StremioK's service for your channels only
+   (their keys as a bitset: see service/index.js, epgControl), and the programs asked for as
+   the cards, Home's details strip, the player and a channel's schedule need them. Not in a
+   desktop browser (no service). */
+var EPG = (function () {
+    'use strict';
+
+    // A channel's key, as the service makes it: "i:" and its tvg-id (iptv-org's feed after an @
+    // left out: "ElTrece.ar@SD" is a guide's "ElTrece.ar"), or "n:" and its name without
+    // capitals, accents, spaces, "TV" or HD / FHD / 4K tags ("El Trece HD": "n:eltrece"). A
+    // country at the end (".ar", or a name's " ARG" / " MX": COUNTRY) is kept apart, after a dot
+    // ("FOX SPORTS 2 ARG": "n:foxsports2.ar"); a guide's channel answers with it and without
+    // (keysAll), so "A24" finds a guide's "A24.ar", and "ESPN 2 MX" doesn't find "Espn2.ar".
+    var ACCENTS = { 'á': 'a', 'à': 'a', 'â': 'a', 'ä': 'a', 'ã': 'a', 'å': 'a', 'é': 'e', 'è': 'e', 'ê': 'e', 'ë': 'e', 'í': 'i', 'ì': 'i', 'î': 'i', 'ï': 'i',
+        'ó': 'o', 'ò': 'o', 'ô': 'o', 'ö': 'o', 'õ': 'o', 'ú': 'u', 'ù': 'u', 'û': 'u', 'ü': 'u', 'ñ': 'n', 'ç': 'c' };
+    var COUNTRY = { ar: 'ar', arg: 'ar', mx: 'mx', mex: 'mx', us: 'us', usa: 'us', uk: 'uk', gb: 'uk', es: 'es', br: 'br', cl: 'cl', co: 'co', pe: 'pe',
+        uy: 'uy', py: 'py', ve: 've', ec: 'ec', bo: 'bo', ca: 'ca', fr: 'fr', de: 'de', it: 'it', pt: 'pt' };
+    function parts(kind, s) {
+        var t = ('' + (s || '')).toLowerCase().replace(/[áàâäãåéèêëíìîïóòôöõúùûüñç]/g, function (c) { return ACCENTS[c]; }).trim(), cc = '', m;
+        if (kind === 'i') { t = t.replace(/@.*$/, ''); }
+        if ((m = /\.([a-z]{2})$/.exec(t))) { cc = m[1]; t = t.slice(0, -3); }
+        else if (kind === 'n' && (m = /[\s_-]+([a-z]{2,3})$/.exec(t)) && COUNTRY[m[1]] && t.length > m[0].length) { cc = COUNTRY[m[1]]; t = t.slice(0, -m[0].length); }
+        if (kind === 'n') { t = t.replace(/\[[^\]]*\]|\([^)]*\)/g, ' ').replace(/\b(hd|fhd|uhd|sd|hq|4k|8k|hevc|h265|1080p?|720p?|tv)\b/g, ' '); }
+        t = t.replace(/[^a-z0-9]+/g, '');
+        if (kind === 'n' && t.length > 4) { t = t.replace(/tv$/, ''); }   // ("CronicaTV")
+        return { base: t.slice(0, 60), cc: cc };
+    }
+    function key(kind, s) { var p = parts(kind, s); return p.base ? kind + ':' + p.base + (p.cc ? '.' + p.cc : '') : ''; }
+    function keysAll(kind, s) { var p = parts(kind, s); return !p.base ? [] : p.cc ? [kind + ':' + p.base + '.' + p.cc, kind + ':' + p.base] : [kind + ':' + p.base]; }
+    function hash(s) {
+        var h = 0x811c9dc5;
+        for (var i = 0; i < s.length; i++) { h ^= s.charCodeAt(i); h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0; }
+        return h;
+    }
+    // The keys as a bitset, base64url: 16 bits a key (1,024 to 131,072 in all); a key's hash
+    // picks its bit.
+    var B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+    function bitsFor(keys) {
+        var n = 1024, bytes = [], i;
+        while (n < keys.length * 16 && n < 131072) { n *= 2; }
+        for (i = 0; i < n / 8; i++) { bytes.push(0); }
+        keys.forEach(function (k) { if (k) { var b = hash(k) % n; bytes[b >> 3] |= 1 << (b & 7); } });
+        var out = '';
+        for (i = 0; i < bytes.length; i += 3) {
+            var v = (bytes[i] << 16) | ((bytes[i + 1] || 0) << 8) | (bytes[i + 2] || 0);
+            out += B64.charAt((v >> 18) & 63) + B64.charAt((v >> 12) & 63) + (i + 1 < bytes.length ? B64.charAt((v >> 6) & 63) : '') + (i + 2 < bytes.length ? B64.charAt(v & 63) : '');
+        }
+        return out;
+    }
+    function keysOf(c) { return [c.tvgId ? key('i', c.tvgId) : '', key('n', c.name)].filter(Boolean); }
+
+    // A playlist's guide: yours (p.guide), else the first the playlist names (url-tvg), else an
+    // Xtream get.php link's xmltv.php (the same login; also in place of a guide the playlist
+    // names on its own server without the login). '' when none.
+    function param(q, name) {
+        var m = new RegExp('(?:^|&)' + name + '=([^&#]*)').exec(q || '');
+        if (!m) { return ''; }
+        try { return decodeURIComponent(m[1].replace(/\+/g, ' ')); } catch (e) { return ''; }
+    }
+    function guideUrl(p, named) {
+        if (p && p.guide) { return p.guide; }
+        var g = (named || []).filter(function (u) { return !!U.parseUrl(u) && /^https?:\/\//i.test(u); })[0];
+        var u = U.parseUrl(p && p.url), xt = '';
+        if (u && /\/get\.php$/i.test(u.path)) {
+            var user = param(u.query, 'username'), pass = param(u.query, 'password');
+            if (user && pass) { xt = u.scheme + '://' + u.host + (u.port ? ':' + u.port : '') + u.path.replace(/get\.php$/i, 'xmltv.php') + '?username=' + encodeURIComponent(user) + '&password=' + encodeURIComponent(pass); }
+        }
+        var gu = g && U.parseUrl(g);
+        if (g && xt && gu && gu.host === u.host && gu.port === u.port && !param(gu.query, 'username')) { return xt; }   // (its own server's, without the login)
+        return g || xt;
+    }
+
+    function available() { return typeof YTPlay !== 'undefined' && !!YTPlay.epgLoad && YTPlay.installMode() !== 'browser'; }
+
+    // ---- the guides: asked to read, then waited for ----
+    var _guides = {};    // url -> { k, state, at, channels, programmes, partial, error, timer }
+    var _byList = {};    // playlist id -> its guide's url ('' none)
+    var POLL_MS = [300, 300, 600, 1000, 2000], POLL_MS_LATER = 3000, POLLS = 300, CHECK_MS = 60 * 60 * 1000;
+    // Every playlist's guide asked for (again: the service reads one only when it's old), for
+    // its channels' keys. After the playlists are read, and every hour. again: a playlist's id,
+    // or true for all (its Reload, IPTV.reload): their guides read again now, however new.
+    function start(again) {
+        if (!available() || typeof IPTV === 'undefined' || !IPTV.channels) { return; }
+        var byGuide = {}, force = {};
+        _byList = {};
+        IPTV.getPlaylists().forEach(function (p) {
+            if (p.off) { return; }
+            var st = IPTV.status(p.id), url = guideUrl(p, st && st.guides);
+            _byList[p.id] = url;
+            if (url && !byGuide[url]) { byGuide[url] = []; }
+            if (url && (again === true || again === p.id)) { force[url] = true; }
+        });
+        IPTV.channels().forEach(function (c) {
+            var url = _byList[c._playlistId];
+            if (url) { byGuide[url].push.apply(byGuide[url], keysOf(c)); }
+        });
+        var gone = false;
+        Object.keys(_guides).forEach(function (url) {   // (a guide no playlist uses any more: dropped)
+            if (byGuide[url]) { return; }
+            if (_guides[url].timer) { clearTimeout(_guides[url].timer); }
+            delete _guides[url];
+            forget(url);
+            gone = true;
+        });
+        Object.keys(byGuide).forEach(function (url) { if (byGuide[url].length) { loadGuide(url, bitsFor(byGuide[url]), !!force[url]); } });
+        if (!_checker) { _checker = setInterval(function () { start(); }, CHECK_MS); }
+        if (gone) { changed(); }
+    }
+    var _checker = null;
+    function loadGuide(url, k, force) {
+        var g = _guides[url];
+        if (!g || g.k !== k || force) { if (g && g.timer) { clearTimeout(g.timer); } g = _guides[url] = { k: k, state: 'loading' }; }
+        else if (g.timer || g.asking) { return; }
+        (function ask(n) {
+            g.asking = true;
+            YTPlay.epgLoad(url, k, force && !n).then(function (r) {
+                g.asking = false;
+                if (_guides[url] !== g) { return; }
+                var was = g.state + '|' + g.at;
+                ['state', 'at', 'channels', 'programmes', 'partial', 'error'].forEach(function (f) { g[f] = r && r[f]; });
+                if (g.state === 'loading' && n < POLLS) { g.timer = setTimeout(function () { g.timer = null; ask(n + 1); }, n < POLL_MS.length ? POLL_MS[n] : POLL_MS_LATER); }
+                if (g.state + '|' + g.at !== was) {
+                    if (g.state === 'ready') { forget(url); }   // (read again: what's on, asked again)
+                    changed();
+                }
+            }, function () {
+                g.asking = false;
+                if (_guides[url] !== g) { return; }
+                g.state = 'failed'; g.error = 'StremioK’s service didn’t answer';
+                changed();
+            });
+        })(0);
+    }
+    // For Settings › IPTV: a playlist's guide and how it stands, or null when it has none.
+    function status(playlistId) {
+        var url = _byList[playlistId];
+        if (!url) { return null; }
+        var g = _guides[url] || { state: 'loading' };
+        return { url: url, state: g.state, at: g.at || 0, channels: g.channels || 0, programmes: g.programmes || 0, partial: !!g.partial, error: g.error || '' };
+    }
+
+    // ---- programs: asked for in batches, kept per channel ----
+    var _progs = {};     // channel id -> { at, list: [{ start, stop, title, desc }], full (the whole window) }
+    var _icons = {};     // channel id -> its guide's logo (for one the playlist gives none: logo)
+    var _want = {}, _wantTimer = null, _asking = 0, BATCH = 60, PROG_MS = 30 * 60 * 1000;
+    function channelOf(id) { return (typeof IPTV !== 'undefined' && IPTV.channel) ? IPTV.channel(id) : null; }
+    function guideOf(c) { var url = c && _byList[c._playlistId], g = url && _guides[url]; return (g && g.state === 'ready') ? url : ''; }
+    function forget(url) { Object.keys(_progs).forEach(function (id) { if (_progs[id].url === url) { delete _progs[id]; } }); }
+    function want(ids) {
+        (ids || []).forEach(function (id) { if (/^iptv:/.test(id || '')) { _want[id] = 1; } });
+        if (!_wantTimer) { _wantTimer = setTimeout(flush, 50); }
+    }
+    function nowSec() { return Math.floor(Date.now() / 1000); }
+    function asList(rows, url) {
+        return (rows || []).filter(function (r) { return r && r.length >= 3 && r[1] > r[0]; })
+            .map(function (r) {
+                var p = { start: +r[0], stop: +r[1], title: '' + r[2], desc: '' + (r[3] || ''), picture: (typeof r[4] === 'string' && U.parseUrl(r[4]) && !(U.urlIsPrivate(r[4]) && !U.urlIsPrivate(url || ''))) ? r[4] : '' };   // (no picture into your home network from a guide on the internet)
+                var a = r[5];   // (what it is, from the guide's categories: a film's original title and year)
+                if (a && typeof a === 'object') {
+                    if (a.m === 'movie' || a.m === 'series') { p.kind = a.m; }
+                    if (typeof a.o === 'string' && a.o) { p.orig = a.o.slice(0, 120); }
+                    if (+a.y >= 1900 && +a.y <= 2100) { p.year = +a.y; }
+                }
+                return p;
+            });
+    }
+    // One request a guide at a time per batch (BATCH channels): from now, the next few.
+    function flush() {
+        _wantTimer = null;
+        if (_asking) { _wantTimer = setTimeout(flush, 200); return; }
+        var byGuide = {};
+        Object.keys(_want).forEach(function (id) {
+            var c = channelOf(id), url = guideOf(c);
+            if (!url) { return; }   // (no guide, or not read yet: asked again once it is)
+            delete _want[id];
+            if (fresh(id)) { return; }
+            (byGuide[url] = byGuide[url] || []).push(c);
+        });
+        Object.keys(byGuide).forEach(function (url) {
+            var list = byGuide[url];
+            for (var i = 0; i < list.length; i += BATCH) { ask(url, list.slice(i, i + BATCH), nowSec(), nowSec() + 6 * 3600, 4, false); }
+        });
+    }
+    function ask(url, chans, from, to, max, full) {
+        var keys = [], gen = _gen;
+        chans.forEach(function (c) { keys.push.apply(keys, keysOf(c)); });
+        _asking++;
+        // Resolves { id: programs } for the channels answered ([] when none, or not in the guide),
+        // and _unknown: the ids not answered (failed, cut off, not read there, or the guides
+        // changed since): kept as they were and asked again, never taken as empty.
+        function unknown() { var o = {}; o._unknown = chans.map(function (c) { return c.id; }); return o; }
+        return YTPlay.epgGet(url, keys, from, to, max).then(function (r) {
+            _asking--;
+            if (gen !== _gen || !r || typeof r !== 'object' || r._unread) { return unknown(); }   // (the guides changed since, or no answer to read)
+            var cut = {};
+            (Array.isArray(r._cut) ? r._cut : []).forEach(function (k) { cut[k] = 1; });
+            var out = {}, icons = (r._icons && typeof r._icons === 'object') ? r._icons : {};
+            var unk = [];
+            chans.forEach(function (c) {
+                if (_byList[c._playlistId] !== url) { unk.push(c.id); return; }   // (its playlist's guide is another now)
+                var ks = keysOf(c), rows = null;
+                for (var i = 0; i < ks.length && !rows; i++) { if (Array.isArray(r[ks[i]])) { rows = r[ks[i]]; } }
+                if (!rows && ks.some(function (k) { return cut[k]; })) { unk.push(c.id); return; }   // (cut off: not answered)
+                for (var j = 0; j < ks.length; j++) {
+                    var icon = icons[ks[j]];
+                    // (a guide on the internet can't point one into your home network)
+                    if (typeof icon === 'string' && U.parseUrl(icon) && !(U.urlIsPrivate(icon) && !U.urlIsPrivate(url))) { _icons[c.id] = icon; break; }
+                }
+                var e = { at: Date.now(), url: url, list: asList(rows, url), full: full };
+                if (!full && _progs[c.id] && _progs[c.id].full && _progs[c.id].at > Date.now() - PROG_MS) { return; }   // (a whole schedule kept)
+                _progs[c.id] = e;
+                out[c.id] = e.list;
+            });
+            trimProgs();
+            if (unk.length) { out._unknown = unk; }
+            changed();
+            return out;
+        }, function () { _asking--; return unknown(); });
+    }
+    // Programs kept for PROGS_KEEP channels at most (the ones read longest ago go first): a long
+    // session going through thousands of channels doesn't keep them all.
+    var PROGS_KEEP = 400;
+    function trimProgs() {
+        var ids = Object.keys(_progs);
+        if (ids.length <= PROGS_KEEP) { return; }
+        ids.sort(function (a, b) { return _progs[a].at - _progs[b].at; }).slice(0, ids.length - PROGS_KEEP).forEach(function (id) { delete _progs[id]; });
+    }
+    function fresh(id) {
+        var e = _progs[id];
+        if (!e || Date.now() - e.at > PROG_MS) { return false; }
+        var t = nowSec();
+        return !e.list.length || e.list[e.list.length - 1].stop > t;   // (what's on, still in what was read)
+    }
+    // What's on now, and next: { now, next } (either may be null), or null without a guide.
+    function now(id) {
+        var c = channelOf(id);
+        if (!c || !guideOf(c)) { return null; }
+        if (!fresh(id)) { want([id]); }
+        var e = _progs[id];
+        if (!e || e.url !== guideOf(c)) { return null; }
+        var t = nowSec(), cur = null, next = null;
+        for (var i = 0; i < e.list.length; i++) {
+            var p = e.list[i];
+            if (!cur && p.start <= t && t < p.stop) { cur = p; continue; }
+            if (p.start > t && (!next || p.start < next.start)) { next = p; break; }
+        }
+        return (cur || next) ? { now: cur, next: next } : null;
+    }
+    // A channel's schedule, from 2 hours ago to tomorrow: Promise of [{ start, stop, title, desc }].
+    function schedule(id) {
+        var c = channelOf(id), url = guideOf(c);
+        if (!url) { return Promise.resolve([]); }
+        return ask(url, [c], nowSec() - 2 * 3600, nowSec() + 30 * 3600, 150, true).then(function (out) { return out[id] || []; });
+    }
+    function hasGuide(id) { return !!guideOf(channelOf(id)); }
+    // A channel's logo from its guide ('' when it gave none, or not asked yet).
+    function logo(id) { return _icons[id] || ''; }
+    // Whether any guide was read with channels in it (the Guide tab shows then), and the channels
+    // that have a guide, in the IPTV tab's order.
+    function hasAny() {
+        return Object.keys(_byList).some(function (id) { var g = _guides[_byList[id]]; return !!g && g.state === 'ready' && g.channels > 0; });
+    }
+    function guided() {   // (your favorites first)
+        var all = (typeof IPTV !== 'undefined' && IPTV.channels ? IPTV.channels() : []).filter(function (c) { return !!guideOf(c); });
+        var fav = IPTV.isFavorite ? all.filter(function (c) { return IPTV.isFavorite(c.id); }) : [];
+        return fav.concat(all.filter(function (c) { return fav.indexOf(c) === -1; }));
+    }
+    // Many channels' programs from 'from' to 'to' (the Guide tab): Promise of { id: programs },
+    // RANGE_BATCH channels a request (each answer kept to 2 MB by the service: 150 programs
+    // a channel with their pictures and descriptions fit).
+    var RANGE_BATCH = 20;
+    function range(ids, from, to) {
+        var byGuide = {}, jobs = [];
+        (ids || []).forEach(function (id) { var c = channelOf(id), url = guideOf(c); if (url) { (byGuide[url] = byGuide[url] || []).push(c); } });
+        Object.keys(byGuide).forEach(function (url) {
+            var list = byGuide[url];
+            for (var i = 0; i < list.length; i += RANGE_BATCH) { jobs.push(ask(url, list.slice(i, i + RANGE_BATCH), Math.floor(from), Math.ceil(to), 150, true)); }
+        });
+        return Promise.all(jobs).then(function (outs) {
+            var all = {}, unknown = [];
+            outs.forEach(function (o) { Object.keys(o || {}).forEach(function (id) { if (id === '_unknown') { unknown = unknown.concat(o._unknown); } else { all[id] = o[id]; } }); });
+            if (unknown.length) { all._unknown = unknown; }   // (not answered: see ask)
+            return all;
+        });
+    }
+
+    // 20:30, or with the day when it isn't today (Tue 01:00).
+    var DAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+    function two(n) { return (n < 10 ? '0' : '') + n; }
+    function hhmm(sec) { var d = new Date(sec * 1000); return two(d.getHours()) + ':' + two(d.getMinutes()); }
+    function dayTime(sec) {
+        var d = new Date(sec * 1000), today = new Date(Date.now());
+        var same = d.getFullYear() === today.getFullYear() && d.getMonth() === today.getMonth() && d.getDate() === today.getDate();
+        return (same ? '' : DAYS[d.getDay()] + ' ') + hhmm(sec);
+    }
+
+    // Told when a guide is read or programs arrive (once for a burst).
+    var _fns = [], _changeTimer = null;
+    function onChange(fn) { _fns.push(fn); }
+    function changed() {
+        if (_changeTimer) { return; }
+        _changeTimer = setTimeout(function () {
+            _changeTimer = null;
+            if (Object.keys(_want).length && !_wantTimer) { _wantTimer = setTimeout(flush, 50); }   // (asked before the guide was read)
+            _fns.forEach(function (fn) { try { fn(); } catch (e) {} });
+        }, 60);
+    }
+    // The guide links changed (a playlist's Guide link, its link, its channels): asked again.
+    // An answer asked before (an older _gen) is dropped when it comes.
+    var _gen = 0;
+    function reset() { _gen++; _progs = {}; _icons = {}; _want = {}; start(); }
+
+    return {
+        generation: function () { return _gen; },   // (changes when the guides do: what was read before isn't theirs)
+        key: key, keysAll: keysAll, bitsFor: bitsFor, guideUrl: guideUrl, available: available, start: start, reset: reset, status: status,
+        want: want, now: now, schedule: schedule, hasGuide: hasGuide, logo: logo, hasAny: hasAny, guided: guided, range: range, onChange: onChange, hhmm: hhmm, dayTime: dayTime
+    };
+})();