📅 Simkl Calendar

Simkl Calendar is a modern Android application that integrates with your Simkl account to provide a unified calendar for tracking upcoming TV shows, anime, and movies. Stay updated with personalized notifications and manage your watchlist with ease.

✨ Features

• Unified Calendar: View all your tracked TV shows, anime, and movies in a single, easy-to-read calendar.
• Tracked Watchlist: View and manage your tracked TV shows, anime, and movies in a structured table or list view.
• Personalized Alerts: Receive notifications when new episodes or movies from your watchlist are aired.
• Quick Actions: Mark episodes or entire seasons as watched directly from the notification.
• Torrent Search: Integrated torrent search functionality to find releases quickly.
• Downloader Integration: Seamlessly works with the Torrent HTTP Downloader app.
• Custom Search Links: Configure custom URL templates to easily search external sites or services for your media.
• Modern UI: Built with Jetpack Compose and Material 3 for a clean and responsive experience.
• Offline Support: Uses Room database and DataStore for local caching, preferences, and offline access.

🛠️ Tech Stack

• Language: Kotlin
• UI Framework: Jetpack Compose
• Dependency Injection: Hilt
• Architecture: MVVM (Model-View-ViewModel) with Single-Responsibility principles.
• Networking: Retrofit, OkHttp & Moshi
• Local Database & Storage: Room & Jetpack DataStore
• Background Tasks: WorkManager
• Image Loading: Coil
• Error Tracking & Monitoring: Sentry
• Logging: Timber
• Dependency Management: Gradle Version Catalog
• Code Coverage: Kover

📥 Installation & Updates

🚀 Using Obtainium (Recommended)

To stay updated with the latest versions, we recommend using Obtainium.

1. Install Obtainium on your Android device.
2. Open Obtainium and tap "Add App".
3. Paste this repository's URL: https://github.com/felixbrucker/simkl-calendar
4. Obtainium will notify you and help you install updates automatically whenever a new build is available on GitHub.

📦 Manual Download

You can find the latest APKs in the Releases section.

🏗 Development

Prerequisites

• Android Studio Ladybug (or newer)
• Java 25
• Android SDK 37

Build Commands

# Run unit tests
./gradlew test

# Build debug APK
./gradlew assembleDebug

# Generate coverage report
./gradlew koverHtmlReport

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.