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

## 这玩意儿到底是啥？ 简单来说，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）——这串字符很重要，要妥善保管  ### 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为例  - **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 进行转发一下，打开局域网转发工具 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward  在左侧填入转发后的地址，类似这样：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（有问题可以去这里交流） 祝你观影愉快！🎬

Jellyseerr：Jellyfin的好朋友，电影院级的管理软件

安装了Jellyfin的宝子，如果想将自己的电影电视资源开放出来，用于一个线上电影院，那Jellyseerr绝对是一个好朋友。 - 它的功能： - - 1、影片剧集陈列：展示出最近在Jellyfin上添加的电影，可供用户进行观看； - 2、有影片趋势：类似豆瓣一样，能把最近的新片都呈现出来； https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.jellyseerr ## 登录 在懒猫微服上安装了 Jellyseerr后，打开进入如下页面； 注意：若直接点击懒猫微服账号登录，会登录失败。你需要在Jellyfin链接中输入你自己配置Jellyfin时的网页链接，粘贴进去。 我的链接是：https://jellyfinsingle.你的盒子.heiyu.space/ 账号密码都用admin，邮箱为 admin@admin.com。都输入好后，点击“登入”  ## 同步 登录后，点击 Sync Libraries，就能把你Jellyfin上的电影剧集都同步过来，若是同步失败，那你需要检查一下你的Jellyfin配置。由于这是两个软件，因此Jesslyseerr的成功，是基于你的Jellyfin的。  点击Sync Libraries，我的Jellyfin上剧集就同步过来了，出现了 movies 和 shows 两个文件夹。打开两个文件夹，再点击“继续”。  ## 配置 进入后，会要求配置Sonarr 或 Radarr 服务器。 > 注意：你可以配置，也可以不配置。 > > 配置 or 不配置的区别是：配置后，可以自动下载影片；不配置的话，需要管理员下载影片，管理员下载后，用户才能观看。 配置的话，你需要回到懒猫微服中下载Sonarr 或 Radarr 服务器。 下面进行介绍，如何添加Radarr和Sonarr服务器，首先你要去懒猫微服中，先下载好 Radarr和Sonarr服务器。   ## 添加Radarr服务器 点击添加Radarr服务器  > 进入Radarr的编辑页面，主要输入 > > 服务器名称、主机名称或IP地址、应用程序密钥、质量设置、根目录  在懒猫微服中下载“局域网端口转发工具”，并打开，打开后，页面先保持不动，继续打开Radarr  打开Radarr后，按下图所填的，照搬进去。点击 Save  回到刚打开的“局域网端口转发工具”页面 1、局域网出口类型，选择微服虚拟网卡（仅微服应用容器内可访问） 2、微服虚拟网卡 端口写7878（方便记忆，与Radarr服务器保持一致） 3、微服应用里，下拉框分别选择Radarr、Server 点击“测试连接”，出现绿色的弹窗，提示成功，就可以啦  打开Radarr，需要做的是：（1）要提取 应用程序密钥；（2）创建根目录 ### 提取应用程序密钥 进入 Radarr后，点击 setting，点击General，复制 API Key，API Key就是应用程序密钥  再点击 Media Managemant，点击 Add Root Folder，添加文件夹。**这个步骤，就是获取根目录  回到Radarr页面： 0、默认服务器: 打勾 1、服务器名称可以输入 Radarr（为了方便记忆）。 2、主机名称或IP地址：在局域网端口转发工具中获得，将“入口地址”复制下来，输入进去； 3、质量设置：选择自己的需求 4、根目录，下拉框会自动显示。（上一步在Radarr中 Add Root Folder 就是添加根目录的，目的就是为了在这个下拉框中显示） 5、点击“测试”,右上角会显示连接成功。 出现 连接成功 的弹窗后，就点击“添加服务器”。  Radarr 服务器添加成功！！！（撒花）🎉🎉🎉  ### 添加Sonarr服务器 添加Sonarr服务器的步骤，和添加Radarr服务器的流程是一样的，几乎可以认为是像素级别的相似。 在懒猫微服里同样下载好 Sonarr服务器 后，按下图的参数进行设置。  设置好后，进入这个页面，页面保持不动。  进入Sonarr页面，点击 Setting，点击General，复制API Key。同样的，API Key就是应用程序密钥  点击 Media Management，点击 Add Root Folder，这一步是添加根目录。  > 进入Sonarr页面： > 0、默认服务器: 打勾 > 1、服务器名称：可以输入Sonarr，为了方便好记； > 2、主机名称或IP地址：将局域网端口转发中的入口地址复制下来，填入进去； > 3、应用程序密钥：就是API Key > 4、网站根目录：在Sonarr的 Add Root Folder设置后，这里直接选择就行； > 5、点击 测试，测试成功后，右上角会弹出一个 测试成功 的弹窗。 出现弹窗后，便点击添加服务器。  回到Jellyseerr页面，刷新后，可以看到 Radarr和Sonarr 两个服务器，都配置好啦。 > Radarr服务器处理电影，Sonarr服务器处理电视剧。  ### 配置好后，开始测试 Radarr服务器 在Jellyseerr里任意输入一部电影  选择电影后，点击“提交请求”  提交请求后，点击左侧导航栏的“请求”，可以看到想要下载的电影  再回到Radarr首页，也能看到需要下载的电影。 若是需要 Radarr服务器自动下载，可查看这篇文章搭配服用：https://playground.lazycat.cloud/#/guideline/295  ## 配置好后，开始测试 Sonarr服务器 在Jellyseerr里任意输入一部电视剧，点击“提交请求”  打开Sonarr，可以看到需要下载的电视剧  同样的，若要Sonarr自动下载，同样也可以参考文章https://playground.lazycat.cloud/#/guideline/295 操作和配置相差不大，毕竟这两个服务器里面的按钮操作，也是一样的。 > --------以下是管理员手动下载的操作------ 若是不想用到 Radarr 和 Sonarr 服务器，需要管理员手工下载，可以参考下面的操作。 ## 提交请求 若是有想看的电影，在电影页面的介绍页中，右侧“提交请求”，说明该部电影还没有资源，需要管理员下载，因此点击“提交请求”，提交给管理员。  管理员可在“请求”中，看到用户提交的想看“极速女神”的请求  管理员下载后影片（在jellyfin上）后，继续在jellyseer的请求页面，点击“标记为可观看”。用户便能正常观看了。  ## 反馈问题 若是影片在观看过程中，遇到任何问题，都可以基于该影片向管理员报告问题，点击影片介绍页面的黄色三角形图标。  选择相应的问题，提交问题。  管理员可在“问题”中，查看到用户提交的问题。  问题解决后，管理员可 关闭issues 。即表示问题解决。  ## 总结 1、适合毛孩子：家长可给孩子安装这个软件，孩子想要什么电影，若没有的，需要征得家长同意，便于管理孩子的输入。 2、适合做小型创业：Jellyseerr特别像一个电影院的功能，有上映的，和即将上映的，即将上映的是没有资源的，需要管理员弄好资源。 3、页面的颜值很高，紫黑的配色，非常有高级的感觉，搭配 Jellyfin 观看，流程非常顺滑