Skip to content
coaxk edited this page Mar 12, 2026 · 2 revisions

MapArr

Path Mapping Problem Solver for Docker Media Stacks

MapArr analyzes your Docker Compose configurations, detects path conflicts that break hardlinks and imports, and generates one-click fixes. Built for the *arr ecosystem (Sonarr, Radarr, Lidarr, etc.) and their download clients.


Quick Links

Resource Description
Roadmap (Project Board) Live task tracker — what's done, in progress, and planned
Roadmap Strategy Stage descriptions, graduation criteria, what's next
Architecture How MapArr works — analysis engine, conflict categories, key patterns
Elder Council Review Pre-release review by 4 independent AI reviewers
Design Decisions Why we built it this way — principles, trade-offs, scope
Exclusions What we deliberately dropped and why
Test Infrastructure Test stacks, testing forms, how to run verification

Current State

Version: v1.5.2 (pre-beta) Branch: feature/pipeline-dashboard Tests: 833 passing, 3 skipped (Docker-specific) Elder Council Verdict: A- overall, READY TO SHIP

Stage 1 Progress (Pre-Beta)

Category Done Remaining
Security Hardening (S1-S5) 5/5 -
Code Fixes (C1-C4) 4/4 -
Code Hygiene (H1-H2) 2/2 -
UX Features (U1-U7) 6/6 -
Testing (T1-T2) 1/2 T2: Docker deployment test
Docs & Release (D1-D4) 0/4 All remaining

What's left before beta: Docker deployment test (T2) + documentation & release prep (D1-D4).


The Ecosystem

MapArr is part of a 3-tool ecosystem for Docker media stack management:

Tool Purpose Status
MapArr Path conflict detection & fix generation v1.5.2 pre-beta
ComposeArr Docker Compose hygiene linter (30 rules) v1.0 stable
SubBrainArr Subtitle pipeline configuration dashboard v1.6.1 stable

Future: shared code extraction across all three tools is planned for later stages.

Clone this wiki locally