Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/giuseppe99barchetta/SuggestArr
Effortlessly request recommended movies and TV shows to Jellyseer/Overseer based on your recently watched content on Jellyfin or Plex—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: 2 months ago
JSON representation
Effortlessly request recommended movies and TV shows to Jellyseer/Overseer based on your recently watched content on Jellyfin or Plex—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 (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-24T16:57:34.000Z (3 months ago)
- Last Synced: 2024-10-24T20:34:43.811Z (3 months ago)
- Topics: automation, docker, emby, jellyfin, jellyseerr, media-automation, ombi, open-source, overseerr, plex, self-hosted, tmdb
- Language: Python
- Homepage:
- Size: 1.66 MB
- Stars: 55
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.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)
README
## 🚀 SuggestArr - Media Automation Made Simple
[](https://github.com/giuseppe99barchetta/SuggestArr/wiki)
[](https://github.com/giuseppe99barchetta/suggestarr/discussions)
[](https://buymeacoffee.com/suggestarr)
[](https://www.reddit.com/r/selfhosted/comments/1gb4swg/release_major_update_for_suggestarr_now/)
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.
## 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)**
## 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:
- "5000:5000"
volumes:
- ./config_files:/app/config/config_files
```
To start the container with Docker Compose:
```bash
docker-compose up
```
## Web Interface
Access the web interface at: http://localhost:5000. 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
You can also run the project locally by installing the dependencies and setting the environment variables.
### Steps:
1. Install Python dependencies:
```bash
pip install -r requirements.txt
```
2. Run the project:
```bash
python app.py
```
3. Access to the web interface
The web interface will be available at: [http://localhost:5000](http://localhost:5000).
## 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.