github VortXTV/VortX v0.5.7
VortX 0.5.7: Account Recovery, Offline Playback and Better Browsing (Build 302)

53 minutes ago

VortX 0.5.7 – Account Recovery, Offline Playback and Better Browsing

Build 302 for Apple TV, iPhone, iPad, Mac, and Android phones, tablets and TVs. This stable release brings together the changes since 0.5.5, including profile recovery tools, AetherEngine on Apple devices, saved playlists, better add-on and subtitle handling, and playback straight from your downloads.

Fixed

Accounts, profiles and cloud sync

  • Older profiles that stalled at sign-in. Recovery recognizes tagged names and titles such as [RD] [4K] and preserves valid older display values. If a supported saved preference is unreadable, recovery sets it aside in the repaired copy. A name that cannot be read can display as “Untitled.” Recovery keeps the original encrypted backup and distinguishes missing data from an unreadable copy. #262 · #263 · #265
  • Accounts that stopped partway through setup or restore. Apple and Android can reopen a matching local account from the signed-in backup. Android brings back the choices to merge, use account data or keep device data. A queued upload stays queued, and local edits survive a request to sign in again. #263
  • First sign-in for accounts made on the website. Apple and Android check for an existing backup and its profiles before creating a first backup. If another device writes while setup is running, the app checks the newer copy and resumes with the matching account.
  • Staying signed in. Apple and Android renew a VortX session while you use it and retain the new session. Android keeps a saved session through a realtime connection failure. When the account service requires a fresh sign-in, profiles and Library show how to continue.
  • Android account setup and Add-ons. Sign-in, profile initialization and sync do more of their work away from the interface. If setup needs attention, the Add-ons screen opens VortX Account and keeps the manifest URL you entered. Completing setup makes installation available again. #270 · #277
  • Mac password and QR sign-in. The app can save sign-in information when the streaming server has already created the app’s support folder. #296
  • QR approval and retry. A temporary follow-up lookup failure on Android can be retried after approval. The approval stays with the sign-in that started it, so you can continue using the same code.
  • Equivalent settings and Watchlist dates. On Apple, a browser writing the same number differently can sync the original settings event, including person IDs in For You and collection rules. Apple and Android accept different decimal spellings of the same stored Watchlist time and preserve the original entry.
  • Encrypted backups. Cloud reads accept larger encrypted backups and preserve the account’s encryption format. Incomplete repairs and reads keep the last complete account copy, newer edits and pending history. Unknown saved fields are preserved.
  • Switching accounts and profiles. A late catalog, season, episode, source, settings, Continue Watching or Watch Stats response stays with the account and profile that requested it. Selecting a profile keeps the live updates and playback-progress sync working for that profile.
  • Stremio library and history. Connected Stremio accounts bring the owner’s saved titles and eligible watched history into the native Library, alongside add-ons. Library, Continue Watching, filters, search and title detail use the same saved result. Removed titles stay removed, and movies and series that share an ID keep separate resume points. Refresh Stremio import works after reopening the app. An interrupted import can retry from the original account. #267
  • Trakt connection and renewal. The app accepts compressed connection responses. When another device has just renewed a shared Trakt session, Apple and Android give sync time to receive it before prompting for sign-in again. Errors are clearer. Trakt watched history reads every page before replacing the saved list. #187 · #271
  • SIMKL and provider updates. A cancelled refresh keeps the last complete history. Pending provider Watchlist changes on Android can retry under the account that made them. Android keeps credential edits for debrid services and configured Usenet servers with the account whose settings you opened.
  • Recovery Tools on Apple. Mac opens the panel at a usable size. Apple TV puts Back, backup actions and Diagnostics within reach of the remote. File-selection cancellation returns control, recovery messages explain the next step, and a sole profile can open Tools, including a PIN-protected adult profile after unlocking it.
  • Recovery Tools on Android. Tools and the account controls remain reachable while profiles are loading or unavailable. Status, file choices and errors have readable contrast. Android TV focus can reach the next file action, and interrupted recovery can show its previous restore status after reopening.
  • Safer diagnostic exports. Limited diagnostics are available from the profile picker when profiles fail to open. Add-on addresses in exported diagnostics hide the path data that can contain configuration secrets. Ordinary Mac quits are recorded as normal.

Catalogs, artwork and the Library

  • Home and Continue Watching artwork. A genuine wide backdrop gets priority. Mac, iPhone and iPad can use the original poster when it is unavailable, and Android can fall back to original catalog artwork. Apple wide cards fit the portrait poster without cropping its title or hiding the rating badge.
  • Mac and iOS catalog grids. Wide cards and their columns now use the same width, which keeps labels and artwork from overlapping. The same layout setting applies in filmographies.
  • Discover and personal TMDB keys. Trending, Popular, Genres, Streaming Services, For You and public backdrop requests can use VortX’s catalog service when a custom-key request fails or times out. The fallback keeps your key on the direct TMDB request. Completed titles can still display when some metadata requests are slow.
  • Retrying catalog pages. On Mac, iPhone, iPad and Apple TV, leaving a catalog or switching its category retires the old request. A temporary failure offers Try Again for the affected page and keeps titles that have already loaded.
  • Library refresh. The initial results stay visible during refresh. Filters no longer change whether a title’s detail page knows it is saved. Downloaded episodes stay visible if season metadata is incomplete.
  • For You and Collections. An open interests editor is tied to the profile you started with. Unreadable local Collections stay on disk, an older import refresh cannot overwrite recent changes, and a broken catalog in one imported add-on leaves the remaining collections available.
  • Opening a title on iPhone. Large detail pages no longer build all of their information in one step, addressing a crash when tapping some movies. #279
  • Apple TV search from your iPhone. Remote keyboard input keeps the text you entered during search updates. #274

Add-ons, streams and subtitles

  • Multiple configurations of the same add-on. AIOStreams and other configured instances keep separate source sections and filters even when they share a name. An opened stream stays tied to the instance that returned it.
  • Add-ons that need more time. Apple and Android give stream requests up to 40 seconds. Fast results still appear as they arrive, and metadata keeps its own shorter timeout.
  • Updating and managing add-ons. Refresh manifest fetches the current configuration at its existing URL. Update URL changes the address. The active add-on stays until the update is confirmed. Turning an add-on off keeps it in the management list, and saving visibility changes gives feedback on the correct profile. Reinstalled native add-ons are no longer hidden by older removal records.
  • Self-hosted add-ons. User-selected LAN, localhost and Tailscale endpoints can be installed, loaded and restored on Apple and Android. Requests still check certificates and enforce destination and response limits.
  • Singularity sources on Apple. Eligible torrent rows can resolve through your connected debrid account even before they have a stream URL. Episode selections keep the requested season and episode. The Apple source list can page past the first 100 results.
  • Retrying subtitle add-ons. Reopening the subtitle menu can retry a provider whose request failed. Tracks that already loaded remain available. Public subtitle hosts with names starting in fc or fd are handled as hostnames.
  • Subtitle switching and timing. Manual selections take precedence over late automatic results. Subtitle preparation follows the current playback, track and account, including after an engine switch. Timing adjustments retain overlapping cues, and Android keeps embedded and external tracks when adding a sidecar or playing a download.
  • Saved seek previews. A fresh blank memory capture no longer replaces a good saved preview. Android ties preview work to the correct stream and limits download and image sizes.

Playback and platform fixes

  • Pause, resume and seek recovery. Mac playback resumes after replacing a stream and keeps its original position. Apple seek and mid-play recovery share a retry limit so the same failed point cannot reopen indefinitely. An unfinished episode keeps its place.
  • Short add-on error clips. A short response in place of a full movie or episode no longer marks the title watched, clears its resume point or advances to the next episode. Short titles with matching runtime information still complete normally.
  • Trailers during playback. On Apple, Home and details stop ambient trailer work while a full-screen video plays. Late results are retired when you leave a title. A trailer that repeatedly seeks with an empty buffer stops sooner and leaves the artwork visible. Silent previews stay out of the playback audio session.
  • Skip Intro, recap and credits. Apple and Android use IntroDB v4 and apply the response to the correct episode. Apple TV timing updates and Android cached timings follow the current episode. On Mac, Skip stays above the player controls when the mouse moves. #266
  • Player controls and auto-hide. Apple controls follow the current interaction. On Apple TV, Up reveals the controls promptly, and Up Next work starts when the prompt is eligible to appear. Track badges follow the current load and wait for its track list.
  • Android TV Back and controls. Back dismisses visible playback controls before leaving the player. While playback is active, controls hide after three seconds and stay available while a control sheet is in use. The behavior applies to the Full and Play players. #297
  • Apple TV Top Shelf after signing. Full can use the shared group granted to the app and extension, and can refresh from a saved snapshot after launch. Progress, queue and artwork changes update the shelf. Movies and series keep separate identities, and long lists are trimmed after validation. Trakt and SIMKL rows use a trusted shared container. Signing setups that only support the local fallback can still show eligible local rows. #229
  • Mac startup and shutdown. A player callback that could crash before the profile picker now uses the right thread. Mac quits wait for their owned streaming server to shut down, and restarts are bounded. A background notification handling crash on Apple is also fixed.
  • Android TV Play Next and episode alerts. Play Next tracks the profile that started playback, retires rows owned by a previous profile and keeps movie and episode identities distinct. Scheduled episode alerts also follow the profile that requested them.
  • Finding and opening app updates. Apple recognizes build numbers in GitHub release notes when a feed is behind. The Mac update button no longer crashes when opening the browser, and Apple TV opens the page for the selected release. Android separates Full and Play update choices, and AltStore package generation recognizes the versioned AetherEngine framework.

New

  • AetherEngine on Apple. The Apple TV Full and Lite player option is also available on iPhone and iPad with iOS or iPadOS 18 or later and on Mac with macOS 15 or later. Choose it in Settings > Playback > Player engine, for one source, or from the in-player settings. It carries your resume position and subtitle selection. If it cannot play a source, VortX Player can continue on the same source and position. Auto is the default. Picture-based PGS tracks can be played with VortX Player.
  • Add-on subtitles in the built-in players. Installed subtitle add-ons can supply tracks to Apple and Android playback. Automatic alignment uses the source and tracks that are actually playing when reference timing is available. Android also offers community subtitle fallback and consent controls.
  • Keyboard shortcuts. With focus in the player, use Space or K to play or pause, J and L to seek, M to mute, C to toggle a preferred subtitle track, S to skip an available intro, recap or credits, A for audio and T for subtitle controls. P and N select available adjacent episodes, I shows playback information, V cycles aspect and [ or ] changes playback speed where supported. Apple also supports F for full screen where available. Android has percentage jumps on 0–9 and O for picture-in-picture where supported, and keeps arrow keys for TV navigation.
  • Session audio presets. Normal, Dialogue and Night in the MPV audio controls adjust compatible output paths for the current playback. Dialogue emphasizes speech and Night softens loud peaks. The options depend on the active player and audio route.
  • Google Cast. On iPhone and iPad, hand playback to a Cast receiver and take it back. Android supports compatible self-hosted Cast sources and can cast eligible torrents through a selected streaming server. Progress follows the active video when returning from Cast.
  • Play Download on the title page. Open a downloaded movie or episode and choose Play Download on Apple and Android. Continue Watching resumes the matching local file offline. Autoplay can advance through downloaded episodes, including across a known season boundary when the next file is available.
  • Choose a Mac downloads folder. Save new downloads to a selected folder on your Mac or a connected drive, including supported exFAT drives. If that drive is unavailable, the app asks you to reconnect it before trying again.
  • Playback queues. Choose Play next or add a title to the end of the queue, then manage upcoming titles in the player. Queues are saved on the device for the account and profile and can advance after normal playback completion.
  • Saved playlists. Create named playlists, arrange titles and sync the playlist with its profile on Apple and Android. Playlist edits are kept with the profile that opened them.
  • Surprise me and random picks. Home can pick an unwatched title from loaded recommendations and visible catalogs, then open its title page. Apple and Android can pick a title from Library or an episode from a show, with separate actions to open the pick or play it.
  • A richer Quick View. Mac, iPhone and iPad show larger artwork, a title logo when available, compact facts and genres, a cast row and View streams. Mac and iPad use a wider floating panel. Android keeps artwork clearer in its preview.
  • Artwork while a video opens. Apple and Android show the selected title’s artwork or logo until playback starts. Startup artwork keeps controls, loading errors and Back reachable.
  • Playback badges. Icons, playback details and the selected audio language describe the video and tracks actually playing, then reset for the next item.
  • Library genres and source filters. Filter saved titles by genre. Apple and Android offer optional source filtering by title match for release names. You can also narrow the display of source results without changing the stream you already selected. #172
  • Richer Collections. Create and browse nested groups with their own ordering, artwork and presentation. Compatible Xperience Collections can be imported or refreshed in the editor on Apple and Android. The VortX catalog service supplies bounded default Collections through its existing catalog access. #269
  • Profile picker Tools. Download an encrypted backup, prepare and save a separate repaired copy, restore after reviewing the replacement, verify an uncertain restore, or export diagnostics. Sign in and Sign out are separate controls. On Apple TV, scan the Tools QR code with a phone on the same trusted local network to move backup files, then review the restore on the TV. Android uses the system file picker and offers backup-recovery sign-in on eligible Android 14 or later devices. Available actions follow your device, sign-in and profile protection.
  • Searchable Apple TV Settings categories. Settings is organized into focused sections and keeps search. #268

Changed

  • Faster startup and less background work. Accounts with a readable local copy can open from it and catch up with the cloud afterward. Apple defers nonessential work until after the splash animation. Home, Discover, catalog sorting, preview wakeups and episode checks do less repeated work, and Android profile refresh moves off the interface thread.
  • Fewer uploads while watching. Local progress still saves during playback. Cloud updates batch in the background, and pausing or stopping brings the next upload forward so other devices can pick up your place.
  • Lighter player glass. On Mac, iPhone and iPad, player chrome is more translucent with clearer time labels. Shared control styles keep disabled buttons legible and respect Reduce Transparency and Effects Off. Desktop text contrast is improved in the source.
  • Updated playback components. Apple and Android Full use the updated custom mpv/libplacebo stack with FFmpeg 9.0.2. Android Play uses Media3 1.11.1. Subtitle, font and codec components received updates, with tighter transport certificate checks.
  • Native app internals. Apple and Android use the VortX engine throughout. The retired comparison engine, Node helper and legacy web-host target were removed from their package paths. Stremio-compatible add-ons, Cinemeta and optional Stremio account import continue to work. Apple native builds use Swift 6 checking, with further improvements to how playback, profile and background tasks handle late results.
  • Dashboard add-on changes. The website now keeps the latest pending change per add-on and preserves the order you set. A valid queue filled by duplicate changes compacts on the next accepted edit. Refresh the dashboard and retry if you hit that message. Devices pick up the saved changes on their next sync. The dashboard also shows the actual backup revision. Add-ons dashboard · Queue change
  • Web and desktop source work. The source includes expanded keyboard controls and account/add-on recovery on Web and desktop, tighter browser session and account boundaries, bounded desktop diagnostics, and native-only desktop engine wiring. Watch Party preparation is in the source for a future service launch.
  • Release and component verification. Build checks now cover more native packages, component provenance, archive content, signing, account recovery, source and subtitle ownership, and per-platform release feeds. Dependency tracking records release history across more native inputs.

Please test

  • If your existing account stalled at the profile picker, try signing in and opening Tools on your usual device. Try the applicable backup or verification actions and check that your profiles, Library and add-ons load. For a repeat failure, share a diagnostic export before changing the account.
  • On Apple TV Full, try Continue Watching in Top Shelf after signing with your usual tool. If the shelf stays static, include the signing tool and variant in your report. On Android TV, try Back with playback controls open and check that you can navigate Tools with the remote.
  • On Mac, check a wide catalog and Continue Watching with your usual TMDB settings. Try a movie or episode with a downloaded file from its title page, resume it offline, and try autoplay with the next episode already downloaded.
  • While playing, try a preferred subtitle with C, an add-on subtitle track, and switching Apple players while retaining the current position.
  • On the website, try adding or reordering add-ons, then check that your app receives the changes on its next normal sync.

Install

Mac (.dmg). Download VortX-macOS-v0.5.7-ci.dmg and drag VortX into Applications. The Apple-silicon app requires macOS 14 or later and has an ad hoc signature without notarization. If macOS blocks the official download, use System Settings > Privacy & Security > Open Anyway, or clear the quarantine flag on that copy with:

xattr -dr com.apple.quarantine /Applications/VortX.app

This clears the download flag. The signature and notarization status remain as packaged. Install on Mac

iPhone, iPad and Apple TV (.ipa). Use VortX-iOS-v0.5.7-ci.ipa on iPhone and iPad with iOS or iPadOS 16 or later. On Apple TV, use VortX-tvOS-v0.5.7-ci.ipa for Full with Top Shelf or VortX-tvOS-lite-v0.5.7-ci.ipa for Lite with direct links. Apple TV requires tvOS 18 or later. The IPAs require compatible sideload signing. Use the same app variant when updating. Installing on iPhone, iPad and Apple TV

Android phone, tablet and TV (.apk). Use VortX-0.5.7-full-mpv-universal.apk for Full with mpv or VortX-0.5.7-play-media3-universal.apk for Play with Media3. Each APK includes phone, tablet and TV interfaces and requires Android 8.0 or later. Keep the same app variant and signer for an in-place update. VortX-0.5.7-play-media3.aab is for store distribution.

Verify any download against the checksums. The CI provenance records the exact source and build behind each package. SHA-256 checksums · CI provenance

Compare the source changes since 0.5.5

Don't miss a new VortX release

NewReleases is sending notifications on new releases.