NodeCast TV Plus v2.2.1
NodeCast TV Plus v2.2.1
NodeCast TV Plus v2.2.1 is a compatible patch release focused on provider-data integrity, login usability, transcode startup flexibility, and resilient movie/series playback.
Highlights
- Prevent XMLTV/EPG identifier collisions from replacing Xtream channel names and logos, and repair affected metadata during source synchronization by @MikaelKW in #111.
- Allow slower providers to use a configurable transcode startup timeout while retaining the existing default by @MikaelKW in #114.
- Accept capitalization differences during local-account login without changing the stored username display by @MikaelKW in #117.
- Recover interrupted movie and series HLS playback through bounded reconnection, media recovery, and stream-proxy fallback by @MikaelKW in #120.
- Document and automatically validate supported upstream migration paths by @MikaelKW in #106.
- Improve release-note traceability, lineage references, and section layout by @MikaelKW in #103.
Upgrade from v2.2.0
Back up the existing /app/data volume, pull the release image, and recreate the container with the same volume and deployment secrets:
docker pull ghcr.io/mikaelkw/nodecast-tv-plus:2.2.1No manual database migration is required. Keep the existing strong, distinct JWT_SECRET and SESSION_SECRET values; changing them signs existing browser sessions out but does not remove accounts or application data.
Installations with slow transcode startup can optionally set TRANSCODE_START_TIMEOUT_SECONDS to a whole number from 1 to 300. Omitting it preserves the existing 15-second per-attempt default.
Available stable image tags after publication:
2.2.1— this exact release2.2— newest compatible 2.2 patch releaselatest— newest stable release
To roll back, restore the pre-upgrade data backup and recreate the container with 2.2.0 and the existing deployment secrets.
Validation
- Application, authentication, security, dependency, browser/media, Docker, release-metadata, and supported upstream migration checks passed.
- The Xtream/XMLTV correction was validated with distinct channel names, logos, EPG programmes, and playback before and after source refresh.
- A delayed controlled stream started successfully beyond the previous fixed transcode timeout.
- Case-insensitive login was validated on desktop and mobile while preserving the stored username spelling.
- A controlled A/B container upgrade reproduced the unrecoverable HLS stall on v2.2.0-era code; the patched build buffered for 3–5 seconds, recovered automatically, and completed playback under the same outage.
- Migration from the published v2.2.0 container was validated with a disposable persistent data volume, preserving the account, password, application settings, and deployment secrets without a manual database migration.
See the full changelog for complete change and upgrade details.