{"id":18090604,"url":"https://github.com/giuseppe99barchetta/SuggestArr","last_synced_at":"2025-03-29T04:31:32.087Z","repository":{"id":257892789,"uuid":"872358547","full_name":"giuseppe99barchetta/SuggestArr","owner":"giuseppe99barchetta","description":"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!","archived":false,"fork":false,"pushed_at":"2025-03-25T11:09:16.000Z","size":6218,"stargazers_count":533,"open_issues_count":15,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-25T11:33:12.335Z","etag":null,"topics":["automation","docker","emby","jellyfin","jellyseerr","media-automation","ombi","open-source","overseerr","plex","self-hosted","tmdb"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/giuseppe99barchetta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":"suggestarr","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"suggestarr","thanks_dev":null,"custom":null}},"created_at":"2024-10-14T09:51:40.000Z","updated_at":"2025-03-25T11:00:25.000Z","dependencies_parsed_at":"2025-01-06T12:24:36.792Z","dependency_job_id":"741a180e-e63d-47d6-bf6e-f0196bee4881","html_url":"https://github.com/giuseppe99barchetta/SuggestArr","commit_stats":null,"previous_names":["giuseppe99barchetta/jellyseer_request_automation"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giuseppe99barchetta%2FSuggestArr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giuseppe99barchetta%2FSuggestArr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giuseppe99barchetta%2FSuggestArr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giuseppe99barchetta%2FSuggestArr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/giuseppe99barchetta","download_url":"https://codeload.github.com/giuseppe99barchetta/SuggestArr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246140565,"owners_count":20729797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","docker","emby","jellyfin","jellyseerr","media-automation","ombi","open-source","overseerr","plex","self-hosted","tmdb"],"created_at":"2024-10-31T18:01:17.630Z","updated_at":"2025-03-29T04:31:32.073Z","avatar_url":"https://github.com/giuseppe99barchetta.png","language":"Python","funding_links":["https://patreon.com/suggestarr","https://buymeacoffee.com/suggestarr"],"categories":["Python","Media","self-hosted","Complimenting Apps","👾 Companion Apps \u0026 Tools"],"sub_categories":["🔍 Media Requests \u0026 Discovery"],"readme":"\u003cdiv align=\"center\"\u003e\n\n## 🚀 SuggestArr - Media Automation Made Simple\n\n![ezgif com-optimize (2)](https://github.com/user-attachments/assets/d5c48bdb-3c11-4f35-bb55-849297d521e7)\n\n![Build Status](https://img.shields.io/github/actions/workflow/status/giuseppe99barchetta/suggestarr/docker_hub_build.yml?branch=main\u0026label=Build\u0026logo=github)\n![Latest Release](https://img.shields.io/github/v/release/giuseppe99barchetta/suggestarr?include_prereleases\u0026label=Latest%20Release\u0026logo=github)\n[![Documentation](https://img.shields.io/badge/Docs-Available-blue?logo=readthedocs)](https://github.com/giuseppe99barchetta/SuggestArr/wiki)\n![Platform Support](https://img.shields.io/badge/platforms-linux%2Famd64%20|%20linux%2Farm64-blue?logo=linux)\n![Docker Pulls](https://img.shields.io/docker/pulls/ciuse99/suggestarr?label=Docker%20Pulls\u0026logo=docker)\n\n[![Buy Me a Coffee](https://img.shields.io/badge/Donate-Buy%20Me%20a%20Coffee-orange?logo=buy-me-a-coffee)](https://buymeacoffee.com/suggestarr)\n[![Reddit Upvotes](https://img.shields.io/badge/Reddit-Upvotes-ff4500?logo=reddit)](https://www.reddit.com/r/selfhosted/comments/1gb4swg/release_major_update_for_suggestarr_now/)\n![Last Commit](https://img.shields.io/github/last-commit/giuseppe99barchetta/suggestarr?label=Last%20Commit\u0026logo=github)\n[![](https://dcbadge.limes.pink/api/server/https://discord.gg/JXwFd3PnXY?style=flat)](https://discord.gg/JXwFd3PnXY)\n\u003c/div\u003e\n\nSuggestArr 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**.\n\n## Features\n- **Multi-Media Server Support**: Supports Jellyfin, Plex, and Emby for retrieving media content.\n- **TMDb Integration**: Searches for similar movies and TV shows on TMDb.\n- **Automated Requests**: Sends download requests for recommended content to Jellyseer or Overseer.\n- **Web Interface**: A user-friendly interface for configuration and management.\n- **Real-Time Logs**: View and filter logs in real time (e.g., `INFO`, `ERROR`, `DEBUG`).\n- **User Selection**: Choose specific users to initiate requests, allowing management and approval of auto-requested content.\n- **Cron Job Management**: Update the cron job schedule directly from the web interface.\n- **Configuration Pre-testing**: Automatically validates API keys and URLs during setup.\n- **Content Filtering**: Exclude requests for content already available on streaming platforms in your country.\n- **External Database Support**: Use external databases (PostgreSQL, MySQL) in addition to SQLite for improved scalability and performance.\n\n## Prerequisites\n- **Python 3.x** or **Docker**\n- **[TMDb API Key](https://www.themoviedb.org/documentation/api)**\n- Configured **[Jellyfin](https://jellyfin.org/)**, **[Plex](https://www.plex.tv/)**, or **[Emby](https://emby.media/)**\n- Configured **[Jellyseer](https://github.com/Fallenbagel/jellyseerr)** or **[Overseer](https://github.com/sct/overseerr)**\n- (Optional) External database (PostgreSQL or MySQL) for improved performance\n\n## Docker Usage\n\nYou can run the project using Docker Compose for easy setup and execution.\n\n### Docker Compose Example\n\n```yaml\nservices:\n  suggestarr:\n    image: ciuse99/suggestarr:latest\n    container_name: SuggestArr\n    restart: always\n    ports:\n      - \"${SUGGESTARR_PORT:-5000}:${SUGGESTARR_PORT:-5000}\"\n    volumes:\n      - ./config_files:/app/config/config_files\n    environment:\n      # Optional: Only needed if something goes wrong and you need to inspect deeper\n      - LOG_LEVEL=${LOG_LEVEL:-info}\n      # Optional: Customize the port (defaults to 5000 if not set)\n      - SUGGESTARR_PORT=${SUGGESTARR_PORT:-5000}\n```\nTo start the container with Docker Compose:\n\n```bash\ndocker-compose up\n```\n\n## Web Interface\n\nAccess 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.\n\nMake sure your environment is set up correctly and that the application is running to access the web interface.\n\n### Using a Specific Jellyseer/Overseer User for Requests\nIf you'd like to use a specific Jellyseer user to make media requests, follow these steps:\n\n1. In the web interface, enable the user selection option by checking the corresponding box.\n2. Select the desired user from the dropdown list.\n3. Enter the password for the selected user.\n4. The system will now use this user to make media requests, rather than using the admin or default profile.\n\nNote: Currently, only local Jellyseer users are supported.\n\n## Running Without Docker\nFor 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).\n\n## Join Our Discord Community\nFeel free to join our Discord community to share ideas, ask questions, or get help with SuggestArr: [Join here](https://discord.gg/cpjBJ5sK).\n\n## Contribute\nContributions 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.\n\n## License\nThis project is licensed under the MIT License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiuseppe99barchetta%2FSuggestArr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiuseppe99barchetta%2FSuggestArr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiuseppe99barchetta%2FSuggestArr/lists"}