4.9 KiB
 |
Profilarr
Manage quality profiles, custom formats, and release profiles across your Radarr and Sonarr instances. Define your profiles once with a Git-backed configuration database, then sync them to any number of \*arr instances. |
Features
Core
- Link - Connect to configuration databases like the Dictionarry database or any Profilarr Compliant Database (PCD)
- Bridge - Add your Radarr and Sonarr instances by URL and API key
- Sync - Push configurations to your instances. Profilarr compiles everything to the right format automatically
For Users
- Ready-to-Use Configurations - Stop spending hours piecing together settings from forum posts. Get complete, tested quality profiles, custom formats, and media settings designed around specific goals
- Stay Updated - Make local tweaks that persist across upstream updates. View changelogs, diffs, and revert changes when needed. Merge conflicts are handled transparently
- Automated Upgrades - The arrs don't search for the best release, they grab the first RSS item that qualifies. Profilarr triggers intelligent searches based on filters and selectors
For Developers
- Unified Architecture - One configuration language that compiles to Radarr/Sonarr-specific formats on sync. No more maintaining separate configs for each app
- Reusable Components - Regular expressions are separate entities shared across custom formats. Change once, update everywhere
- OSQL - Configurations stored as append-only SQL operations. Readable, auditable, diffable. Git-native version control with complete history
- Testing - Validate regex patterns, custom format conditions, and quality profile behavior before syncing
Documentation
See dictionarry.dev for complete installation, usage, and API documenation.
Getting Started
Production
TODO:
- Deno binaries (Linux, macOS, Windows)
- Docker image build process
- Publishing to Docker Hub and ghcr.io
- Example
compose.yml
Note
The parser service is only required for custom format and quality profile testing. Linking, syncing, and all other features work without it.
Development
Prerequisites
git clone https://github.com/Dictionarry-Hub/profilarr.git
cd profilarr
deno task dev
This runs the parser service and Vite dev server concurrently. See CONTRIBUTING.md for architecture documentation.
Environment Variables
| Variable | Default | Description |
|---|---|---|
PORT |
6868 |
Web UI port |
HOST |
0.0.0.0 |
Bind address |
APP_BASE_PATH |
Executable directory | Base path for data, logs, backups |
TZ |
System timezone | Timezone for scheduling |
PARSER_HOST |
localhost |
Parser service host |
PARSER_PORT |
5000 |
Parser service port |
License
Profilarr is free and open source. You do not need to pay anyone to use it. If someone is charging you for access to Profilarr, they are violating the spirit of this project.