dorkhub

findarr

Self-hosted discovery engine for movies and TV that learns your taste and avoids showing already rated content

Lillifee
TypeScript552 forksMITupdated 1 day ago
git clone https://github.com/Lillifee/findarr.gitLillifee/findarr

🎬 Findarr

Docker Self-Hosted TMDB Radarr Sonarr Jellyfin Plex

Stop searching. Start finding.

Find movies and shows you actually want — without endless scrolling.


Findarr Home
Findarr Vote
Findarr Explore

✨ What makes Findarr different

Finding something to watch shouldn’t feel like scrolling the same lists every day.

Findarr is built on a simple idea:

  • If you’ve already rated something, you won’t see it again
  • No re-evaluating the same titles over and over
  • Your feed always stays fresh

You go through content once — like it or dislike it — then move on.

No repetition. No clutter. No déjà vu lists.


⚡ How it works

Discover → Like / Dislike → New content only

Everything you've already rated disappears from your discovery flow.

Configure a voting pool (for example, the top 100 movies and shows) and go through it once.

After that, you'll usually only have a handful of new titles to rate every few days.

  • No endless lists.
  • No maintaining dozens of watchlists.
  • No endlessly tweaking filters.

Just a small, constantly refreshed set of movies and shows that adapts to your taste.


🧠 Smart recommendations

Findarr combines:

  • Trending and recent releases
  • Your likes and dislikes
  • Genre preferences
  • Keywords from the movies and shows you've rated

Each user builds their own taste profile and receives personalized recommendations.

That means everyone can share the same media stack while discovering different movies and shows.

Every movie or show you like is automatically sent to Radarr or Sonarr.

No separate request buttons. Just like it and move on.


🧩 Integrations


🚀 Quick start

Installation

🐳 Docker

Create or copy the docker-compose.yml file:

services:
  findarr:
    image: ghcr.io/lillifee/findarr:latest
    restart: unless-stopped
    ports:
      - 8585:8585
    volumes:
      - ./data:/app/apps/api/data

This is a minimal example. For all available options (environment variables, volume/bind-mount setup, etc.) see the full docker-compose.yml.

Run:

docker compose up -d
🪟 Windows

Grab the findarr-…-win-x64.zip from the releases and extract it.

Run directly:

./findarr.exe

Or run as a service — from an elevated (Administrator) terminal in the extracted folder:

./install-service.sh     # install and start on boot
./uninstall-service.sh   # remove the service

Open

http://localhost:8585

🔐 Setup

  1. Create admin account
  2. Add TMDB token
  3. Start discovering

Metadata

This product uses the TMDB API but is not endorsed or certified by TMDB. https://www.themoviedb.org/

Plex® is a trademark of Plex Inc. This project is not affiliated with or endorsed by Plex Inc.


❤️ Built for self-hosters

Hope you find something great to watch.

Stop searching. Start finding.

more like this

frirss

A modern, self-hosted, customizable web frontend for FreshRSS.

TypeScript51

emby-watchparty

A synchronized watch party application for Emby media servers. Watch videos together with friends in real-time, no matt…

Python51

YiMao

YiMao · 云海求片助手 — 双核心 Telegram 影视求片机器人。订阅模式:TMDB 智能搜索一键订阅 / 趣味求片模式:AI 生成五层地狱闯关,通关解锁优先求片。深度集成 MoviePilot + Emby/Jellyfin。…

Go52

search

search projects, people, and tags