From c8f72f855277669bc42d6d89dd8d7ad5b2a3b9ec Mon Sep 17 00:00:00 2001 From: Nirvana Date: Thu, 30 Oct 2025 15:19:16 +0100 Subject: [PATCH] Add icon, correct readme, addon.xml --- README.md | 148 +++++++++++++++++++++++++++++++----------------------- addon.xml | 39 ++++++++++++-- icon.png | 69 +++++++++++++++++++++++++ 3 files changed, 189 insertions(+), 67 deletions(-) create mode 100644 icon.png diff --git a/README.md b/README.md index 95eeb90..aa49565 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,21 @@ # Ultimate Backend (Kodi Add-on) -**Ultimate Backend** is a background service for **Kodi** that provides a local API for **live TV streaming**, **EPG data**, and **manifest management** from supported online TV providers. +**Ultimate Backend** is a background service for **Kodi** that provides a local API for **live TV streaming**, **EPG data**, and **manifest management** from supported online TV providers. -It acts as the **bridge between streaming services and Kodiโ€™s PVR system**, designed specifically to work together with the official **[PVR IPTV Simple Client](https://github.com/kodi-pvr/pvr.iptvsimple)**. +It acts as the **bridge between streaming services and Kodi's PVR system**, designed specifically to work together with the official **PVR IPTV Simple Client**. --- ## ๐ŸŽฏ Purpose -This add-on runs a small local web service inside Kodi. +This add-on runs a small local web service inside Kodi. It: -- Logs in to supported streaming providers -- Retrieves live channel lists and EPG data -- Rewrites DASH manifests for Kodi playback -- Generates M3U playlists compatible with PVR IPTV Simple +- Logs in to supported streaming providers +- Retrieves live channel lists and EPG data +- Rewrites DASH manifests for Kodi playback +- Generates M3U playlists compatible with PVR IPTV Simple -Once configured, your live TV channels from streaming platforms appear directly in Kodiโ€™s **TV** section โ€” complete with EPG, logos, and DRM handling. +Once configured, your live TV channels from streaming platforms appear directly in Kodi's **TV** section โ€” complete with EPG, logos, and DRM handling. --- @@ -25,7 +25,7 @@ Currently supported: - ๐Ÿ‡ฉ๐Ÿ‡ช **Joyn (DE)** - ๐Ÿ‡ฆ๐Ÿ‡น **Joyn (AT)** - ๐Ÿ‡จ๐Ÿ‡ญ **Joyn (CH)** -- ๐Ÿ‡ช๐Ÿ‡บ **RTL+** +- ๐Ÿ‡ฉ๐Ÿ‡ช **RTL+** More providers will be added in future versions. @@ -33,28 +33,27 @@ More providers will be added in future versions. ## โœจ Key Features -- ๐Ÿ“ก **Automatic Provider Integration** โ€“ Unified access to multiple streaming services -- ๐Ÿ” **Manifest Proxying & Rewriting** โ€“ For seamless DASH playback via InputStream Adaptive -- ๐Ÿ” **DRM Support** โ€“ Handles Widevine, PlayReady, and ClearKey license data -- ๐Ÿ—“๏ธ **EPG Data** โ€“ XMLTV-compatible program guide per provider -- ๐ŸŽต **M3U Playlist Generation** โ€“ One-click generation for Kodi PVR clients -- โšก **Caching System** โ€“ Caches manifests and playlists for fast reloads -- ๐ŸŒ **Regional Support** โ€“ Separate configurations for Germany, Austria, and Switzerland +- ๐Ÿ“ก **Automatic Provider Integration** โ€“ Unified access to multiple streaming services +- ๐Ÿ” **Manifest Proxying & Rewriting** โ€“ For seamless DASH playback via InputStream Adaptive +- ๐Ÿ” **DRM Support** โ€“ Handles Widevine, PlayReady, and ClearKey license data +- ๐Ÿ—“๏ธ **EPG Data** โ€“ XMLTV-compatible program guide per provider (coming in future version) +- ๐ŸŽต **M3U Playlist Generation** โ€“ Individual playlists for each provider +- โšก **Caching System** โ€“ Caches manifests and playlists for fast reloads +- ๐ŸŒ **Regional Support** โ€“ Separate configurations for Germany, Austria, and Switzerland +- ๐Ÿ”„ **Provider-Specific Proxy** โ€“ Configure proxy settings individually for each provider --- ## ๐Ÿงฉ Installation 1. Copy or clone this addon into your Kodi `addons` directory: - ``` ~/.kodi/addons/script.service.ultimate - ``` 2. Required dependencies (Kodi installs these automatically): - - `xbmc.python` โ‰ฅ 3.0.0 - - `script.module.bottle` โ‰ฅ 0.12.25 - - `script.module.requests` โ‰ฅ 2.25.1 - - `script.module.pycryptodome` โ‰ฅ 3.4.3 + - `xbmc.python` โ‰ฅ 3.0.0 + - `script.module.bottle` โ‰ฅ 0.12.25 + - `script.module.requests` โ‰ฅ 2.25.1 + - `script.module.pycryptodome` โ‰ฅ 3.4.3 3. Restart Kodi โ€” the **Ultimate Backend** service starts automatically on login. @@ -63,7 +62,7 @@ More providers will be added in future versions. ## โš™๏ธ Configuration Go to: -> **Settings โ†’ Add-ons โ†’ Ultimate Backend โ†’ Configure** +**Settings โ†’ Add-ons โ†’ Ultimate Backend โ†’ Configure** ### General Settings @@ -75,53 +74,67 @@ Go to: | **Enable EPG Caching** | Cache EPG data locally | โœ… On | | **Cache Duration (hours)** | Cache lifetime | `6` | -### Provider Settings +### Provider Configuration -Each provider (Joyn DE/AT/CH, RTL+) can be configured individually: -- Enable or disable provider -- Enter login credentials (username/password) -- Configure proxy settings if needed (host and port) +**Each provider can be individually enabled and configured:** -Example for Joyn (DE): -- Enable Joyn (DE) -- Enter your credentials -- Optionally enable and configure proxy +#### Joyn Providers (DE/AT/CH) +- **Enable Provider** โ€“ Toggle on/off for each country +- **Credentials** โ€“ Enter your username and password +- **Proxy Settings** โ€“ Optional proxy configuration per provider: + - Enable proxy support + - Set proxy host and port + - Useful for geo-restricted content or network requirements + +#### RTL+ Provider +- **Credentials** โ€“ Enter your RTL+ username and password +- **Proxy Settings** โ€“ Optional proxy configuration: + - Enable proxy if needed for your region + - Configure proxy host and port + +**๐Ÿ’ก Recommendation:** Configure only the providers you actually use to improve performance and reduce startup time. --- ## ๐Ÿง  Using with PVR IPTV Simple Client -The **Ultimate Backend** add-on is designed to work **together with** -โžก๏ธ **[PVR IPTV Simple Client](https://github.com/kodi-pvr/pvr.iptvsimple)** +The **Ultimate Backend** add-on is designed to work **together with PVR IPTV Simple Client** ### Setup Steps -1. In Kodi, go to: +1. In Kodi, go to: **Add-ons โ†’ My Add-ons โ†’ PVR Clients โ†’ PVR IPTV Simple Client โ†’ Configure** -2. Under **General โ†’ Location**, select: +2. Under **General โ†’ Location**, select: ๐ŸŸข *Remote Path (Internet address)* -3. Enter these URLs: +3. **Recommended:** Use provider-specific M3U URLs for better performance and organization: - **M3U Playlist URL:** - ``` - http://localhost:7777/api/m3u - ``` + **For Joyn DE:** + M3U Playlist URL: http://localhost:7777/api/providers/joyn_de/m3u + EPG XMLTV URL: http://localhost:7777/api/providers/joyn_de/epg - **EPG XMLTV URL** (example for Joyn DE): - ``` - http://localhost:7777/api/providers/joyn_de/epg - ``` + **For Joyn AT:** + M3U Playlist URL: http://localhost:7777/api/providers/joyn_at/m3u + EPG XMLTV URL: http://localhost:7777/api/providers/joyn_at/epg -4. Save and restart Kodiโ€™s PVR subsystem (or Kodi itself). - Your live TV channels and EPG will now appear in Kodiโ€™s **TV** section. + **For RTL+:** + M3U Playlist URL: http://localhost:7777/api/providers/rtlplus/m3u + EPG XMLTV URL: http://localhost:7777/api/providers/rtlplus/epg + + *Alternatively, you can use the combined playlist (not recommended for multiple providers):* + M3U Playlist URL: http://localhost:7777/api/m3u + +4. Save and restart Kodi's PVR subsystem (or Kodi itself). + Your live TV channels will now appear in Kodi's **TV** section. + +โš ๏ธ **Note:** EPG (Electronic Program Guide) data will be available in a future version. Currently, channels will be displayed without program information. + +๐Ÿ’ก **Tip:** +To regenerate and cache the latest M3U playlist manually, open these URLs in your browser: +- Provider-specific: http://localhost:7777/api/providers/joyn_de/m3u/generate +- All providers: http://localhost:7777/api/m3u/generate -๐Ÿ’ก **Tip:** -To regenerate and cache the latest M3U playlist manually, open this in your browser: -``` -http://localhost:7777/api/m3u/generate -``` This forces the backend to rebuild and cache the playlist for faster future loading. --- @@ -129,9 +142,7 @@ This forces the backend to rebuild and cache the playlist for faster future load ## ๐ŸŒ API Overview Once running, the addon exposes a local API: -``` http://localhost:7777/ -``` ### Common Endpoints @@ -141,9 +152,11 @@ http://localhost:7777/ | `/api/providers//channels` | Get available channels | | `/api/providers//channels//manifest` | Get or rewrite manifest | | `/api/providers//channels//stream` | Direct stream redirect | -| `/api/providers//epg` | Get EPG in XMLTV format | -| `/api/m3u` | Cached combined playlist | -| `/api/m3u/generate` | Force regeneration and caching of playlist | +| `/api/providers//epg` | Get EPG in XMLTV format (future version) | +| `/api/providers//m3u` | **Recommended:** Provider-specific cached playlist | +| `/api/m3u` | Combined playlist (all providers) | +| `/api/providers//m3u/generate` | Force regeneration of provider-specific playlist | +| `/api/m3u/generate` | Force regeneration of combined playlist | | `/api/cache/mpd/clear` | Clear MPD cache | | `/api/cache/mpd/clear-expired` | Clear expired cache entries | @@ -152,14 +165,25 @@ http://localhost:7777/ ## ๐Ÿงผ Cache Management Ultimate Backend automatically caches: -- DASH Manifests -- EPG Data -- M3U Playlists +- DASH Manifests +- EPG Data (when available in future version) +- M3U Playlists (both provider-specific and combined) ### Manual cache actions: | Purpose | URL | |----------|-----| | Clear all MPD cache | `/api/cache/mpd/clear` | | Remove expired entries | `/api/cache/mpd/clear-expired` | -| Force M3U regeneration | `/api/m3u/generate` | -| Force provider-specific M3U regeneration | `/api/providers//m3u/generate` | \ No newline at end of file +| Force provider M3U regeneration | `/api/providers//m3u/generate` | +| Force all M3U regeneration | `/api/m3u/generate` | + +--- + +## ๐Ÿ†• Coming Soon + +- **EPG Support**: Full Electronic Program Guide data for all channels +- **More Providers**: Additional streaming services +- **Enhanced Caching**: Improved cache management and performance +- **Advanced Settings**: More configuration options for power users + +Stay tuned for updates! \ No newline at end of file diff --git a/addon.xml b/addon.xml index 275885b..ab2bc75 100644 --- a/addon.xml +++ b/addon.xml @@ -5,16 +5,31 @@ + + + executable - + + + - Backend service for Ultimate streaming providers + Backend service for streaming providers integration - Provides channel lists, EPG data and manifest information for various streaming providers. - Acts as a backend for Ultimate PVR and video addons. + Ultimate Backend provides a local API service that bridges Kodi with popular streaming providers. + + Features: + โ€ข Live TV streaming from Joyn (DE/AT/CH) and RTL+ + โ€ข DASH manifest rewriting for seamless playback + โ€ข DRM support (Widevine, PlayReady, ClearKey) + โ€ข M3U playlist generation for PVR IPTV Simple Client + โ€ข Provider-specific proxy configuration + โ€ข Caching system for improved performance + + This service runs in the background and enables live TV channels from streaming platforms + to appear directly in Kodi's TV section with full PVR integration. all GPL-3.0 @@ -22,5 +37,19 @@ https://example.com support@example.com https://github.com/yourrepo/ultimate-backend + en + + +- v1.0.0: Initial release +- Support for Joyn DE, AT, CH and RTL+ +- Manifest proxying and DRM handling +- M3U playlist generation for PVR IPTV Simple +- Provider-specific proxy configuration + + + + icon.png + fanart.jpg + - + \ No newline at end of file diff --git a/icon.png b/icon.png new file mode 100644 index 0000000..c8e2a6d --- /dev/null +++ b/icon.png @@ -0,0 +1,69 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ULTIMATE + + + + + + + + + +