https://github.com/giuseppe99barchetta/SuggestArr
Effortlessly request recommended movies, TV shows and anime to Jellyseer/Overseer based on your recently watched content on Jellyfin, Plex or Emby—let SuggestArr handle it all automatically, keeping your library fresh with new and exciting content!
https://github.com/giuseppe99barchetta/SuggestArr
automation docker emby jellyfin jellyseerr media-automation ombi open-source overseerr plex self-hosted tmdb
Last synced: 17 days ago
JSON representation
Effortlessly request recommended movies, TV shows and anime to Jellyseer/Overseer based on your recently watched content on Jellyfin, Plex or Emby—let SuggestArr handle it all automatically, keeping your library fresh with new and exciting content!
- Host: GitHub
- URL: https://github.com/giuseppe99barchetta/SuggestArr
- Owner: giuseppe99barchetta
- License: mit
- Created: 2024-10-14T09:51:40.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T11:09:16.000Z (21 days ago)
- Last Synced: 2025-03-25T11:33:12.335Z (21 days ago)
- Topics: automation, docker, emby, jellyfin, jellyseerr, media-automation, ombi, open-source, overseerr, plex, self-hosted, tmdb
- Language: Python
- Homepage:
- Size: 5.93 MB
- Stars: 533
- Watchers: 4
- Forks: 5
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome-arr - SuggestArr - Automatic media content recommendations and download requests based on user activity on the media server. (Complimenting Apps)
- awesome-jellyfin - SuggestArr - Automatically request suggested movies and TV shows to [Jellyseerr](https://github.com/Fallenbagel/jellyseerr) based on recently watched. (👾 Other)
- awesome-selfhost-docker - SuggestArr
README
## 🚀 SuggestArr - Media Automation Made Simple
[](https://github.com/giuseppe99barchetta/SuggestArr/wiki)
[](https://buymeacoffee.com/suggestarr)
[](https://www.reddit.com/r/selfhosted/comments/1gb4swg/release_major_update_for_suggestarr_now/)
[](https://discord.gg/JXwFd3PnXY)
SuggestArr is a project designed to automate media content recommendations and download requests based on user activity in media servers like **Jellyfin**, **Plex**, and now **Emby**. It retrieves recently watched content, searches for similar titles using the TMDb API, and sends automated download requests to **Jellyseer** or **Overseer**.
## Features
- **Multi-Media Server Support**: Supports Jellyfin, Plex, and Emby for retrieving media content.
- **TMDb Integration**: Searches for similar movies and TV shows on TMDb.
- **Automated Requests**: Sends download requests for recommended content to Jellyseer or Overseer.
- **Web Interface**: A user-friendly interface for configuration and management.
- **Real-Time Logs**: View and filter logs in real time (e.g., `INFO`, `ERROR`, `DEBUG`).
- **User Selection**: Choose specific users to initiate requests, allowing management and approval of auto-requested content.
- **Cron Job Management**: Update the cron job schedule directly from the web interface.
- **Configuration Pre-testing**: Automatically validates API keys and URLs during setup.
- **Content Filtering**: Exclude requests for content already available on streaming platforms in your country.
- **External Database Support**: Use external databases (PostgreSQL, MySQL) in addition to SQLite for improved scalability and performance.
## Prerequisites
- **Python 3.x** or **Docker**
- **[TMDb API Key](https://www.themoviedb.org/documentation/api)**
- Configured **[Jellyfin](https://jellyfin.org/)**, **[Plex](https://www.plex.tv/)**, or **[Emby](https://emby.media/)**
- Configured **[Jellyseer](https://github.com/Fallenbagel/jellyseerr)** or **[Overseer](https://github.com/sct/overseerr)**
- (Optional) External database (PostgreSQL or MySQL) for improved performance
## Docker Usage
You can run the project using Docker Compose for easy setup and execution.
### Docker Compose Example
```yaml
services:
suggestarr:
image: ciuse99/suggestarr:latest
container_name: SuggestArr
restart: always
ports:
- "${SUGGESTARR_PORT:-5000}:${SUGGESTARR_PORT:-5000}"
volumes:
- ./config_files:/app/config/config_files
environment:
# Optional: Only needed if something goes wrong and you need to inspect deeper
- LOG_LEVEL=${LOG_LEVEL:-info}
# Optional: Customize the port (defaults to 5000 if not set)
- SUGGESTARR_PORT=${SUGGESTARR_PORT:-5000}
```
To start the container with Docker Compose:
```bash
docker-compose up
```
## Web Interface
Access the web interface at: http://localhost:5000 (or your custom port if configured with SUGGESTARR_PORT). Use this interface to configure the application, select your media service, and manage cron schedules.
Make sure your environment is set up correctly and that the application is running to access the web interface.
### Using a Specific Jellyseer/Overseer User for Requests
If you'd like to use a specific Jellyseer user to make media requests, follow these steps:
1. In the web interface, enable the user selection option by checking the corresponding box.
2. Select the desired user from the dropdown list.
3. Enter the password for the selected user.
4. The system will now use this user to make media requests, rather than using the admin or default profile.
Note: Currently, only local Jellyseer users are supported.
## Running Without Docker
For detailed instructions on setting up SuggestArr withouth Docker or as a system service, please refer to our [Installation Guide](https://github.com/giuseppe99barchetta/SuggestArr/wiki/Installation#documentation-to-run-the-project-without-docker).
## Join Our Discord Community
Feel free to join our Discord community to share ideas, ask questions, or get help with SuggestArr: [Join here](https://discord.gg/cpjBJ5sK).
## Contribute
Contributions are highly welcome! Feel free to open issues, submit pull requests, or provide any feedback that can improve the project. Whether you're fixing bugs, improving documentation, or adding new features, all contributions are greatly appreciated.
## License
This project is licensed under the MIT License.