{"id":48986323,"url":"https://github.com/SuFxGIT/whatseerr","last_synced_at":"2026-05-04T16:01:04.349Z","repository":{"id":332868826,"uuid":"1119112177","full_name":"SuFxGIT/whatseerr","owner":"SuFxGIT","description":"WhatsApp bot for Seerr that allows users to search and request media via WhatsApp messages","archived":false,"fork":false,"pushed_at":"2026-02-16T22:39:16.000Z","size":1016,"stargazers_count":21,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-17T05:03:28.785Z","etag":null,"topics":["automation","bot","docker","jellyseerr","movie","notifications","overseerr","plex","request","seerr","tv","waha","whatsapp","whatseerr"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/SuFxGIT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-18T19:03:44.000Z","updated_at":"2026-02-16T22:39:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SuFxGIT/whatseerr","commit_stats":null,"previous_names":["sufxgit/whatseerr"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/SuFxGIT/whatseerr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuFxGIT%2Fwhatseerr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuFxGIT%2Fwhatseerr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuFxGIT%2Fwhatseerr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuFxGIT%2Fwhatseerr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SuFxGIT","download_url":"https://codeload.github.com/SuFxGIT/whatseerr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuFxGIT%2Fwhatseerr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32614385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","bot","docker","jellyseerr","movie","notifications","overseerr","plex","request","seerr","tv","waha","whatsapp","whatseerr"],"created_at":"2026-04-18T13:00:27.679Z","updated_at":"2026-05-04T16:01:04.343Z","avatar_url":"https://github.com/SuFxGIT.png","language":"JavaScript","funding_links":["https://buymeacoffee.com/sufx"],"categories":["👾 Companion Apps \u0026 Tools"],"sub_categories":["🔍 Media Requests \u0026 Discovery"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"logo.png\" alt=\"Whatseerr Logo\" width=\"200\"/\u003e\n\n  # Whatseerr\n\n  WhatsApp bot for Seerr that allows users to search and request media via WhatsApp messages.\n\n  [![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/sufx)\n\u003c/div\u003e\n\n## Features\n\n- 🔍 Search movies and TV shows from WhatsApp\n- 📺 Request media directly via chat messages\n- 🔔 Receive webhook notifications from Seerr\n- 👥 User mapping (WhatsApp phone numbers to Seerr user IDs)\n- ⚡ Rate limiting and message queuing\n- 🎯 Support for 4K requests (optional)\n\n## Screenshots\n\n📸 [View Screenshots](SCREENSHOTS.md)\n\n## Quick Start (Docker - Recommended)\n\n### Prerequisites\n\n- [WAHA](https://github.com/devlikeapro/waha) (WhatsApp HTTP API) running and configured\n- Seerr instance\n- Docker installed\n\n### 1. Pull the Image and Run\n\n```bash\ndocker pull ghcr.io/sufxgit/whatseerr:latest\n```\n\n#### Environment Variables\n\n| Variable | Description | Required | Default |\n|----------|-------------|----------|---------|\n| `TZ` | Timezone (e.g., `Asia/Kuwait`, `America/New_York`) | No | `UTC` |\n\n#### Docker Compose Example\n\n```yaml\nservices:\n  whatseerr:\n    image: ghcr.io/sufxgit/whatseerr:latest\n    container_name: whatseerr-bot\n    restart: unless-stopped\n    ports:\n      - \"3006:3006\"\n    volumes:\n      - /path/to/config:/config\n    environment:\n      - TZ=Asia/Kuwait\n```\n\n**Configuration Notes:**\n- On first run, a `config.example.json` will be created in your config directory\n- Rename it to `config.json` and update with your settings:\n  - `host`: The hostname/IP where Seerr, WAHA, and the bot can reach each other\n  - `jellyseerr.apiKey`: Get from Seerr → Settings → General\n  - `waha.apiKey`: Your WAHA API key\n  - `userIdMappings`: Map WhatsApp phone numbers (without @c.us) to Seerr user IDs\n    ```json\n    \"1234567890\": {\n      \"userId\": 1,\n      \"username\": \"\",\n      \"admin\": true\n    }\n    ```\n    - `\"1234567890\"`: WhatsApp phone number including country code (without @c.us suffix)\n    - `userId`: The user ID from your Seerr instance - each user has their own unique ID (found in Seerr → Users)\n    - `username`: Optional custom display name (leave empty to use Seerr username)\n    - `admin`: Add `\"admin\": true` if the user is an admin (omit or set to false otherwise)\n\n**Unraid:**\n- Repository: `ghcr.io/sufxgit/whatseerr:latest`\n- Port: `3006:3006` (TCP)\n- Volume: `/mnt/user/appdata/whatseerr/config` → `/config` (Read/Write)\n- Variable: `TZ=Your/Timezone`\n\n### 2. Configure WAHA Webhook\n\nPoint your WAHA session webhook to:\n```\nhttp://YOUR_HOST_IP:3006/requests\n```\n\nEnable these events:\n- `session.status`\n- `message`\n- `message.reactions`\n\n### 3. Configure Seerr Webhook (Optional)\n\nFor receiving notifications (approved/available/declined), add webhook in Seerr:\n\n**Webhook URL:**\n```\nhttp://YOUR_HOST_IP:3006/seerr\n```\n\n**Types:** Select notification types you want to receive\n\n## Usage\n\nSend a WhatsApp message to your WAHA-connected number:\n\n```\nr The Matrix\n```\n\nThe bot will:\n1. Search Seerr for \"The Matrix\"\n2. Return numbered results\n3. Wait for you to reply with a number (e.g., \"1\")\n4. Submit the request to Seerr\n\n**Available Commands:**\n- `r \u003ctitle\u003e` or `request \u003ctitle\u003e` - Search and request media\n- `r4k \u003ctitle\u003e` or `request4k \u003ctitle\u003e` - Request in 4K quality (if enabled)\n\n## Configuration Options\n\n### System\n- `protocol`: `http` or `https`\n- `host`: Shared hostname/IP for all services\n- `logging.level`: `info` or `debug`\n\n### Services\n- `jellyseerr.port`: Seerr port (default: 5055)\n- `jellyseerr.apiKey`: Your Seerr API key\n- `jellyseerr.defaultUserId`: Default user ID for requests\n- `waha.port`: WAHA port (default: 8584)\n- `waha.apiKey`: WAHA API key\n- `waha.session`: WAHA session name (default: \"default\")\n\n### Webhooks\n- `webhook.requests.path`: Path for WAHA webhook (default: `/requests`)\n- `webhook.requests.port`: Webhook server port (default: 3006)\n- `webhook.seerr.path`: Path for Seerr webhook (default: `/seerr`)\n\n### Mappings\n- `userIdMappings`: Map phone numbers to Seerr user IDs\n- `emailMappings`: Auto-populated from webhook notifications\n- `lidMappings`: Auto-populated for WhatsApp LID format support\n\n### Commands\n- `command`: Comma-separated list of request command aliases\n- `command4k`: Comma-separated list of 4K request command aliases\n- `help4k`: Show 4K commands in help message (default: false)\n\n## Viewing Logs\n\n```bash\ndocker logs -f whatseerr-bot\n```\n\n## Building from Source\n\n```bash\ngit clone https://github.com/sufxgit/whatseerr.git\ncd whatseerr\ndocker build -t whatseerr .\n```\n\n## Development\n\nFor local development without Docker:\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/sufxgit/whatseerr.git\n   cd whatseerr\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Create config**\n   ```bash\n   cp config/config.example.json config/config.json\n   nano config/config.json\n   ```\n\n4. **Run the bot**\n   ```bash\n   npm run bot\n   ```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSuFxGIT%2Fwhatseerr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSuFxGIT%2Fwhatseerr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSuFxGIT%2Fwhatseerr/lists"}