TV Time Backup Extractor v0.1.0

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.