SuggestArr 使用指南：让你的影视库自动推荐新片

这玩意儿到底是啥？

简单来说，SuggestArr是个自动化推荐工具。它会监控你在Jellyfin、Plex或Emby上看过的内容，然后通过TMDb（全球最大的影视数据库）找到类似的影片，最后自动向Jellyseer或Overseer发起下载请求。整个过程完全自动化，你只需要躺着等新片就行了。

打个比方：如果你是个美剧迷，最近在追《权力的游戏》，SuggestArr就会自动帮你找到《维京传奇》《最后的王国》这类史诗剧集。

如果你喜欢看日本动画，看完《进击的巨人》，它可能会推荐《东京喰种》或《约定的梦幻岛》。

开始之前，你需要准备什么

1. 获取TMDb API密钥（必须的）

TMDb就像影视界的维基百科，所有电影电视剧的信息都在这里。要使用SuggestArr，你得先拿到一把"钥匙"：

1. 访问 https://www.themoviedb.org 注册账号
2. 登录后点击右上角头像，进入Settings（设置）
3. 找到API选项，点击"Request an API Key"
4. 选择"Developer"（开发者）选项
5. 填写简单的申请表（应用名称随便写，比如"My Media Server"）
6. 拿到你的API Key（v3 auth）——这串字符很重要，要妥善保管

2. 确保你的影视服务器在运行

• Jellyfin/Plex/Emby：这是你的影视播放器，至少要有一个在运行

• Jellyseer/Overseer：这是管理下载请求的工具，负责接收SuggestArr的推荐

第一次进入系统

打开浏览器，你会看到一个友好的配置向导。

配置要点详解

选择你的媒体服务器

系统会让你选择使用哪个媒体服务器：

• Jellyfin用户：以Jellyfin为例

• Plex用户：需要Plex Token（在Plex设置里找）
• Emby用户：类似Jellyfin的配置方式

输入上面获得的 TMDB 的 API 密钥，点击右侧的按钮，如果正确，nextStep 按钮会变绿，就可以点击了

配置Jellyfin 的 URL 和 api key

这一步要配置Jellyfin的 URL 和 key

打开Jellyfin应用，进入控制台

进入 API Keys，新建一个密钥

URL 填：https://jellyfinsingle.你的懒猫.heiyu.space/

选择一个你的 library，进入下一步

配置Jellyseer/Overseer

这里要填入Jellyseer或Overseer的地址和API Key。

打开Jellyseer 应用

进入到设置

在这里复制自己的 apikey

注意，这里直接填入 Jellyseer的 URL 是不行的，会报错误

要先对 URL 进行转发一下，打开局域网转发工具

在左侧填入转发后的地址，类似这样：http://你的懒猫.heiyu.space:5055

这时候再点击右侧的按钮，可以看到已经通了，下方的按钮可以进行下一步

选默认 sqlite 数据库就可以

第 6 步可以进行一些高级配置、语言、剧集等等，可以选择默认

设置自动运行时间（Cron Job）

第 7 步，这里决定了SuggestArr多久检查一次你的观看记录。常用设置：

• 0 */6 * * * - 每6小时运行一次（推荐）
• 0 2 * * * - 每天凌晨2点运行
• 0 */12 * * * - 每12小时运行一次

新手建议：刚开始用每6小时一次比较合适，既不会错过新内容，也不会太频繁。

点击 Save 保存之后，就已经配置完了。点击 Run 就会自动运行

日志监控

通过Web界面的实时日志功能，你可以：

• 查看INFO级别日志了解正常运行状态
• 查看ERROR日志排查问题
• 查看DEBUG日志深入了解运行细节

实用技巧：如果推荐效果不理想，看看DEBUG日志，可能是TMDb返回的相似影片不够精准。

写在最后

SuggestArr不是要取代你的选片能力，而是成为你的影视助手。它观察你的喜好，默默推荐可能喜欢的内容，让你的影视库始终保持新鲜。

最棒的是，这一切都是自动的。设置好之后，你要做的就是享受源源不断的好内容。当朋友问你"最近有什么好看的"时，打开你的媒体库，里面早就准备好了答案。

项目地址：https://github.com/giuseppe99barchetta/SuggestArr
Discord社区：https://discord.gg/cpjBJ5sK（有问题可以去这里交流）

祝你观影愉快！🎬