ciuse99/suggestarr

SuggestArr

!https://github.com/user-attachments/assets/d5c48bdb-3c11-4f35-bb55-849297d521e7

镜像概述和主要用途

SuggestArr是一个自动化媒体内容推荐与下载请求工具，可基于用户在Jellyfin、Plex或Emby等媒体服务器中的活动，检索最近观看的内容，通过TMDb API搜索相似影视，并自动向Jellyseer或Overseer发送下载请求。

核心功能和特性

• 多媒体服务器支持：支持从Jellyfin、Plex和Emby检索媒体内容。
• TMDb集成：在TMDb上搜索相似的电影和电视剧。
• 自动化请求：将推荐内容的下载请求自动发送至Jellyseer或Overseer。
• Web界面：用户友好的配置和管理界面。
• 实时日志：实时查看和筛选日志（如INFO、ERROR、DEBUG级别）。
• 用户选择：可指定特定用户发起请求，便于管理和审批自动请求的内容。
• Cron任务管理：通过Web界面直接更新cron任务调度。
• 配置预测试：设置过程中自动验证API密钥和URL的有效性。

适用范围

适用于需要基于用户观看习惯自动扩展媒体库的场景，尤其适合家庭媒体服务器管理员或需要自动化内容请求流程的用户。

先决条件

• Python 3.x 或 Docker 环境
• https://www.themoviedb.org/documentation/api
• 已配置的 https://jellyfin.org/**%E3%80%81**Plex 或 Emby 媒体服务器
• 已配置的 https://github.com/Fallenbagel/jellyseerr 或 https://github.com/sct/overseerr 请求工具

使用方法和配置说明

Docker部署

推荐使用Docker Compose进行便捷的部署和运行。

Docker Compose示例

yaml
services:
  suggestarr:
    image: docker.xuanyuan.run/ciuse99/suggestarr:latest
    container_name: SuggestArr
    restart: always
    ports:
      - "5000:5000"
    volumes:
      - ./config_files:/app/config/config_files

启动容器：

bash
docker-compose up

Web界面配置

访问Web界面：http://localhost:5000%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E7%95%8C%E9%9D%A2%E5%8F%AF%E5%AE%8C%E6%88%90%E5%BA%94%E7%94%A8%E9%85%8D%E7%BD%AE%E3%80%81%E5%AA%92%E4%BD%93%E6%9C%8D%E5%8A%A1%E9%80%89%E6%8B%A9%E5%8F%8Acron%E8%B0%83%E5%BA%A6%E7%AE%A1%E7%90%86%E3%80%82%E7%A1%AE%E4%BF%9D%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%AD%A3%E7%A1%AE%E4%B8%94%E5%BA%94%E7%94%A8%E6%AD%A3%E5%B8%B8%E8%BF%90%E8%A1%8C%E4%BB%A5%E8%AE%BF%E9%97%AE%E7%95%8C%E9%9D%A2%E3%80%82

使用特定Jellyseer/Overseer用户发起请求

如需使用特定Jellyseer用户发起媒体请求，请按以下步骤操作：

1. 在Web界面中，勾选对应复选框启用用户选择功能。
2. 从下拉列表中选择目标用户。
3. 输入所选用户的密码。
4. 系统将使用该用户发起媒体请求，而非管理员或默认配置文件。

注意：目前仅支持本地Jellyseer用户。