How artyomsv/marauder works
Marauder is a self-hosted torrent-topic monitor. Users configure topics in the React app; the Go service schedules tracker checks and hands newly found torrent files or magnet links to configured clients, with notifications and durable state. Its documented capabilities also include authentication, cross-tracker search, Sonarr integration, configurable tracker mirrors, and operational observability. The graph follows documented product relationships and visible server/router wiring; several runtime subsystems are represented at their exact enclosing directory because their implementation was not sampled.
Main entry points: scheduler.go Check scheduler · App.tsx Web app · trackers Tracker plugins · router.go HTTP router
Components 20
User interface
- Web app
frontend/src/App.tsx - Topic preview
frontend/src/components/topics/PosterImage.tsx
API and service
- HTTP router
backend/internal/api/router.go - Topic handlers
backend/internal/api/handlers/topics.go - Authentication
backend/internal/auth - Check scheduler
backend/internal/scheduler/scheduler.go - Sonarr poller
backend/internal/sonarr/poller.go
Monitoring plugins
- Tracker plugins
backend/internal/plugins/trackers - Tracker search
backend/internal/api/handlers/trackers_search.go - Captcha login
backend/internal/plugins/captchalogin/engine.go - Domain mirrors
backend/internal/domains/store.go - Torrent clients
backend/internal/plugins/clients - Clearance solver
backend/internal/flaresolverr/client.go
State and integrations
- Sonarr
backend/internal/sonarr/client.go - PostgreSQL state
backend/internal/db - Notifier plugins
backend/internal/plugins/notifiers - Event stream
backend/internal/events/bus.go - Metrics and audit
backend/internal/metrics/metrics.go
Other components
- User
- CF sidecar
cfsolver/main.go
Connections 22
- User → Web app: configures topics
- Web app → HTTP router: calls API
- HTTP router → Topic handlers: routes requests
backend/internal/api/router.go - HTTP router → Authentication: routes sign-in
backend/internal/api/router.go - Topic handlers → PostgreSQL state: stores topics
- Check scheduler → Tracker plugins: checks topics
- Tracker plugins → Torrent clients: hands off torrents
- Web app → Tracker search: searches trackers
- Tracker search → Tracker plugins: queries plugins
- Tracker plugins → Captcha login: requests login
backend/internal/plugins/trackers/lostfilm/lostfilm_session.go - Check scheduler → Domain mirrors: uses mirror settings
- Check scheduler → PostgreSQL state: loads saved state
- Check scheduler → Notifier plugins: sends notifications
- Check scheduler → Event stream: publishes updates
- Web app → Event stream: receives live events
- Sonarr poller → Sonarr: polls instances
- Sonarr poller → PostgreSQL state: reads topics
- Sonarr → Check scheduler: adds monitored topics
- Check scheduler → Metrics and audit: records operations
- Tracker plugins → Clearance solver: mints clearance
- Clearance solver → CF sidecar: solves challenges
- Web app → Topic preview: renders previews