Skip to content
Projects

vantaflow/ultra-tv has 84 GitHub stars and 23 forks. GitHot measured +10 stars in 24 hours. Last checked 2026-11-15 17:11 UTC. Last push 2026-11-13.

How these counts are measured

84 stars23 Forks +10 in 24h

Measured star growth

in 24h
+10
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Lecteur IPTV pour Android TV / Google TV, smartphone, tablette, Windows et Mac — Xtream Codes et M3U. Guide TV, replay, pause du direct, profils, Google TV, multilingue.

Web & Apps

README.en.md

Original

Ultra TV

Ultra TV

Free, open-source IPTV player for Android TV, phones, tablets, Windows and Mac — no ads, no account, built for the remote.

CI Release MIT licence Site

🇫🇷 Version française · Website · Download the APK · Releases · Changelog (French)


Download

Device Link
Android TV, Google TV, boxes, Fire TV, Android phones and tablets (Android 9+) See « Which APK? » below · on a box: Downloader app, code 5189921
Windows (x64) .exe installer
Mac (Apple Silicon and Intel) .dmg disk image
Linux (x86_64) AppImage · .deb (Debian, Ubuntu) · .rpm (Fedora, openSUSE) · Ubuntu 22.04+: sudo apt install libfuse2 if the AppImage doesn't start

Automatic updates afterwards, on every platform. No account needed.

Ultra TV plays your own IPTV subscriptions (Xtream Codes, M3U / M3U8 as a link or a file, Stalker / Ministra portals by MAC address). The whole interface is native and built for the remote; the catalogue (channels, movies, series, guide, history, favourites) lives in a local Room database. It provides no content at all.

Screenshots of the new interface (1.2.98), rendered with an entirely fictional catalog: made-up channels, categories, programmes and titles. Ultra TV provides no content.

Home Player channel list TV guide Sport section Movies by category Movie details Series details: seasons and episodes Movie player Live TV overlay Settings Who's watching?

The same screenshots exist in French (docs/screenshots/fr) and in Arabic, with a mirrored interface (docs/screenshots/ar).

Features

  • New interface (1.2.98) on TV, phone, tablet and desktop: redesigned dark and light themes, home screen with “Featured” and shortcuts, live TV overlay (recent channels, current programme, “Up next”, evening ribbon), channel list as a side sheet, TV guide filtered by category, redesigned movie / series pages and players, short opening animation.
  • Sport (optional section, Settings › Display, on TV and desktop): live and upcoming matches over 48 h from your sources' guide, by discipline, with reminders, recordings and team badges (TheSportsDB).
  • Search from any screen: a button at the top of the side rail, plus the remote's Search and microphone keys.
  • Live TV: video preview of the selected channel in the list (with sound, adjustable delay), OK switches it to full screen without reloading the stream; Up/Down zap, OK opens the channel list, Channel +/− and TV keys of Google TV remotes; channel and programme banner; number zapping, Back returns to the menu (Last channel key recalls the previous one), 20 recent channels, instant search (FTS).
  • Categories: names and playlist order exactly as the source provides them, enable / disable / reorder, text filter ("FR" = whole word); quality badges (SD, HD, FHD, 4K, RAW, HEVC…) to tell apart streams of the same channel.
  • Guide: time grid, reminders, scheduled recordings, replay (Xtream catch-up) from the guide when the source allows it. Programme borrowed from a channel with the same name when the provider only tags one category (HEVC, General…), "+1 / +2" channels shifted accordingly, the provider's short EPG as a fallback, and a free additional guide (XMLTV France by default, epgshare01 beIN Sports / Saudi Arabia / UAE) for channels still without a programme.
  • Live pause (timeshift): circular disk buffer for MPEG-TS streams.
  • Movies and series: rich details through TMDB (poster, plot, cast, trailer, in English when none exists in your language), official title logo and HD backdrop through Fanart.tv, a series' next episode (date, title) through TVmaze, automatic resume (position saved every 30 s), seasons as tabs, rows by category.
  • Skip intro: “Skip intro”, “Skip recap” and “Next episode” buttons during intros and credits, from TheIntroDB (community database, no key).
  • IMDb / Rotten Tomatoes ratings on detail pages (OMDb through the Worker), actor and director pages (their titles found in your playlist).
  • Home: rotating “Featured” banner, a “New episodes” row (favourite or in-progress series with an episode out or due within 7 days), “Because you watched…” and “Top rated movies / series” rows; movie and series filters (sort, minimum rating, decade); typo-tolerant search (“brekin bad” → Breaking Bad).
  • Custom guide: an XMLTV guide address (http:// or https://, ending in .xml or .xml.gz, a query string is fine). Two uses. (1) Additional guide: Settings › Synchronization › Additional guide › Custom address… (read only for channels still without a programme). (2) Guide of this source: Settings › Sources › (the source's menu) › Guide of this source, in replace mode (only this address is read) or complete mode (the provider's guide first, then this address for channels without a programme); handy for an M3U playlist without url-tvg and for a Stalker portal, which has no XMLTV guide of its own (channels matched by epgChannelId, otherwise by name). The address is checked before it is saved (network request, gzip detected, a <tv tag is required; clear message if unreachable, HTTP code or not an XMLTV guide). Enter it with the remote, from your phone (the /envoyer page, XMLTV guide type, for the additional guide) or on desktop (Settings › Synchronization, and a source's Advanced options).
  • Send from your phone, no account: the TV shows a QR code and a code; type the playlist (Xtream, M3U or Stalker) on your phone or computer (the Worker's /envoyer page) and the TV adds and syncs it. No more typing with the remote.
  • Phone remote and search (Settings › Sources): the box serves a page on the local network (QR code) to search movies, series and channels and control playback; off by default, protected by a key.
  • Simple mode: six large tiles (Live TV, Resume, Movies, Series, Favorites, Search), per profile.
  • Memory & storage: detailed storage use, RAM, cache and database clean-up, memory-saving mode for modest boxes, Optimise images (Fanart.tv / TVmaze logos and backdrops served as right-sized WebP by wsrv.nl; can be turned off).
  • Hidden categories are never loaded: a disabled category (by its language or by hand, separately for Live, Movies and Series) is neither stored nor indexed: faster sync, less memory.
  • Movies and series by automatic genres: category or detected-genre list (Action, Comedy, Anime…) with title counts, poster grid, sorting and filters.
  • Downloads (Android): movies, episodes or a whole season; queue with pause, resume, cancel and retry, resume after a dropout, optional Wi-Fi only; a « Downloads » screen that works offline.
  • Two playback engines: ExoPlayer (Media3) and LibVLC; Auto / ExoPlayer / VLC, decoding Auto / Hardware / Software, automatic fallback and per-channel memory.
  • Subtitles: online search (OpenSubtitles through the Worker), advanced style (size, colour, background, outline, position, offset). Nothing to set up on the device; a personal OpenSubtitles account can be linked from the cloud dashboard if needed.
  • Trakt: movies and episodes you watch are sent to Trakt (watching, then watched at the end); on Home, your Trakt watchlist, recommendations, trending, popular, personal lists and Up next, limited to titles available in the loaded playlist; a "Watched" mark; from detail pages: add / remove from the watchlist, mark watched / unwatched (movie, episode, season), rate 1–10; resume positions imported. Connect from the cloud dashboard, nothing to set on the TV.
  • Profiles: "Who's watching?", Kids profile, per-profile favourites, history and languages.
  • Subscription (menu): your IPTV subscription as reported by the provider — status, expiry date and days left, connections in use / allowed, trial account, server. Android, Windows and macOS.
  • Google TV, Android TV and third-party launchers: "Continue watching" (movies, episodes and recent live channels, cleaned titles, one tile per movie), Favorites home channel (favourites then recent channels) and New releases channel (latest movies and series added, no duplicates), voice and global search, ultratv:// deep links. These rows go through Android's TV provider, so launchers that read it (Kairo…) show them too.
  • Playback: no sleep during a movie or live TV, pauses when you leave the app (no background audio); clock without offset and adjustable time zone (Settings › Display).
  • Themes Dark / Light / Black (OLED) / Automatic (the player always stays dark); interface in English, French, Spanish and Arabic (RTL), plus Polish and Brazilian Portuguese (community first drafts).
  • Personalisation (Settings › Display): accent colour (12 choices), text size, time format (Automatic, 12-hour or 24-hour), Home rows (show, hide, reorder), start screen (Home, Live, Movies, Series, Guide, last channel or last screen used; also on desktop).
  • Custom DNS (Android and desktop): Google, Cloudflare, Quad9, DNS-over-HTTPS or your own server; applied to catalogue, guide, images and streams (on Android: ExoPlayer streams, not VLC; Test button), automatic fallback to the system DNS.
  • Sleep: 30 / 60 / 90 min timer or end of programme; built-in update from GitHub releases.

Devices

One account, all your screens: same interface, same provider everywhere. Add it once in the cloud dashboard and every device receives it.

Android TV and Google TV

The original app, driven by the remote (see the screenshots above and Features).

Android smartphone

Touch interface: bottom navigation bar, lists and grids by finger, gesture player with picture-in-picture; forms sit above the keyboard.

Home on smartphone Live TV on smartphone Movie details on smartphone Player on smartphone

Android tablet

Side rail, list and details side by side.

Live TV on tablet Home on tablet

Windows and macOS

The same design on desktop: the web app in web/ packaged with Electron (electron/). On the web, only the management dashboard is offered (no player). Xtream Codes and M3U (link or file); catalogue kept locally (IndexedDB), credentials encrypted with the system keychain, direct playback (no remote proxy), automatic updates through GitHub Releases. Search: round button under the logo, shortcut Ctrl/Cmd + K or / from any screen. Sport, reminders and recordings: Sport section, “Remind me” (system notification) and “Record” (.ts file in Videos/Ultra TV, the app must stay open) from the guide and Sport, “Recorded” screen; Episodes button in the series player (E key).

Live TV on desktop Settings on desktop

All desktop screenshots (synthetic data, FR and EN): docs/screenshots/desktop/. Release: desktop-vX.Y.Z tag (workflow desktop-release.yml, separate from the Android v* tags).

Cloud dashboard

Manage devices and sources from a browser: https://tv.weedy.dpdns.org (the old address ultratv-config.khalilbenaz.workers.dev still works; the apps switch automatically if one is blocked on your network).

Paired devices Per-device source sharing

Xtream, M3U and Stalker portal sources (MAC address masked). Each device shows its model, edition, app version and last activity. Each Xtream or M3U source has a Show IPTV link button (full M3U link, on demand, with a Copy button) and its subscription (status, expiry date, days left, connections), read from the provider; lists are paginated and searchable as they grow.

Account section:

  • Trakt: Connect Trakt button, authorise on Trakt; your devices then send what you watch. Your Trakt password never goes through the site.
  • Subtitles · OpenSubtitles (optional): link your OpenSubtitles account, free or VIP, to use your own download quota instead of the shared one.

Pair in one scan: the TV shows a QR, the phone camera opens the pairing page with the code already filled in. The code can also be typed by hand, with or without the dash.

Pairing confirmation with the code pre-filled Dashboard on a phone, light theme

Multi-device sync

  • Same provider everywhere: a provider added in the dashboard is received by every device on the account.
  • Device-only source: a source added on a device stays private to it until you share it.
  • Sharing chosen per device: source by source, tick the receiving devices (in the app: Settings › Sources › Share this source; or in the dashboard).
  • Shared categories: enabling or disabling a category on one device applies to the others (latest change wins).
  • Shared favourites, resume points and recently watched: a movie started on the TV resumes at the same spot on the Mac; a favourite added or removed is everywhere. Per account source, profiles matched by name.
  • Account changes are serialized on the Worker (Durable Object lock): two devices writing at once do not overwrite each other.

Downloads

Device File
Android (TV, smartphone, tablet) UltraTV-arm64-v8a.apk (default), UltraTV-armeabi-v7a.apk (32-bit), or the universal UltraTV.apk; versioned files UltraTV-<version>-<abi>.apk with their precompiled profile .dm, plus SHA256SUMS.txt
macOS UltraTV-<version>-mac-universal.dmg (Apple Silicon and Intel)
Windows UltraTV-<version>-win-x64.exe (NSIS installer)
Cloud dashboard https://tv.weedy.dpdns.org (nothing to install)

Everything is on the Releases page (desktop files carry desktop-v… tags).

Installation

Android 9 or newer (API 28).

APK. Download UltraTV-arm64-v8a.apk (SHA-256 sum on the release page) and install it. If the install fails (32-bit device such as the Chromecast with Google TV HD), take UltraTV-armeabi-v7a.apk; as a last resort, the universal APK. The in-app updater picks the right build for your device.

Downloader (boxes without a browser): open the Downloader app, enter the code 5189921, allow unknown sources, install.

adb:

adb connect BOX_IP:5555
adb install -r UltraTV.apk

adb, faster startup (Android 12 or newer): install your processor's APK together with its precompiled profile .dm (same name, published in the release). Android then compiles the app at install time instead of waiting for a background optimisation. Measured on a 2 GB box: startup 1.1 s → 0.6 s, noticeably smoother scrolling.

adb install-multiple -r UltraTV-<version>-armeabi-v7a.apk UltraTV-<version>-armeabi-v7a.dm

On first launch: choose the source type (Xtream Codes, M3U link, M3U file, Stalker portal or From the cloud), enter it, then choose your categories (only active categories are downloaded).

An address like …/get.php?username=…&password=… pasted as an M3U link is recognised and added as an Xtream Codes source (many providers block get.php).

Which APK?

Your device APK Short link (type it in Downloader)
Recent Fire TV Stick, Shield, most recent boxes and phones (64-bit) arm64 (≈ 67 MB), recommended tv.weedy.dpdns.org/download/android-arm64
Chromecast with Google TV (HD), older boxes (32-bit) 32-bit (armv7) (≈ 52 MB) tv.weedy.dpdns.org/download/android-32
You do not know Universal (≈ 227 MB), last resort tv.weedy.dpdns.org/download/android-universal

tv.weedy.dpdns.org/download/android returns the arm64 APK. In Downloader, enter the code 5189921 or one of the short links above. If the install fails, take the 32-bit version.

Installation impossible (« package problem »)

  • Free space: keep at least 500 MB free; the universal APK (227 MB) needs more than the per-CPU APKs.
  • Wrong APK: on a 32-bit device (Chromecast with Google TV HD), take the 32-bit APK (android-32) rather than the universal one.
  • Older version signed differently: uninstall the old Ultra TV first (Settings › Apps), then reinstall. Your sources stay in the cloud if you enabled it.
  • Truncated download: compare the file size with the release's, and its SHA-256 with the .sha256 file (or SHA256SUMS.txt) published alongside; download again if they differ.
  • Android 9 minimum: older versions are not supported.

Cloud sync

To avoid typing credentials with a remote, manage your sources from a browser: https://tv.weedy.dpdns.org (the address is also shown in the app, with a QR code: Settings › Sources).

  1. Create an account on the dashboard and add your sources.
  2. In the dashboard, choose Pair a TV.
  3. On the box: From the cloud (Source step of the wizard) or Settings › Sources › Sync from the cloud. An 8-character code is displayed; enter it in the dashboard.
  4. The box imports the configuration, then syncs.

The device receives a random 256-bit token (hashed on the server, encrypted in the Keystore, revocable). Revoked device (lost, lent, sold): at its next check (back to the app, within 10 min at most), it removes the sources received from the cloud, forgets the pairing and says so; sources added by hand on the device stay. Your credentials are encrypted on the server side (AES-256-GCM). The label shown for the box ("UTV-XXXXXX") is only a name, never a key.

Self-hosting. You can deploy your own Worker (see Cloudflare Worker): create the KV namespaces, set the SESSION_SECRET, PROVIDER_ENC_KEY and OPS_TOKEN secrets (no value is published here), then wrangler deploy; in the app, Settings › Sources › Dashboard address then points to yours.

Security

  • Source credentials encrypted at rest on the device; AES-256-GCM on the Worker.
  • No stream URL and no credential is displayed or logged; error messages are filtered (UserText). An empty source name does not fall back to the server address.
  • No shared token in the APK. Details, threat model and rotation of old secrets: SECURITY.md.

Privacy

Ultra TV provides no content: you add your own sources (Xtream Codes, M3U, Stalker portal) and the app talks directly to your provider. It contains no ads and no third-party analytics library. The "Worker" is the cloud configuration server (cloudflare-config/), hosted on Cloudflare; its address can be changed in Settings › Sources › Dashboard address.

Your IPTV credentials

The server address, username, password, stream URLs and the MAC of a Stalker portal are sent only to your provider, except in two intended cases:

  • Cloud sync: on a paired device, a source is sent to the Worker only if you share it (offer shown after adding, or the share button) or add it from the dashboard. It is stored encrypted (AES-256-GCM, server-side encryption with a Worker secret key: not end-to-end). When you open the dashboard, the Worker itself queries your provider with these credentials to show the subscription status. If your provider blocks Cloudflare servers, this request goes through a relay hosted on Vercel (code in cloudflare-config/relay/): it receives the address and credentials for that request only and does not store them.
  • Send from your phone: the source typed on the web page is encrypted, kept for 15 minutes at most and deleted as soon as the TV receives it.

Logs and crash reports are scrubbed (username, password, token… parameters, user:password@, /live/user/password/ paths) in the app, then again by the Worker. Limit: a server's domain name can remain in an error message. Adding a Stalker source only sends journey events ("add attempt", success or failure, error class), never the portal's host name.

What the Android app sends on its own

What When To Content Turned off by the setting
Anonymous install count ≈ 10 s after start, at most once per 20 h, unpaired device Worker /api/anon/ping random install ID, version, app in use (android-tv or android-mobile), device model (manufacturer + model, 64 characters at most) Yes
Diagnostic logs during use, paired device Worker /api/event level, tag, scrubbed message (start, screen shown, smoothness metrics, freezes, key counters, Google TV, update, sync failures), version, model, device label Yes
Crash reports on crash (or next start), paired device Worker /api/crash scrubbed stack trace, version, model, Android version Yes
Update check 30 s after each launch, or on request api.github.com, then GitHub request without identifier; if a newer version exists the APK is downloaded and Android's installer asks for confirmation No
Alerts (read) on open, then every 15 min in the foreground Worker /api/announcements screen type, version No
Alerts (statistics) alert shown, dismissed or button used Worker /api/announcements/<id>/stat event type, random install ID Yes
Extra guide during guide sync, if channels have no programme xmltvfr.fr (default) file download; changeable, custom address possible (and a guide per source): Settings › Synchronization. Only the host of an address is shown, the full address is never logged No
Skip intro when opening a movie/episode (TMDB id known) api.theintrodb.org TMDB id, season, episode, duration No
TMDB details, ratings when opening a details page, paired device Worker /api/tmdb, /api/ratings cleaned title, year, language, or TMDB id No
Logos and backdrops (Fanart.tv), episodes (TVmaze) when opening a details page or the home screen, paired device Worker /api/fanart, /api/tvmaze/show TMDB, TheTVDB or IMDb id of the title, language No
Team badges (TheSportsDB) Sport section enabled, paired device Worker /api/sports/team team name as written in the guide No
Images (posters, logos, backdrops, badges) on display image.tmdb.org, assets.fanart.tv, static.tvmaze.com, www.thesportsdb.com, wsrv.nl image request sent directly from the device, nothing else transmitted No
Online subtitles only on Search online, paired device Worker /api/subtitles title, languages, year No
Cloud sync paired: at launch, every 6 h; favourites and history ≈ 60 s after a change then every 10 min Worker device token, version, edition; display settings; favourites and history per profile (title, poster address, position, duration) No (unpairing stops it)
Trakt while playing a movie/episode, paired device Worker /api/device/trakt action, progress, title, year, TMDB ids, season, episode No
DNS only if you pick a DNS other than the system one (Settings › Playback) Google, Cloudflare, Quad9 or yours domain names No

Images supplied by your source are loaded directly from the addresses it gives.

Windows and macOS

No crash report, remote log or alerts. Anonymous count (same rule as Android): at most once per 20 h, unpaired device only, to the Worker /api/anon/ping; it sends a random install ID kept on the device, the version and the system (windows, macos or linux). It turns off in Settings › About › Anonymous telemetry (on by default): nothing is sent any more and the ID is erased. Other sends: update check (api.github.com, 5 s after launch then every 6 h; on by default, it can be turned off in Settings › About › Check for updates automatically, the manual check button stays usable), cloud sync, Trakt, TMDB and ratings through the Worker (paired device), "Skip intro", fallback posters and the chosen DNS.

What the Worker keeps

  • Account: login, PBKDF2 password hash, country (code supplied by Cloudflare), dates; until the account is deleted. Devices: token hash, name, model, version, country, last activity.
  • Sources, Trakt and OpenSubtitles tokens, shared favourites and history: encrypted, until deleted.
  • Diagnostic logs: 7 days; crash reports: 30 days. They hold device ID, an account fingerprint (non-reversible HMAC, never the account ID or e-mail address), country, version, model, a device label derived by hashing the Android ID.
  • Anonymous count: hash of the install ID, dates, version, app in use (Android TV, Android mobile, Windows, macOS, Linux), device model (Android), country, number of sources sent from the web; 180 days. Alert statistics: hash, up to 31 days after the alert ends.
  • Send from phone: 15 min at most. Pairing code: 10 min.
  • IP address: not written to any stored data; used only to count requests (rate limiting) in counters that hold no address and expire on their own.

Turning telemetry off

Settings › About › Telemetry and crash reports (on by default; on Windows and macOS the setting is called Anonymous telemetry and only covers the anonymous count). Off: no more diagnostic logs, crash reports, anonymous count or alert statistics, and no install ID in send-from-phone. It does not turn off the update check, reading alerts, cloud sync, Trakt, TMDB, subtitles, "Skip intro", the extra guide or DNS. Without pairing, no log or crash report is sent anyway.

Check it in the code

Every point above can be checked in the source code (links pinned to a specific version):

Claim Where to see it
On the device, your sources' passwords are encrypted (AES-256-GCM) with a non-exportable Android Keystore key SecretBox.kt
Sending from the phone: the code is valid for 15 minutes index.js — ENVOI_TTL_S
… the source is encrypted before being handed to the relay index.js — encryptJson then envoiPut
… delivered once to the TV, then deleted (envoiTake removes the entry) guard.js — envoiInit / envoiPut / envoiTake
Cloud sync: sources stored encrypted (providersEnc) store.js — loadProviders / saveProviders
Account passwords: only a PBKDF2 hash is kept crypto.js — hashPassword
Anonymous count (Android): a random install ID, version, app (TV or mobile) and model, nothing else AnonPing.kt — request body
Anonymous count (desktop): random ID, version and system, at most once per 20 h, never when paired, setting respected anon.ts — reportAnonPing
… nothing is sent when telemetry is off AnonPing.kt — telemetryEnabled
The Worker only keeps the country code provided by Cloudflare, never the IP address index.js — countryOf

Questions or doubts about this code? Open an issue and it will be answered publicly.

Automatic tuning

On first launch, the AdaptiveProfile measures the device (memory, heap, micro-benchmark) and rates it Low / Medium / High. From that it derives buffer, parallelism and sync batch size, resolution and bitrate caps (low-memory boxes: 720p / 6 Mb/s) and adjusts the buffer if drop-outs occur. Everything stays adjustable: Settings › Playback (engine, decoding, buffer preset: Low latency, Auto, Balanced, Stable, Custom).

Help translate

The interface is available in French, English, Spanish and Arabic (official languages), and in Polish and Brazilian Portuguese (community languages, first drafts awaiting review). More languages are welcome: they can be partial, and English is shown for missing texts.

Translation status

The full guide is in TRANSLATING.md.

For developers

Stack: Kotlin · Compose for TV · Media3 (ExoPlayer) + LibVLC · Room · Hilt.

JDK 17 required.

git clone https://github.com/vantaflow/ultra-tv && cd ultra-tv/android-native
export JAVA_HOME=$(/usr/libexec/java_home -v 17)   # macOS
./gradlew assembleDebug                            # universal APK
./gradlew testDebugUnitTest                        # unit tests (JUnit, Robolectric)
./gradlew assembleRelease                          # per-ABI APKs (arm64-v8a, armeabi-v7a, x86_64)
  • The version comes from the VERSION file; versionCode = major×10000 + minor×100 + patch (1.2.0 → 10200), identical for every ABI.
  • Fake Xtream server to test without a subscription: python3 android-native/tools/fake-xtream/server.py (the emulator reaches it at http://10.0.2.2:8099, credentials test / test); demo.py serves the synthetic data set used for the screenshots.
  • Debug build: debug intents (debug_route, debug_theme, debug_lang, debug_engine, debug_decoder, debug_buffer…) for screenshots and measurements.
  • CI (ci.yml): web (tsc + vitest), Android (compile + unit tests), Worker. Publishing: release.yml on a v* tag (universal UltraTV-debug.apk, per-processor UltraTV-<version>-<abi>.apk and SHA256SUMS.txt); website: pages.yml.

Cloudflare Worker

cloudflare-config/: pairing dashboard, encrypted source storage, crash ingestion, TMDB and OpenSubtitles proxies. Full procedure: cloudflare-config/README.md.

cd cloudflare-config && npm ci
wrangler kv namespace create CONFIG                # paste the ids into wrangler.toml
wrangler secret put SESSION_SECRET                 # >= 32 random characters
wrangler secret put PROVIDER_ENC_KEY               # AES-256 key, base64
wrangler secret put OPS_TOKEN                      # password for /crashes and /logs
wrangler secret put TMDB_READ_TOKEN                # TMDB v4 read token (rich details)
wrangler secret put TMDB_API_KEY                   # TMDB v3 key (fallback without a v4 token)
wrangler secret put OPENSUBTITLES_API_KEY          # OpenSubtitles key (online subtitles)
wrangler secret put ACCOUNT_RELAY_KEY              # optional: subscription relay outside Cloudflare (cloudflare-config/relay)
npm test && wrangler deploy --dry-run

TMDB and OpenSubtitles are optional: without their secrets, the app hides the matching features. Trakt uses TRAKT_CLIENT_ID (wrangler.toml, Trakt app in PKCE mode: no client secret). For a fork, build with -PULTRA_WORKER_URL=https://your-worker.workers.dev.

Known limitations

  • Replay and live pause depend on the source (Xtream catch-up, MPEG-TS streams); unavailable otherwise.
  • TMDB details and online subtitles require a Worker configured with the secrets above.
  • An episode started on the TV shows up in "Resume" on the computer once the series has been opened there at least once.
  • No free guide covers Moroccan channels (2M, Al Aoula…): only the provider's guide does.
  • The first sync of a very large catalogue (≈ 55,000 channels) takes about a minute on a mid-range device and longer on an entry-level one.
  • The APK grows with LibVLC (≈ 53 MB in arm64-v8a, against ≈ 9 MB in 1.0.x).
  • Measurements published in the release notes come from Android TV emulators (software rendering): to be confirmed on real hardware.

Licence

MIT, see LICENSE. Ultra TV is an IPTV client: only use playlists, guides and credentials you are entitled to use. The Sora and Manrope fonts are under the OFL licence.