# searcharr

> Searcharr is a self-hosted Telegram bot for adding movies, series, and books to Radarr, Sonarr, and Readarr via chat.

- **Category:** Chat
- **Licence:** MIT
- **Latest version:** v3.4.0
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker Compose, Python
- **Tags:** Radarr, Sonarr, Media Management, Docker, Python, Readarr, Telegram bot, Chatops

## Description

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.

## Links

- [Homepage](https://github.com/toddrob99/searcharr)
- [Docker](toddrob/searcharr)
- [GitHub Repository](https://github.com/toddrob99/searcharr)
- [Docker Hub](https://hub.docker.com/r/toddrob/searcharr)
- [Configuration Wiki](https://github.com/toddrob99/searcharr/wiki/Configuration-::-settings.py)
- [Language Translations Wiki](https://github.com/toddrob99/searcharr/wiki/Language-Translations)

---
Source: https://selfhost.directory/project/searcharr