Self-host searcharr
v3.4.0Telegram bot to add media to Sonarr, Radarr, and Readarr
- Stars
- 304
toddrob/searcharr
What is searcharr?
Searcharr is a Telegram bot written in Python that bridges chat messaging with the *arr media management stack. Users authenticate with a password, then search for movies, TV series, or books using commands like /movie, /series, or /book. The bot returns results with inline buttons to view details on TVDB, IMDb, or TMDB, pick a root folder and quality profile, and add the item to the corresponding *arr instance. Admins can manage user access via the /users command. It runs as a long-lived container or Python process, stores its settings and SQLite database in a mapped data volume, and requires a Telegram bot token plus API keys and URLs for each *arr service you want to enable. The project is MIT-licensed, actively maintained, and distributed as a Docker image on Docker Hub.
Should you self-host searcharr?
searcharr scores 49/100 on selfhost.directory (how scoring works) and ranks #51 of 110 in Chat. It has 304 GitHub stars.
It shipped 1 stable release in the past year. The latest, v3.4.0, came out on 8 April 2026.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is Zulip (82/100, 26 133 stars). It scores higher overall, so compare the two before you pick. See searcharr vs Zulip side by side.
Features
- Admin user management
- Custom command aliases
- External metadata links
- Forced and selectable tags
- Movie search and add to Radarr
- Multi-language Support
- Python source installation
- Quality profile selection
- Root folder selection
- Series search and add to Sonarr
- Tagging with username
- Telegram bot interface
- User authentication with password
searcharr README
More in Chat
sharkordOpen-source, self-hosted chat with voice, video, and screen sharing for small groups. Runs as a single binary or Docker container, no external database needed.
SimpleX ChatOpen-source messenger without user IDs: E2E encrypted chats, groups, calls and files, with mobile, desktop and terminal clients and self-hosted relay servers.
socialstream.ninjaFree, open-source tool that consolidates chat from 100+ streaming platforms into one dashboard with OBS overlays, TTS, AI cohosts, and automation.
SongbirdA self-hosted, open-source chat platform with direct messages, groups, channels, media support, push notifications, and Telegram channel mirroring.
SoulFlow-OrchestratorSelf-hosted AI agent runtime with 9 LLM backends, 141-node workflow engine, HITL gates, AES-256-GCM vault, Slack/Telegram/Discord/web chat. All data on your server.
SourceWeftOpen-source, self-hostable AI workstation with multi-agent collaboration, skill library, MCP integrations, and cited knowledge — an alternative to ChatGPT and NotebookLM.
SpacebarSpacebar Server is a self-hosted, open-source Discord backend reimplementation (AGPL-3.0) with API, gateway, CDN, and experimental WebRTC voice.
SpacebotSpacebot is a self-hosted AI agent system for teams. Its multi-threaded architecture handles concurrent conversations across Discord, Slack, Telegram without blocking.
Spectrum 2Spectrum 2 is a self-hosted, open-source XMPP transport gateway letting XMPP users chat with contacts on IRC, Slack, Facebook, MSN, Yahoo, and other legacy IM networks.
sphinx-relaySelf-hosted Lightning Network relay that connects Sphinx chat clients to an LND node for decentralized, encrypted messaging over the Lightning Network.
StellaClawSelf-hosted Rust framework for durable AI agent conversations across Telegram, desktop, and Web API with isolated execution and SSH remote workspaces.
StoatSelf-hosted, open-source deployment of the Stoat group chat platform: back-end, web client, file server, voice and image proxies run as one Docker Compose stack.
0 comments