---
sidebar_position: 5
---

import {
  ConfigSection,
  Note,
  Warning,
  ElementNavigator,
  SectionTitle,
  styles
} from '@site/src/components/documentation';

# Blacklist Synchronizer

The Blacklist Synchronizer automatically synchronizes blacklist entries to all enabled qBittorrent clients every hour. This helps maintain consistent content filtering across your download clients.

<ElementNavigator />

<div className={styles.documentationPage}>

<div className={styles.section}>

<SectionTitle icon="⛔">Blacklist Sync</SectionTitle>

<ConfigSection
  title="Enable Blacklist Sync"
  icon="✅"
>

When enabled, Cleanuparr will automatically synchronize blacklist entries to all enabled qBittorrent clients every hour. The sync happens when the blacklist path or content changes.

<Note>
This feature updates the qBittorrent "Excluded file names" setting, but does not enable it.
</Note>

</ConfigSection>

<ConfigSection
  title="Blacklist Path"
  icon="🗂️"
>

Path to the blacklist content. This can be a local file path or an HTTP/HTTPS URL. The application computes a content hash and only pushes updates when the content changes.

**Examples:**
```
/data/blacklists/qbit-exclusions.txt
https://example.com/blacklist.txt
```

<Warning>
If Blacklist Sync is enabled, this field is required. For remote URLs, ensure the server is reachable from Cleanuparr and the certificate is valid (or adjust HTTP certificate validation settings).
</Warning>

</ConfigSection>

</div>

</div>