Skip to content

Releases: amirbrooks/tvtime-backup-extractor

TV Time Backup Extractor v0.2.0

Choose a tag to compare

@amirbrooks amirbrooks released this 20 Jul 01:57
42880c2

TV Time Backup Extractor v0.2.0 adds a native privacy-conscious macOS recovery workflow and a source-bound Python CLI release.

macOS:

  • Requires macOS 14 or later.
  • Apple silicon Macs use the arm64 DMG.
  • Intel Macs use the x86_64 DMG.
  • Both applications and DMGs are Developer ID signed, notarized, stapled, Gatekeeper-accepted, and bound to the tagged source commit.
  • Verify the downloaded DMG against SHA256SUMS before installation.

Privacy:

  • Recovery is local and uses an authorized completed encrypted iOS backup.
  • Recovered reports and normalized tables are highly sensitive; keep them on private encrypted local storage.
  • The application does not upload recovered data and has no network telemetry.
  • Opening reports may add private filenames to browser, viewer, or Recent Items history.
  • PDF is optional and may be omitted when exact text fidelity cannot be guaranteed; Markdown and offline HTML remain canonical.

Python CLI:

  • Supports Python 3.10 through 3.13.
  • Full encrypted-backup recovery is supported on macOS and Linux.
  • Windows supports analysis and report rebuilding from an existing completed extraction only.

Cache-derived history may be incomplete when TV Time data was not present in the selected backup. See the README and platform guides before recovery.

TV Time Backup Extractor v0.1.0

Pre-release

Choose a tag to compare

@amirbrooks amirbrooks released this 18 Jul 09:54

Warning

Windows safety notice: do not use v0.1.0 extract or recover on Windows. Use Windows only to run analyze or report on an already completed extraction; perform fresh encrypted-backup recovery on macOS or Linux. Use Python 3.10 through 3.13—v0.1.0 did not yet enforce the current upper bound.

TV Time Backup Extractor v0.1.0

First public alpha baseline of the free, privacy-first command-line extractor for TV Time data in an authorized encrypted Finder, Apple Devices, or iTunes backup.

Highlights

  • One guided recover command extracts the TV Time app container, analyzes the local cache, and creates a readable report.
  • The source backup is treated as read-only; extraction goes to a fresh private destination and refuses overlap, overwrite, Git destinations, and unsafe link or manifest paths.
  • Default terminal output is human-readable, and the Markdown report lists every identifiable recovered series, movie, favorite, episode, and watch-event title found locally.
  • CSV tables provide structured private data, while raw cache payloads and the decrypted device manifest remain opt-in.
  • No iMazing, Homebrew, Git, or paid software is required. Python 3.10 through 3.13 is supported.

Install

Download tvtime_backup_extractor-0.1.0-py3-none-any.whl and SHA256SUMS. Verify the wheel hash using the command in the README, create a virtual environment, and install the wheel with its pinned dependencies.

Read the macOS, Windows, or Linux guide before using a real backup. Generated reports and tables contain private viewing-history data and must stay on protected storage.

Verification

  • A clean install of this wheel completed an end-to-end extraction from an encrypted Finder backup and reproduced the independently validated useful title and media tables exactly. No private backup or recovered data is included in this repository or release.
  • The public CI matrix passes on macOS, Windows, and Linux with Python 3.10 and 3.13.
  • The release wheel, source distribution, and repository tree passed privacy and forbidden-artifact scans.

This project is independent and is not affiliated with or endorsed by TV Time.