stremiok 2.1.0 → 2.2.1

package/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+What changed in each version of StremioK, newest first. How everything works is in the
+[user guide](docs/USER-GUIDE.md).
+
+## 2.2.1 — 2026-10-24
+- **Every language OpenSubtitles uses** (94, Indonesian among them, #1) for subtitles and audio:
+  to pick as your default, second choice or second subtitle, listed by name, and each track
+  shown by its language's name ("Pan" is Punjabi).
+- **Only my languages** (Settings › Playback › Subtitles, *Off* by default): the subtitle menu
+  lists just your languages, and tracks that don't say theirs; *Other languages* at its end has
+  the rest.
+- **Shorter settings pages:** the subtitles' size, color, background, edge, position and font are
+  on a page of their own (*Appearance*); Source ranking keeps *Played before first* above its
+  order, with *Filters* and *When you press Play* as pages of their own.
+- **Hold OK on a program in the Guide tab:** *▶ Watch now*, *★ Add to / Remove from favorites*
+  for its channel, and *Find in your addons* for that program.
+- **Fixed:** back on the Guide tab after CH+ / CH− lands on the channel you ended on, at the time
+  now, instead of the first channel played.
+
+## 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

@@ -16,13 +16,14 @@ video through Samsung's AVPlay API.
 - **[Changelog](CHANGELOG.md)**: what changed in each version.
 - **[Developer guide](docs/DEVELOPER-GUIDE.md)**: how it's put together, and running it in a
   browser.
+- **[Security policy](docs/SECURITY.md)**: reporting a vulnerability, privately.
 
 ## Highlights
 
 - **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 +31,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 +56,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 +75,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.1" 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.1">
 </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.1"></script>
+    <script src="js/util.js?v=2.2.1"></script>
+    <script src="js/iptv.js?v=2.2.1"></script>
+    <script src="js/epg.js?v=2.2.1"></script>
+    <script src="js/youtube.js?v=2.2.1"></script>
+    <script src="js/stremio.js?v=2.2.1"></script>
+    <script src="js/trakt.js?v=2.2.1"></script>
+    <script src="js/keys.js?v=2.2.1"></script>
+    <script src="js/focus.js?v=2.2.1"></script>
+    <script src="js/tvapps.js?v=2.2.1"></script>
+    <script src="js/player-core.js?v=2.2.1"></script>
+    <script src="js/player-store.js?v=2.2.1"></script>
+    <script src="js/player-lang.js?v=2.2.1"></script>
+    <script src="js/player-quality.js?v=2.2.1"></script>
+    <script src="js/player-subs.js?v=2.2.1"></script>
+    <script src="js/player-audio.js?v=2.2.1"></script>
+    <script src="js/player-controls.js?v=2.2.1"></script>
+    <script src="js/player.js?v=2.2.1"></script>
+    <script src="js/ytplay.js?v=2.2.1"></script>
+    <script src="js/local.js?v=2.2.1"></script>
+    <script src="js/downloads.js?v=2.2.1"></script>
+    <script src="js/stremio-account.js?v=2.2.1"></script>
+    <script src="js/view-core.js?v=2.2.1"></script>
+    <script src="js/view-home.js?v=2.2.1"></script>
+    <script src="js/view-guide.js?v=2.2.1"></script>
+    <script src="js/view-detail.js?v=2.2.1"></script>
+    <script src="js/view-search.js?v=2.2.1"></script>
+    <script src="js/view-settings.js?v=2.2.1"></script>
+    <script src="js/view-discover.js?v=2.2.1"></script>
+    <script src="js/views.js?v=2.2.1"></script>
+    <script src="js/app.js?v=2.2.1"></script>
+    <script src="js/hubpreview.js?v=2.2.1"></script>
 </body>
 </html>

package/js/app.js

@@ -73,14 +73,17 @@ var App = (function () {
     // Close a live player directly back to the screen/card that launched it. The
     // originating screen stays mounted while the player is open, so restoring its
     // saved focus node also preserves the grid's horizontal and vertical scroll.
-    // focusNode: the card to land on instead (the channel you switched to with CH+/CH−).
-    function returnFromLive(focusNode) {
+    // focusNode: the card to land on instead (the channel you switched to with CH+/CH−); liveId:
+    // that channel, for the Guide tab, which lands on it at the time now (Views.guideBackOn: its
+    // cells from when it was played may be gone, or show hours long past).
+    function returnFromLive(focusNode, liveId) {
         var f = _stack.pop();
         if (!f) { goHome(); return; }
         if (f.screen !== _current) { abandon(_current); }
         showScreen(f.screen);
+        var guide = liveId && f.screen === 'home' && Views.guideBackOn ? Views.guideBackOn(liveId) : null;
         var alt = focusNode && document.documentElement.contains(focusNode) ? focusNode : null;
-        Focus.setScope(screenEl(f.screen), alt || f.focus);
+        Focus.setScope(screenEl(f.screen), guide || alt || f.focus);
     }
 
     // After a screen is drawn, focus must be on it. A drawing path that doesn't put it there
@@ -181,6 +184,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 +217,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() {