Cronica

Track what you watch. Never lose your place.
A SwiftUI watchlist for movies and TV — with release reminders and iCloud sync across Apple devices.

Website · Privacy · X · Support

• Watchlist — Save movies and shows; organize with lists, favorites, pins, and archives
• Episode tracking — Mark what you’ve watched and pick up where you left off
• Release reminders — Local notifications for new episodes and movie releases
• iCloud sync — Core Data + CloudKit keeps your list in sync across devices
• Discover — Explore, search, and browse with TMDb data
• Everywhere Apple — iPhone, iPad, Mac, Apple Watch, Apple TV, and Vision Pro

1. Install Xcode 26 or later.
2. Clone this repository and open Cronica.xcodeproj.
3. Copy Config/Secrets.xcconfig.example → Config/Secrets.xcconfig.
4. Add your TMDb API key (and optionally SENTRY_DSN, SIMKL_CLIENT_ID) in Secrets.xcconfig.
5. Build the Cronica (EN-US) scheme.

For CI, set repository secrets TMDB_API_KEY and optionally SENTRY_DSN. See SECURITY.md. Optional integrations (SIMKL and others): Docs/INTEGRATIONS.md.

Cronica/
├── Shared/                 # SwiftUI app (iOS, iPadOS, macOS, tvOS, visionOS)
├── AppleWatch/             # Watch-specific UI
├── CronicaWidget/          # Widgets
├── Packages/CronicaCore/   # Shared models & TMDb networking
├── web/                    # Marketing site (Cloudflare Worker) → www.cronica.watch
└── Config/                 # Secrets.xcconfig (gitignored) + example

• Persistence — Core Data (NSPersistentCloudKitContainer); syncs when the user is signed into iCloud
• Networking — TMDb via CronicaCore
• Notifications — Local notifications + background refresh for upcoming releases

Issues and pull requests are welcome.

Translations — Edit Shared/Localization/Localizable.xcstrings and open a PR, or email completed strings to support@cronica.watch.

Before a release, run through Docs/QA-SMOKE-TEST.md.

• Never commit API keys — use Config/Secrets.xcconfig (see SECURITY.md)
• Privacy policy: www.cronica.watch/privacy
• Report vulnerabilities privately to support@cronica.watch

Movie and TV data from TMDb. This product uses the TMDb API but is not endorsed or certified by TMDb.

Cronica is released under the MIT License — copyright © 2022–2026 Egger & Co.

SPDX-License-Identifier: MIT