findarr

KO | EN

gitlite — search

#python #go #golang #javascript #bot #hacktoberfest #game #android #react #nodejs #php #aws

★ 56 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🎬 Findarr

![Docker](https://img.shields.io/badge/docker-ready-blue?logo=docker)
![Self-Hosted](https://img.shields.io/badge/self--hosted-yes-green)
![TMDB](https://img.shields.io/badge/TMDB-API-01b4e4)
![Radarr](https://img.shields.io/badge/Radarr-supported-orange)
![Sonarr](https://img.shields.io/badge/Sonarr-supported-blue)
![Jellyfin](https://img.shields.io/badge/Jellyfin-supported-purple)
![Plex](https://img.shields.io/badge/Plex-supported-red)

> Stop searching. Start finding.

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

---

---

## ✨ 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

- [TMDB API](https://www.themoviedb.org/)
- [Radarr](https://radarr.video/) / [Sonarr](https://sonarr.tv/)
- [Jellyfin](https://jellyfin.org/)
- [Docker](https://www.docker.com/)

---

## 🚀 Quick start

### Installation

<details>
<summary>🐳 <b>Docker</b></summary>

Create or copy the docker-compose.yml file:

```yaml
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`](/docker-compose.yml).

Run:

```bash
docker compose up -d
```

</details>

<details>
<summary>🪟 <b>Windows</b></summary>

Grab the `findarr-…-win-x64.zip` from the
[releases](https://github.com/lillifee/findarr/releases) and extract it.

Run directly:

```txt
./findarr.exe
```

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

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

</details>

### Open

```txt
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.

findarr

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README