Skip to content
github-actions[bot] edited this page Aug 17, 2026 · 8 revisions

Censorarr Wiki

Applies to Censorarr 1.6.5

Censorarr is a self-hosted clean-audio manager for movies and TV shows. It scans media, transcribes dialogue, detects configured profanity, and can add a separate English - CLEAN audio track while preserving the original audio streams.

Installation options

Choose the guide for your platform:

What you actually need

Only two things are required:

  1. A Movies and/or TV Shows folder available to Censorarr.
  2. A transcription backend:
    • local CPU, or
    • the optional Censorarr GPU Worker on another NVIDIA-equipped host.

Everything else is optional.

Integration Required? What it adds
Plex No Rating filters, playback-aware start gating, library refresh
Radarr No Movie posters and richer movie metadata
Sonarr No TV/episode metadata
Bazarr No Automatic subtitle acquisition
GPU Worker No NVIDIA-accelerated Whisper transcription

Censorarr works without Plex, Radarr, Sonarr, or Bazarr. Without Radarr/Sonarr, the Media pages fall back to the configured media folders.

Interface tour

Dashboard

The Dashboard shows current processing, queue status, GPU-worker progress, system information, and live logs.

Censorarr dashboard

Movies library

The Movies page shows posters, metadata, quality, and each movie's current Censorarr status.

Censorarr Movies library

Movie details

Open a movie for a detailed view of its file, metadata, CLEAN conversion status, and processing controls.

Censorarr movie details

Recommended reading order

  1. Quick Start
  2. Pick your installation guide:
  3. First-Run Setup Wizard
  4. Media Folders & Permissions
  5. Transcription & GPU Worker
  6. Optional integrations:
  7. Profanity & Detection
  8. CLEAN Audio, Review & Safety
  9. Scheduling & Notifications
  10. Updating
  11. Troubleshooting
  12. Configuration Reference
  13. Security & Secrets

Strong recommendation for a new install

Start with:

  • a small test folder or small media set,
  • Dry Run enabled,
  • local CPU first if you want to validate the main install before adding the GPU Worker,
  • optional integrations disabled until the core scan works.

Once Censorarr can see and analyze your test files correctly, add integrations one at a time.

Important safety note

No speech-recognition or subtitle system can guarantee 100% profanity recall. Censorarr writes temporary output, validates it, and only then replaces the original pathname, but you should still keep backups of important media and test your settings before using Apply mode across a full library.

Clone this wiki locally