cli_debrid - Debug Functions

Debug Functions

Bulk Delete from Database

IMDB or TMDB ID:

Delete Battery Database Files

Deletes the cli_battery.db, cli_battery.db-shm, and cli_battery.db-wal files from the db_content directory.

Reset Battery Show Status Cache

Forces all shows in the battery DB to be re-fetched from TVDB/Trakt on the next run. Use this to fix incorrect show statuses (e.g. "Ended" instead of "Canceled"). After running this, trigger "Update TV Show Status" from the Task Manager.

Delete Database

This will delete the database and all cache files (*.cache*.pkl) from the db_content directory.

Type DELETE to confirm:

Retain blacklisted items

Run Task Manually

Select Task:

Test Plex Item Lookup

Test if a database item can be found in Plex. Shows IMDb ID, TMDb ID, title, year, and whether Plex match was successful.

Item ID:

Fix Missing IMDb ID

Add or update the IMDb ID for a media item. Search by Item ID (single row) or TMDB ID (updates all matching rows at once).

Search by:

Item ID:

IMDb ID:

Remove Duplicate Database Items

Find and remove duplicate database items based on the filled_by_file field. This will identify items with the same filename and remove the duplicates, keeping only one entry per unique file.

Dry Run (Preview duplicates without deleting)

Restore Database from Backup

Restore the media_items.db database from a previous backup. ⚠️ This requires an application restart and will interrupt all active operations (~60 seconds downtime).

Backup current database before restore (Safety backup will be created as media_items_pre_restore_TIMESTAMP.db)

Clean Up Old Database Files

Scan and remove old database files, manual copies, and corrupted backups from both the backups folder and db_content directory. This helps free up disk space.

Backup cli_mount Databases

Back up cli_mount's entries.db and items.db to {data_path}/db/backups/. Uses the same tiered retention as CLI backups (4 copies per file). Also runs automatically with the daily CLI database backup task.

Restore cli_mount Database from Backup

Restore entries.db or items.db from a backup. Stop cli_mount before restoring, then start it again after. No container restart needed.

Create safety backup before restore

Clean Up Old cli_mount Backup Files

Scan and remove old cli_mount database backups to free up disk space.

Manage Duplicate Versions

Clean up duplicate versions based on quality, state, or version field matching. Handles failed upgrades, blacklist bugs, and multiple collected versions.

Media Type:

Dry Run (Preview what will be deleted without actually deleting)

Keep Action:

Version Match:

Exclude from deletion (optional): Enter comma or pipe-separated patterns. Items with filenames containing any of these patterns will be protected from deletion.

Scanning for failed upgrades...

Elapsed: 0s

Fix Episode Numbers

Fix incorrect episode numbers in database by parsing from filenames. Detects bug-created duplicates (same torrent, wrong episode) and can remove them. Uses filled_by_file, location_basename, or location_on_disk to extract filenames.

Dry Run (Preview changes without saving)

Show Duplicate Episodes (same show/season/episode with multiple entries)

Remove Bug-Created Duplicates (same torrent ID, wrong episode numbers)

Processing episodes...

Elapsed: 0s

Symlink Verification Queue

Loading verification stats...

Loading verification queue...

Convert Library to Symlinks

This function will convert an existing Plex library to use symlinks. This is ONLY intended for converting existing Plex libraries to a Symlinked library, and should only be done once. This action is not reversible.

Symlink Library Recovery

Recover database entries from your existing symlink structure if the database was lost. You must ensure that your symlink settings under Additional Settings match the structure of your folders to be recovered.

Recover Symlink Library

Riven Symlink Library Recovery

Recover database entries from your existing Riven symlink structure.

Recover Riven Symlink Library

Fix Zurg Symlinks

Fix symlinks where Zurg folder structure changed from having file extensions in directory names to not having them. This checks if the media file exists in the original path, and if not, looks for the folder without the extension and updates both the symlink and database.

Dry Run (Preview changes without saving)

Modify Symlink Base Paths

Update the base paths for symlinks and original file locations in the database. Use carefully!

Current Symlink Base: New Symlink Base:

Current Original Base: New Original Base:

Dry Run (Preview changes without saving)

Resync Symlinks with New Settings

Resyncs symlinks for collected items. If old/new original paths are provided, it first updates the stored original file paths in the database for matching items. Then, it regenerates symlinks for relevant collected items based on current symlink settings and these (potentially updated) original paths. If no paths are provided, it attempts to resync all collected items.

Rclone Mount to Symlinks

Scan an Rclone mount, fetch metadata, create DB entries, and generate symlinks.

Rclone Mount Path:

Symlink Base Path:

Dry Run (Preview changes without saving)

Migrate between usenet providers

Moves the stored .nzb of each item from one usenet backend to the other; the target re-fetches it from usenet. No re-search, categories preserved where the source exposes them. cli-debrid runs in a container, so it reads NzbDAV over HTTP and cli_mount from a mounted path (no Docker needed).

Before you run this:

The target re-downloads from usenet — subject to your provider's retention & connection limits.
Best-effort: cli_mount trims old .nzb files, so part of an older library may not be transferable.
Avoid running it during a Plex scan on the same library (heavy concurrent activity).
Start with a small limit to test before transferring everything.

Direction:

cli_mount nzb-store path (source):

Path inside this cli-debrid container to cli_mount's stored .nzb files. Bind cli_mount's appdata into cli-debrid (the same data_path bind the cli_mount DB tools use) and point this at its usenet/nzbs folder. Example compose volume: - /host/cli_mount/appdata:/cli_mount_data → then this path is /cli_mount_data/usenet/nzbs.

cli_mount URL (target): cli_mount API token (if auth enabled):

NzbDAV URL (target): NzbDAV SAB API token:

Target category (NzbDAV):

cli_mount's nzb-store is flat (no category), so transferred items land in this NzbDAV category. Must already exist in NzbDAV. To preserve categories, migrate one category at a time by pointing the path above at that category's releases.

Skip items already at target Max target queue depth Limit (0 = all)

Get Collected from Library (Plex)

Collection Type:

Cleanup My Plex Watchlist and Other Plex Watchlists

Removes all Collected items from My Plex Watchlist and all configured Other Plex Watchlists. If an item appears in multiple watchlists it will be removed from all of them.

Get Wanted Content

Source:

Version Propagator

Media Type:

Original Version:

Propagated Version:

Bulk Queue Actions

Select Queue:

Select Items:

Action:

Target Queue:

Manage Cache Files

Select Cache Files:

Plex RSS Watchlist (My Plex RSS Watchlist_1)

Plex RSS Watchlist (My Plex RSS Watchlist_2)

Overseerr (Overseerr_1)

Overseerr (Overseerr_2)

Other Cache Files:

Plex Collection State (not found)

Plex Smart Collection State

Plex Box Sets State (not found)

Trakt Lists Cache (not found)

Trakt IMDb ID Cache

Trakt Watchlist Cache (not found)

Adaptive List IMDb Cache (not found)

Poster Cache

Failed Upgrades History

Refresh Release Dates

Direct Emby/Jellyfin Scan

Trigger a full library scan on Emby/Jellyfin and add/update items in the database.

Move Item ID to Upgrading

Item ID:

Manual Blacklist

Manage Manual Blacklist

Plex Labels Management

Manage Plex labels for your content. These utilities allow you to view, apply, and remove labels manually, as well as sync labels from configured content sources.

View Items by Label

Search for items that have a specific Plex label applied.

Bulk Apply Labels from Source

Apply Plex labels to all existing items from a specific content source. This is useful for retroactively labeling content that was added before labels were configured.

Bulk Remove Labels

Remove a specific label from all items in the database and Plex.

Orphaned Label Cleanup

Find and remove labels that are tracked in the database but no longer exist on any content source configuration.

Sync Labels from Content Sources

Re-sync all labels based on current content source configurations. This will apply labels to all Collected items from sources that have Plex labels enabled.

Backfill Resolution Data

Extract resolution (2160p, 1080p, etc.) from stored file paths for Collected items missing resolution data. This is safe to run multiple times.

cli_mount DB Cleanup

Remove entries for a specific debrid provider from cli_mount's entries.db and items.db using infohash matching. Mixed folders (containing files from multiple providers) are rebuilt with only non-provider files kept.

⚠ Stop cli_mount before running a live cleanup. Dry run is safe to run anytime.

Debrid Provider:

DB Path: path to cli_mount's db/ folder inside container

Dry Run (scan only, no changes)

Backfill NZB File Names

Rename collected NZB items in the database and cli_mount to the structured NZB naming format (Title (Year) - {imdb-...} - Version - (Original.Release.Name)). Requires NZB file naming to be enabled in settings.

Dry Run (preview only, no changes)

Force (re-process even if already named)

cli_mount Cleanup Results

Current Rate Limit State

Loading rate limit information...

Plex Token Status

Personal Trakt Token Status

Torrent Tracking

View the history of torrent additions and their current status.

View Torrent History

Send Test Notification

Download Logs

Number of log lines:

API Summary

API call counts grouped by domain and time period.

Real Time API

Most recent API calls from the log.

Episode Fix Results

Cleanup Results

API Summary

Real Time API Calls

Notifications

Help & Information

Debug Functions

Bulk Delete from Database

Delete Battery Database Files

Reset Battery Show Status Cache

Delete Database

Run Task Manually

Test Plex Item Lookup

Fix Missing IMDb ID

Remove Duplicate Database Items

Restore Database from Backup

Clean Up Old Database Files

Backup cli_mount Databases

Restore cli_mount Database from Backup

Clean Up Old cli_mount Backup Files

Manage Duplicate Versions

Fix Episode Numbers

Symlink Verification Queue

Convert Library to Symlinks

Symlink Library Recovery

Riven Symlink Library Recovery

Fix Zurg Symlinks

Modify Symlink Base Paths

Resync Symlinks with New Settings

Rclone Mount to Symlinks

Migrate between usenet providers

Get Collected from Library (Plex)

Cleanup My Plex Watchlist and Other Plex Watchlists

Get Wanted Content

Version Propagator

Bulk Queue Actions

Select Items:

Manage Cache Files

Select Cache Files:

Refresh Release Dates

Direct Emby/Jellyfin Scan

Move Item ID to Upgrading

Manual Blacklist

Plex Labels Management

View Items by Label

Bulk Apply Labels from Source

Bulk Remove Labels

Orphaned Label Cleanup

Sync Labels from Content Sources

Backfill Resolution Data

cli_mount DB Cleanup

Backfill NZB File Names

cli_mount Cleanup Results

Current Rate Limit State

Plex Token Status

Personal Trakt Token Status

Torrent Tracking

Send Test Notification

Download Logs

API Summary

Real Time API

Episode Fix Results

Cleanup Results

🎉 You found an Easter Egg! 🎉

Release Notes

Support cli_debrid

Library Manager Settings

Discover Settings

Overlay Settings