FriendarrDownloading Service for Friend Libraries

Fetches media from remote Plex, Emby, and Jellyfin instances — the companion to Seerr's Friend Libraries feature.

Get Started

API Reference

Multi-Source Support

Downloads from Plex, Emby, and Jellyfin servers with automatic source-specific authentication.

Two-Stage Downloads

Files download to an incomplete directory first, then hard-link to the completed path — atomic and safe.

Webhook Notifications

HMAC-SHA256 signed webhooks for download events — requested, started, complete, and failed.

Schedule Gating

Configure time windows per day of week to restrict when downloads can run.

Seerr Integration

Designed as Seerr's companion. Seerr sends download requests, Friendarr handles the transfer.

Seerr-Styled Web UI

Dark-themed dashboard for managing the queue, API keys, source endpoints, webhooks, and schedules.

Architecture

Friendarr is a standalone Express microservice that receives download requests from Seerr (or any HTTP client), connects to the remote media server, downloads the file, and places it in the correct library directory.

Seerr handles the full request lifecycle — discovery, approvals, user management, notifications
Friendarr is a lightweight companion that only does one thing: download files from friend libraries
They communicate over a REST API authenticated with API keys

Request Flow

Screenshots

Setup Wizard — language selection on first launch

Queue Dashboard — monitor and manage downloads

Settings — configure sources, schedules, and paths

Logs Viewer — real-time server log tail

Quick Start

bash

# Clone and install
git clone https://github.com/chaosloth/friendarr.git
cd friendarr
pnpm install

# Configure
cp .env.example .env
# Edit .env — set API_KEY to a secure random string

# Build and run
pnpm build
pnpm start

Open http://localhost:5056 and enter your master API key to access the dashboard.

Docker