Self-host Mediary Scout
v2026.11.05AI agent that fetches media into your personal cloud drives
- Stars
- 1 752
- Port
- 3000 (Web UI)
- Requires
- PanSou, PostgreSQL
What is Mediary Scout?
Mediary Scout (巡影) is an agent-driven media library that automates finding and storing movies, shows, and anime into your personal cloud drives. You specify a title and the agent searches multiple sources, selects the best quality match with Chinese subtitles, transfers it directly to your cloud drive (Quark, 115, GuangYaPan, 123, or Tianyi) without using local disk space, verifies the transfer completed successfully, and continuously monitors for missing episodes to fill gaps automatically. It runs as a desktop app on macOS/Windows or via Docker Compose on NAS/servers with PostgreSQL and a bundled PanSou search backend. The desktop version is single-user while Docker supports multi-user isolation. Remote access is available via Tailscale or Cloudflare Tunnel. An optional paid service (Mediary Connect) provides managed tunnels. The software is free and open-source (0BSD); users provide their own cloud drive credentials and OpenAI-compatible AI model endpoint.
Mediary Scout alternatives
MedusaOpen-source TV show manager you run yourself: it searches torrent and Usenet providers, grabs episodes via download clients, and organizes them for Kodi, Plex and Emby.CompareMedusa with Mediary Scout
MediariumSelf-hosted media manager combining multiple *arr apps and downloaders into one Docker container for movies, shows, music and books.CompareMediarium with Mediary Scout
Nowen VideoSelf-hosted open-source family media server with Go/React, auto metadata scraping, HLS transcoding with HW acceleration, web/desktop/Android clients.CompareNowen Video with Mediary Scout
MydiaOrganize your movie and TV collection on your own server with auto-fetched metadata, download automation, and a peer-to-peer streaming app for any device.CompareMydia with Mediary Scout
ChineseSubFinderOpen-source, self-hosted tool that auto-fetches Chinese subtitles for Emby, Jellyfin, Plex and arr-stack media libraries — discontinued; its cloud API is offline.CompareChineseSubFinder with Mediary Scout
ScrobSelf-hosted media tracker that aggregates watch history from Jellyfin, Plex, Emby and more into one private Letterboxd-like app.CompareScrob with Mediary Scout
CrossWatchCrossWatch is a self-hosted, open-source app that syncs watchlists, ratings, history, and playback progress across media servers and trackers. Runs via Docker.CompareCrossWatch with Mediary Scout
scoutarrSelf-hosted automation that searches for upgraded media files across the Starr stack using configurable filters, tagging, and scheduled runs.Comparescoutarr with Mediary Scout
Should you self-host Mediary Scout?
Mediary Scout scores 69/100 on selfhost.directory (how scoring works) and ranks #9 of 141 in Media Management. It has 1 752 GitHub stars, +154 in the last 30 days.
It shipped 12 stable releases in the past year. The latest, v2026.11.05, came out on 5 November 2026. New versions land roughly every 6 days.
Setup is moderate: expect some configuration beyond a single command. It is 0BSD-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is Sonarr (80/100, 17 599 stars). It scores higher overall, so compare the two before you pick. See Mediary Scout vs Sonarr side by side.
Features
- Agent-driven media acquisition
- Automated quality selection
- Desktop applications
- Direct cloud-to-cloud transfer
- Docker Compose Deployment
- Multi-cloud drive support
- Multi-user isolationDesktop app is single-user only
- One-click updates
- OpenAI-compatible LLM integration
- Prowlarr integrationOptional
- Remote access via Cloudflare Tunnel
- Remote access via Tailscale
- Season-level tracking
- TMDB metadata
- Transfer verification
Mediary Scout README
巡影 · Mediary Scout
给你自己网盘用的 agent 驱动媒体库。
📥 下载 · 🌐 官网 · 🔭 在线 Demo · English
你说要哪部电影、剧或番,agent 自己去搜资源,挑最合适的转存进你自己的网盘(夸克 / UC / 115 / 光鸭 / 123 / 天翼),转完读回来确认真的到了,之后缺哪集还会接着补。
点击前往下载:GitHub Releases(macOS / Windows 桌面版)
点击前往赏饭:要饭嘛,不寒碜
交流:本项目积极参与并认可 LINUX DO 社区,许多用户在那里自部署、交流网盘经验,部署问题也能很快得到回应。
| 平台 | 下载 | 说明 |
|---|---|---|
| macOS(Apple 芯片) | .dmg | 已签名公证,直接打开 |
| Windows(x64) | .exe | 未签名,SmartScreen 弹窗时点「仍要运行」 |
安装后打开 → 在设置里连网盘、填 AI 模型 → 搜片点「获取」。有新版本时应用会提示你下载。
git clone https://github.com/fancydirty/mediary-scout && cd mediary-scout docker compose up -d
打开 http://<主机IP>:3000,在设置里配置。以后在 设置 → 更新 里一键升级,也可以设成每天自动更新。国内构建加速、Tailscale / Cloudflare Tunnel 远程访问、多用户、备份,以及让 AI agent 替你部署的提示词,都在 部署指南。
| 桌面版 | Docker | |
|---|---|---|
| 适合 | 自己用,Mac / Windows | NAS、服务器,常开 |
| 定时巡检补缺 | 应用开着时才跑 | 24 小时 |
| 多用户 | 不支持 | 支持 |
| 手机、出门访问 | 仅本机 | Tailscale / Cloudflare Tunnel |
两种形态下,自带 OpenAI 兼容的 AI 模型接口都是可选升级(key 只存在你自己的实例里)。未配置 AI 模型时,默认使用 Kilo Code 的公共免费模型池(无需注册;获取任务的对话上下文——搜索查询、任务与留言内容、候选结果、文件名等——会发送给 Kilo 及其上游模型提供商)。影视信息开箱即用。资源搜索用 PanSou:Docker 版自带一个,桌面版默认用公共实例,可以在设置里换成你自己的;可选再接 Prowlarr 找磁力。
连接多个网盘时,agent 会自动联合各盘资源池并按实时剩余容量与画质分配落盘,也可以跨盘凑齐同一季(多网盘联合获取详解):
- 夸克:分享链转存,扫码登录,PanSou 上资源最多。
- UC网盘:分享链转存,扫码登录,免费容量大。
- 115:分享链 + 磁力,扫码登录。
- 123网盘:分享链 + 磁力,免费账号也能转存,扫码登录。连接教程
- 光鸭云盘:分享链 + 磁力,粘 token 登录。连接教程
- 天翼云盘:分享链转存,扫码登录,电影资源偏少。连接教程
各盘资源量对比、为什么只支持这六家:追剧用哪个网盘好 · 网盘评估。
- 官网指南中心:NAS / Docker 部署教程 · 网盘与搜索源配置 · 与 MoviePilot / Sonarr 对比
- 部署指南
- Agent API(仓库文档):让 Claude Code、Codex、OpenClaw 等 agent 直接操作巡影
- AI 选源与外挂字幕 · 搜索与网页查证:描述也能找片;官方不分季的作品怎么对集号
- 架构速览
巡影是开源、自部署的软件,不提供、也永远不会提供托管服务:你自己跑实例,自带网盘和 AI 模型的凭证。它做的就是你本可以在自己网盘里手动完成的那些文件操作。详见项目定位。与 115、夸克、UC、光鸭、123、天翼、TMDB 及任何索引器均无隶属关系。
- PanSou:资源搜索后端
- Prowlarr:索引器管理(可选)
- p115client:115 API 参考
- p123client:123网盘 API 参考
- AList:光鸭云盘 API 参考(
drivers/guangyapan) - cloud189-auto-save / cloudpan189-api:天翼云盘 API 参考
- TMDB:影视元数据(本产品未获 TMDB 认证或背书)
FAQ
Windows 提示「已保护你的电脑」?
This is due to the unsigned installer (personal developer certificates are expensive). Click "More info → Run anyway". Every release is verified by CI on real machines before publishing.
支持哪些网盘?
Supports Quark, 115, GuangYaPan, 123, and Tianyi. The drive layer uses a plugin interface and welcomes PRs for new brands.
要花钱吗?
The software is free and open-source. You need your own cloud drive account and an AI service key (any OpenAI-compatible endpoint).
账号密码存在哪?
On your own computer (desktop version) or your own server. The author cannot access them.
它会乱动我的网盘吗?
No, it only performs transfers and organization that you could manually do in your own cloud drive. Every step is visible and credentials stay only in your own instance.
More in Media Management
media-stackSelf-hosted, open-source Docker Compose media stack bundling Jellyfin, Sonarr, Radarr, Prowlarr, qBittorrent, Seerr and optional AI-powered Recommendarr with Gluetun VPN.
MediastarrSelf-hosted open-source tool that finds missing episodes and movies in Sonarr and Radarr, plus quality upgrades, on a schedule with a web dashboard and Discord alerts.
MediathekArrMediathekArr is a self-hosted, open-source bridge making ARD/ZDF Mediathek content searchable in Prowlarr, Sonarr, and Radarr.
MedusaOpen-source TV show manager you run yourself: it searches torrent and Usenet providers, grabs episodes via download clients, and organizes them for Kodi, Plex and Emby.
Meme SearchMeme Search is a self-hosted, open-source meme search engine using local AI for semantic search. Run with Docker Compose to find memes by meaning, not filenames.
metadata-remoteSelf-hosted web app for editing audio metadata on headless servers. Lightweight Docker container with MusicBrainz, bulk editing, undo/redo, keyboard-first UI.
MeTubeAn open-source, self-hosted web UI for yt-dlp: paste links from YouTube and hundreds of other sites, queue whole playlists, and follow channel subscriptions.
midarr-serverSelf-hosted, open-source companion media server for Radarr and Sonarr: streams your existing library directly through a web UI with users, invites, and OIDC login.
Misaka Danmu ServerSelf-hosted danmaku aggregation service with a web admin UI and a dandanplay-compatible API; matches subtitles-like comments to media library items.
mixarrSelf-hosted music discovery for Lidarr connecting to Spotify, TIDAL, Last.fm and 9 more services with 56 subscription types, review queue, and AI recommendations.
MonbooruSelf-hosted, open-source booru for organizing personal image collections with tag-based browsing, AI metadata extraction, local ONNX auto-tagging.
motionEyeSelf-hosted, open-source browser interface for the motion surveillance backend: runs USB, Pi and IP cameras with motion detection, recordings, timelapse and email alerts.



0 comments