Plexarr V2.1

Remote torrent search, auto-renaming, Usenet, file sharing, WiFi download, and Plex library management. Built for Linux Mint servers. Accessible from any device on your LAN.

rocket_launch Get Started menu_book Documentation code View on GitHub
v2.1.0 Flask SocketIO Prometheus Grafana Discord FFmpeg VPN SABnzbd

Architecture

graph TD A[Phone / Tablet] -->|HTTP 8080| D[WiFi Router] B[Laptop / PC] -->|HTTP 8080| D C[Discord Bot] -->|REST API| D D -->|LAN| S[Linux Mint Server] S --> E[Plexarr Flask Server] E -->|SocketIO| F[Screen Stream] E -->|REST| G[qBittorrent] E -->|REST| H[SABnzbd] E -->|REST| I[TMDB / Jikan / TVDB] E -->|Webhook| J[Discord] E -->|Metrics| K[Prometheus] E -->|CLI| L[Windscribe VPN] E -->|Proxy| M[Cloudflare Solver] E -->|Download| N[Rapidgator / URLs] E -->|Post-Process| O[FFmpeg] E -->|Watch| W[Watch Folder] E -->|WiFi Upload| U[WiFi Auto-Categorize] G -->|Files| P[Plex Library Folders] H -->|Files| P W -->|Auto-Categorize| P U -->|Auto-Categorize| P O -->|Default Tracks| P Q[PyWebView Desktop Client] -->|HTTP 8080| D

Plexarr is a self-hosted media command suite that runs on your Linux Mint server and gives you a single web interface to search torrents, query Usenet, auto-sort downloads into Plex paths, monitor progress, and push files over your local network.

tips_and_updates Design

Soft gradients, animated dot-matrix grid, morning parallax, Space Grotesk headings, Inter body text, and JetBrains Mono for code. Built for people who manage their own infrastructure.

Core Features

search

Torrent Search

Search across Nyaa.si, AnimeTosho, YTS, EZTV, and TorrentGalaxy. Results sorted by seeders. One-click magnet relay to qBittorrent. Optional Cloudflare solver for protected sites.

auto_awesome

Auto Renamer

guessit-powered parser strips 100+ release tags and sorts files into Plex-compliant paths. TV, movies, anime, and music handled automatically.

newspaper

Usenet / NZB

SABnzbd integration for NZB downloads. Search NZBGeek and send NZBs directly to SABnzbd. Queue, pause, resume, and monitor Usenet downloads from the same UI.

devices

LAN Access

Serve the web UI on your local network. Access from Windows, macOS, phones, or tablets without installing anything. Auto-detect server presence.

cloud_upload

WiFi File Share

Upload files from any phone or laptop on the same WiFi network. Auto-detects media type, renames to Plex format, and places files in the correct library folder. No destination selection needed.

movie

FFmpeg Post-Process

Auto-set default English audio and subtitle tracks. Detects naming variations like MediaHub-eng, Pahe.in, etc. Strip unwanted languages.

monitoring

Prometheus / Grafana

Export metrics to Prometheus. Pre-built Grafana dashboard with active torrents, download speeds, and upload stats.

chat

Discord Integration

Webhook notifications for torrents, uploads, and progress. Full Doplarr-style bot with slash commands for requests and status.

vpn_key

VPN Support

Windscribe CLI integration. Connect, disconnect, and check status from the web UI. Auto-connect on server start.

smart_display

Remote View

Optional JPEG screen stream over SocketIO. Click to control the server mouse. Keyboard input support. Disabled by default.

database

Metadata Enrichment

TMDB for movies and TV. Jikan v4 for anime. Cover art and backdrops. Optional TVDB for season data. All titles matched and cleaned before sorting.

link

URL Downloader

Download from Rapidgator (premium or free) and generic direct URLs. Queue multiple files. Auto-process with FFmpeg.

playlist_add

Batch Queue

Select multiple torrents from search results and add them all at once. Queue up to 50 items. Monitor batch progress.

folder_open

Watch Folder Auto-Categorize

Drop files into a monitored folder and Plexarr auto-detects media type (TV, movie, anime, music) and sorts them into Plex-compliant paths. Single-file and batch API endpoints included.

desktop_windows

Desktop Client

Cross-platform PyWebView client for Windows, macOS, and Linux. System tray, LAN discovery, keyboard shortcuts, mini mode, debug console, and multi-server profiles.

Quick Start

Install the server on your Linux Mint media box. Open the web UI from any device on the same network.

cd server/
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python app.py

Then open http://your-server-ip:8080 from any device. Full setup wizard available.

arrow_forward Setup Wizard menu_book Read Docs

Plexarr V2.1 — github.com/Compromisee/Plexarr

Space Grotesk. Inter. JetBrains Mono. Soft gradients. No emojis. Full control.