explaingit

loafdaddy/discoverr-bot

Analysis updated 2026-05-18

★ 7JavaScriptAudience · developerComplexity · 2/5Setup · moderate

TLDR

Discord bot that posts daily movie and TV recommendations from TMDb and adds request buttons that submit to your Overseerr/Jellyfin media server.

Mindmap

mindmap
  root((discoverr-bot))
    What it does
      Post daily media recommendations
      TMDb-powered discovery
      Request buttons to Overseerr
      Cron-scheduled posting
    Tech Stack
      JavaScript
      Node.js
      Docker Compose
      TMDb API
      Discord.js
    Use Cases
      Keep Discord server active with media picks
      Let users request movies from Discord
      Integrate with self-hosted media stack
    Audience
      Self-hosted media enthusiasts
      Discord server admins
      Home server users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Post a daily movie recommendation to a Discord channel with a one-click request button for your Overseerr server.

USE CASE 2

Surface hidden gems and new streaming arrivals in a dedicated Discord channel to keep your community engaged.

USE CASE 3

Let Discord users request TV shows or movies without leaving the app, routing requests through your existing Sonarr/Radarr stack.

What is it built with?

JavaScriptNode.jsDocker ComposeTMDb APIDiscord.js

How does it compare?

loafdaddy/discoverr-botadm1nsys/safari-ai-extensionarthurmoorgan/drift
Stars786
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatehardmoderate
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Discord bot token, TMDb API key, and a running Overseerr instance with a dedicated bot user account.

Provided as-is for personal and community use, no formal open-source license specified.

In plain English

Discoverr is a Discord bot that posts daily media recommendations into your Discord server and lets users request them directly from Discord. It is designed for people who already run a self-hosted media setup using tools like Jellyfin, Sonarr, Radarr, and Overseerr (also called Seerr). The bot posts scheduled recommendations into dedicated channels you configure, covering categories like movie of the day, TV show of the day, trending picks, new releases, what is newly available on streaming services, and hidden gems. Each recommendation post includes a request button. When a user clicks it, the bot submits a media request to your Seerr installation so it can be downloaded through your existing media stack. Recommendation data comes from TMDb, which is a public movie and TV database with a free API. The bot uses TMDb to find titles, fetch metadata (descriptions, ratings, artwork), and filter by streaming service availability in your region. You configure a watch region (for example AU, US, or GB) and which streaming services to include. A suggestion history file prevents the same titles from being recommended repeatedly. Setup requires a Discord bot token, a TMDb API key, and a running Seerr installation. The simplest deployment method is Docker Compose: copy an example environment file, fill in your credentials and channel IDs, and run docker compose up. Running directly with Node.js is also supported. The bot requires a dedicated Seerr user account with request permissions but not admin access, so requests still go through the normal approval process. The project is a lightweight companion service intended to sit alongside a self-hosted media stack. It has no web interface of its own, configuration is all done through environment variables. The README includes setup guides for the Discord developer portal, TMDb API, and Seerr user creation.

Copy-paste prompts

Prompt 1
Set up discoverr-bot with Docker Compose: configure the .env file with my Discord token, TMDb API key, and Overseerr credentials, then start it.
Prompt 2
How do I configure discoverr-bot to post recommendations only for Netflix and Hulu in the US region, and which channel ID variables do I need to set?
Prompt 3
Explain how discoverr-bot's suggestion history file works to prevent duplicate recommendations, and how do I reset it?
Prompt 4
Create a dedicated Overseerr user for discoverr-bot with the minimum required permissions so requests still go through the approval queue.

Frequently asked questions

What is discoverr-bot?

Discord bot that posts daily movie and TV recommendations from TMDb and adds request buttons that submit to your Overseerr/Jellyfin media server.

What language is discoverr-bot written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Docker Compose.

What license does discoverr-bot use?

Provided as-is for personal and community use, no formal open-source license specified.

How hard is discoverr-bot to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is discoverr-bot for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub loafdaddy on gitmyhub

Verify against the repo before relying on details.

Alternatives & similar repos