Privacy policy for YouTube Ledger
YouTube Ledger by Caleb Telander
YouTube Ledger Firefox privacy policy — updated October 21, 2026
The complete policy, including retention limits, permissions and deletion behavior, is at https://cabe9.github.io/youtube-ledger/privacy.html and is bundled in Ledger for offline access. The encrypted Chrome store edition has a separate policy: https://cabe9.github.io/youtube-ledger/privacy-chrome.html.
Ledger is maintained by cabe9. It has no developer server, advertising, developer analytics or automatic AI connection. Recording starts only after setup choices are saved. With recording enabled, Ledger stores YouTube video/channel identifiers, titles, viewing durations, timestamps and supported recommendation activity in this browser profile. Notes, groups and preferences are also local. Private browsing is disabled. Ledger does not record audio, video, screenshots, passwords, authentication cookies or activity on unrelated websites.
Discover uses saved viewing activity and local observations of visible Home recommendation cards. Observations include video/channel addresses, names/titles, portrait URLs, timestamps, random visit IDs and whether a card was opened. They are bounded, expire after at most 30 days and participate in date-range deletion. Profile backups include these observations and dismissal preferences; companion sync does not share them. Subscription checks use your signed-in YouTube session after optional lookup consent; the subscription list stays in tab memory.
Batch analysis uses recommendation/search cards already loaded on the page to count channels and upload ages. Its results stay in page memory. Check subscriptions reads the signed-in subscription list with lookup consent. Check video dates requires your click and sends cookie-free public video-page requests through the shared paced queue; closing the panel stops checks. Checked dates and uploader IDs remain on the page and do not create watch records. Date filtering can trigger YouTube’s native continuation controls when too few matches remain to scroll. The current filter is saved locally. With recording enabled, opening a filtered video saves the selected bounds with that visit’s entry point in history and exports. Batch results and the current filter preference are excluded from full profile backups; recorded source context remains with history.
YouTube lookups and images start off and require separate consent. When enabled, YouTube and Google-operated image hosts receive requested video/channel IDs, URLs and ordinary network information such as your IP address. Public metadata requests omit account cookies; images suppress the page referrer. Ledger does not upload your notes, watch-time totals or complete history database. Disabling connections or revoking required Firefox permissions stops new lookups and remote images and cancels active lookups.
Subscribe, Don't recommend channel and Watch Later removal require separate account-action consent and explicit user action. They operate YouTube's native controls and affect your signed-in YouTube account. A Don't recommend request can be explicitly queued when its control is unavailable. Pending requests expire after 30 days, are bound to the account with a locally stored hash and can be cancelled offline. Ledger rechecks subscriptions before sending. Up to 100 requests and their results stay in this browser, outside backups and companion sync. Uncertain sends are not automatically retried. Subscribe is never queued. Dismiss and reminder choices are local and do not send YouTube feedback.
Firefox browser-local records and exported JSON are readable, not encrypted by Ledger. History and notes do not expire by default; optional 30-, 90- or 365-day retention and date-range deletion are available. Separate controls reset watch status, remove groups or delete all Ledger data. Downloaded exports and YouTube account data are unaffected. Removing the extension does not delete downloaded files.
Optional local sync requires a separately installed Mac companion, explicit pairing and the relevant Firefox permissions. It exchanges an encrypted profile on the same computer. The Firefox profile and its pairing key remain locally readable. Disconnecting stops further exchange but retains existing copies. The Chrome store edition does not include the companion. Chrome can import supported readable Firefox backups; Firefox cannot open Chrome's encrypted backups.
Imports and review exports are processed locally. An export reaches an AI provider or other recipient only if you choose to share it. GitHub hosts the policy page under its own privacy policy; the page has no analytics or trackers. YouTube, Google and browser providers operate under their own policies.
Questions: https://github.com/cabe9/youtube-ledger/issues. Issues are public; do not include private history or exports.