SelfHostSelfHost

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

9 months ago

这玩意儿到底是啥？

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

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

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

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.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）——这串字符很重要，要妥善保管

image.png

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

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

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.jellyfinsingle

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

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.jellyseerr

第一次进入系统

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

配置要点详解

选择你的媒体服务器

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

  • Jellyfin用户：以Jellyfin为例

image.png

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

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

image.png

配置Jellyfin 的 URL 和 api key

这一步要配置Jellyfin的 URL 和 key image.png

打开Jellyfin应用，进入控制台

image.png

image.png

进入 API Keys，新建一个密钥

image.png

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

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

image.png

配置Jellyseer/Overseer

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

image.png

打开Jellyseer 应用

image.png

进入到设置

image.png

在这里复制自己的 apikey

image.png

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

image.png

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

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward

image.png

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

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

image.png

选默认 sqlite 数据库就可以

image.png

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

image.png

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

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

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

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

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

image.png

日志监控

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

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

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

写在最后

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

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

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

祝你观影愉快！🎬

作者
天天