discarr/docs/index.md
pyr0ball 1e535182a8
Some checks are pending
Deploy docs to GitHub Pages / deploy (push) Blocked by required conditions
Deploy docs to GitHub Pages / build (push) Waiting to run
docs: add Radarr workflow screenshots and update quickstart
- Add 03-radarr-filter.png: browse + filter movies by partial title
- Add 04-radarr-selected.png: movie selected in browse panel
- Add 05-mapped.png: completed drag-and-drop title mapping
- Update 03-title-mapping.png to completed-state screenshot
- docs/integrations/radarr.md: add workflow section with 3 annotated screenshots
- docs/quickstart.md: rewrite step 5 with browse/filter/drag workflow
- README.md and docs/index.md: use completed-mapping screenshot
2026-05-27 10:14:02 -07:00

2.5 KiB

Discarr

Scan disc rips. Map titles. Queue HEVC encodes. Notify Sonarr and Radarr when done.

Discarr is a self-hosted web UI that bridges disc ripping (VIDEO_TS / BDMV / ISO) into Sonarr and Radarr. Point it at a disc directory, map each title to the right episode or movie, and it handles the encode queue and arr notification.


Screenshots

Discarr main UI: scan source and encode history

Title mapping: completed drag-and-drop assignment with Review & Queue active

How it works

Disc rip (MakeMKV / HandBrake)
        │
        ▼
  Discarr web UI
  ┌─────────────────────────────┐
  │  1. Scan disc structure     │
  │  2. Map titles → arr items  │
  │  3. Queue HEVC encode       │
  │  4. Notify Sonarr / Radarr  │
  └─────────────────────────────┘
        │
        ▼
  Sonarr / Radarr import

Features

  • Disc scanning — detects VIDEO_TS, BDMV, multi-disc, and ISO structures automatically
  • IFO chapter extraction — reads DVD structure to split multi-episode discs correctly
  • Episode/movie mapping — browser UI maps disc titles to Sonarr episodes or Radarr movies
  • HEVC encode queue — dispatches ffmpeg or HandBrake jobs locally or over SSH
  • Arr notification — custom script hooks notify on import, file delete, or completion
  • qBittorrent integration — optional hook triggers a scan on torrent completion
  • Tdarr integration — optional ping to Tdarr after encode completes
  • Persistent job queue — survives restarts; jobs resume automatically
  • No npm dependencies — pure Node.js built-ins only

Requirements

Dependency Required Notes
Node.js 18+ Yes Runtime
ffmpeg + ffprobe Yes Disc scanning, encode dispatch
HandBrake CLI Recommended HEVC encoding (falls back to ffmpeg)
libdvdcss Recommended CSS-encrypted DVD decryption
libdvdread + libdvdnav Yes (DVD) DVD structure reading

License

GPL-3.0. Source on Forgejo and GitHub.