什么是Stremio Unwatched
Stremio Unwatched 是一款专为 Stremio 媒体库用户设计的命令行工具，旨在帮助用户高效管理未观看的剧集内容。它通过调用 Stremio 的 API 并结合 Cinemeta 元数据服务，自动识别已播出但尚未观看的剧集，并提供清晰的列表展示。该工具支持多种输出格式（如表格、JSON），并可进一步扩展功能，包括查看即将播出的节目日历、与 Google Calendar 同步提醒，以及一键下载新集。其设计目标是让用户摆脱手动追踪进度和查找资源的繁琐流程，实现从发现到下载的全链路自动化。
工具采用模块化脚本结构，依赖 curl、jq 和 Node.js（或 Bun）等常见开发环境组件，安装简便且易于集成到现有工作流中。首次使用时会交互式引导用户输入 Stremio 账户凭据，并安全缓存认证令牌。所有操作均可通过命令行参数灵活控制，例如按剧名过滤、指定季数或仅获取摘要统计信息。此外，它还具备离线预览能力，如干运行（dry-run）模式可提前查看下载计划而不实际执行。
Stremio Unwatched 不仅适用于个人娱乐场景下的日常追剧管理，也适合构建家庭媒体中心或自动化脚本的一部分。无论是希望及时跟进热门剧集更新，还是需要批量处理积压内容，该工具都能显著提升效率。其轻量级架构和对主流 Torrent 客户端的支持，使其在无需图形界面的环境下依然表现出色。
核心功能特点
- 自动检测 Stremio 库中已播出但未观看的剧集，基于 Cinemeta 元数据和播放进度判断
- 提供按剧名、季数或 JSON 格式的灵活筛选与输出选项
- 生成未来30天内即将播出的剧集日历，并支持自定义时间范围和特定节目过滤
- 可选将播出日程同步至独立的“Stremio TV”Google Calendar，避免干扰主日程
- 支持一键下载未观看剧集，优先使用本地 Stremio 服务器或自动识别的 Torrent 客户端
- 兼容 Transmission、Aria2、Deluge 和 qBittorrent 等多种下载工具，并可强制指定客户端
适用场景
对于经常在 Stremio 上追看美剧、日剧或其他流媒体内容的用户而言，Stremio Unwatched 能极大简化剧集管理流程。例如，当某部热门剧集每周更新一集时，用户可通过运行 `scripts/stremio_unwatched.sh` 快速确认是否有遗漏未看的内容，再结合 `–filter “剧名”` 精准定位目标系列。若担心错过播出时间，可使用 `stremio_calendar.sh` 查看接下来两周内所有新集上线时间，并通过 `–gcal-sync` 将其导入 Google Calendar，设置紫色事件提醒，确保不错过首播。
在构建家庭媒体自动化系统时，该工具尤为实用。假设家中成员分散在不同设备上观看 Stremio，管理员可通过定期执行 `stremio_download.sh –limit 5` 批量下载最新五集内容，并借助 `–quality 1080p` 参数保证画质。配合 `–dry-run` 预演下载计划后，再正式执行，既节省带宽又避免误下低质文件。对于技术爱好者，还可将其嵌入定时任务（如 cron job），实现每日自动检查并下载新集，形成闭环式追剧体验。
此外，远程办公或旅行期间无法访问本地设备时，用户仍可通过 SSH 连接服务器运行这些脚本，实时掌握媒体库状态。例如，在海外出差前用 `stremio_status.sh –watch` 监控正在进行的下载进度，确保回国后能立即继续观看。整体来看，Stremio Unwatched 不仅是一个简单的查询工具，更是一套完整的媒体生命周期管理系统，覆盖发现、提醒、下载到跟踪的全过程，满足从普通观众到高级用户的多元需求。