Krate - Local Media Vault

Krate is an offline-first, local media vault and player designed to manage and watch your personal collection of movies and TV series directly from your device storage.

---

✦ Table of Contents ✦

• Description
• What's Included
• Installation
• Status
• Creators
• Thanks

---

✦ Description ✦

Krate provides a seamless way to organize your local media. It automatically fetches metadata and artwork from TMDB and stores them alongside your files in self-contained "pods." This ensures your library remains portable, resilient, and fully functional even without an internet connection.

The application is built for portability, allowing you to plug in media "pods" and sync your library entirely offline with zero friction.

---

✦ What's Included ✦

• Metadata Management: Automatic TMDB integration for movies and series.
• Local Vault: Self-contained folder structure for portability.
• Native Performance: Optimized file handling on Android via native pickers, bypassing slow cache copies.
• Independent Subtitles: Multi-subtitle support with centralized management for movies and episodes.
• Smart Playback: Auto-resume, progress saving, and "Continue Watching" support.
• Media Management: Tools to link, replace, (re)sync, and delete media files.
• Vault Sync: Reconcile your library with the filesystem in one tap.
• History & Progress: Track your viewing history and completed titles.
• Appearance Customization: Deep Material 3 theming with multiple color palettes (Midnight, Forest, Crimson, Sunset, Rose, Monochrome).
• UI Polish: Lighter search shadows, smooth app bar transitions, and scroll-under contrast.

---

✦ Installation ✦

Download the App

The easiest way to get Krate is to download the latest APK from the Releases page.

---

Run Locally (Developers)

To run Krate locally, ensure you have the Flutter SDK installed.

1. Clone the repository.
2. Create a .env file in the root directory and add your TMDB API key:

   TMDB_API_KEY=your_api_key_here

3. Fetch dependencies:

   flutter pub get

4. Run the app:

   flutter run

   You can get a TMDB API key from here.

---

✦ Status ✦

Current Version: v0.4.0-alpha
Platform Support: Exclusively developed and tested for Android. Other platforms (Linux, Windows) are currently not functional or supported, though support for these is planned for the future.

Krate is currently in active development. Core features for library management and playback are implemented, with further refinements planned for the beta release.

---

✦ Creators ✦

Maintained and developed with ❤️ for local media enthusiasts by notsoeazy.

---

✦ Thanks ✦

This product uses the TMDB API but is not endorsed or certified by TMDB.