Summary

Mediary Scout is an agent-driven, self-hosted media library for advanced users, automating media acquisition across multiple cloud drives (115, Quark, GuangYaPan). It intelligently searches, transfers, verifies, and tracks content, ensuring users manage their media libraries efficiently by knowing precisely what they have and what's missing.

How It Works

It employs a state-driven agent architecture. A web UI (Next.js) enqueues tasks into a Postgres database, which manages run states. A worker orchestrates a sandboxed agent interacting with metadata (TMDB) and search providers (PanSou, Prowlarr). The agent performs cloud-native transfers directly to user drives (115, Quark, GuangYaPan), critically verifying each transfer against the drive's actual state. This deterministic workflow, with state in Postgres, ensures resumability and robust tracking of media acquisition.

Quick Start & Requirements

The fastest setup uses Docker Compose (docker compose up -d), bundling web UI, Postgres, and PanSou. Users must provide their own cloud drive credentials (115, Quark, GuangYaPan), an OpenAI-compatible LLM endpoint, and optionally Prowlarr. Mainland China users need registry mirrors. Deployment options include NAS, routers, PCs, or VPS, accessible securely via Tailscale or Cloudflare Tunnel. A live, read-only demo is available at mediary.dirtyfancy.sbs.

Highlighted Details

• Agent-driven acquisition: Selects, transfers, and verifies media based on user preferences.
• Multi-drive workspace: Integrates 115, Quark, and GuangYaPan as distinct, manageable workspaces.
• State-machine tracking: Manages media status, identifies missing episodes, and performs scheduled gap-filling.
• Cloud-native transfers: Moves files directly into cloud drives, avoiding local disk usage.

Maintenance & Community

The project is presented as an independent, disciplined workflow. No specific community channels or notable contributors/sponsorships are detailed in the provided README excerpt.

Licensing & Compatibility

Mediary Scout is described as open-source, self-hosted software. The README directs users to docs/distribution-and-legal-positioning.md for the project's legal stance, but the specific open-source license type is not explicitly stated. Its self-hosted nature implies user responsibility for compliance.

Limitations & Caveats

This is a self-hosted solution for advanced users requiring their own cloud drive and LLM credentials. Quark drives lack a magnet API, and GuangYaPan (v1) does not support direct share-link transfers. Scheduled monitoring is most effective on continuously running hosts.