Introduction

Freak-Flix is a high-performance, cross-platform media management ecosystem designed to transform your fragmented video collections into a premium, Netflix-style streaming experience. Built with Flutter, Freak-Flix serves as a unified interface for content stored locally on your devices or hosted in the cloud via OneDrive.

By integrating industry-standard metadata providers and robust backend proxies, Freak-Flix automates the organization of your library, providing rich visuals, actor biographies, and smart tagging without the manual overhead of traditional file managers.

核心能力 (Core Pillars)

Freak-Flix is built on three main pillars designed to enhance the viewing experience:

• Unified Aggregation: Seamlessly bridge the gap between local hard drives and cloud storage. Stream directly from OneDrive without needing to sync large files to your local machine.
• Intelligent Metadata Enrichment: Automatically pull posters, backdrops, and cast information from professional databases including TMDB (Movies/TV), AniList (Anime), and StashDB (Specialized content).
• Privacy & Segregation: Built-in support for sensitive content management with hidden UI toggles and dedicated metadata fetching, ensuring your main library remains clean and secure.

Key Features

📚 Immersive Library Organization

The application automatically scans your directories and categorizes content into logical sections. It recognizes various media types and applies specific metadata rules to ensure your collection looks professional and is easy to navigate.

🧠 Multi-Source Metadata Engine

Freak-Flix leverages specific APIs to ensure the highest accuracy for your metadata:

• Movies & TV: Deep integration with The Movie Database (TMDB).
• Anime: Specialized tracking and data via AniList.
• Specialized Content: Advanced tagging and performer profiles powered by StashDB.

☁️ Cloud-Native Streaming

Utilizing a custom-built Microsoft Auth Proxy, the application allows for secure, direct streaming from OneDrive. This enables a "roaming" library where your content follows you across devices without requiring massive local storage.

👥 Dynamic Actor Profiles

Explore your library through the lens of the performers. Freak-Flix generates detailed profiles including biographies and "Known For" lists, allowing you to discover more content featuring your favorite actors.

Supported Platforms

Freak-Flix is optimized for a consistent experience across the following environments:

| Platform | Role | | :--- | :--- | | Windows (Desktop) | The primary powerhouse for local file management and high-bitrate playback using media_kit and mpv. | | Android (Mobile) | Optimized for touch navigation and on-the-go streaming from cloud sources. | | Web | A portable version of the interface accessible from any browser, utilizing specialized backend proxies for authentication. |

Quick Start Overview

To begin using Freak-Flix, you will typically follow these high-level steps:

1. Deployment: Run the application on your preferred platform.
2. API Configuration: Provide your TMDB API key in the settings to enable metadata fetching.
3. Library Scanning: Point the application to your local folders or sign in to OneDrive.
4. Advanced Setup: (Optional) Configure StashDB endpoints or custom proxies for specialized content organization.

# Example: Running the Windows desktop client
flutter run -d windows

For detailed installation and configuration instructions, please refer to the Getting Started and Configuration sections of the documentation.