Whisparr V2 Documentation

Whisparr Logo
What is Whisparr V2? Whisparr V2 is an automated adult content downloading and management application. It monitors for new content, searches indexers, and automatically downloads content using your preferred download clients.

Whisparr V2 automates the process of monitoring and downloading adult content. It integrates with popular download clients and uses indexers to search for and download content automatically, making it easy to build and maintain an organized adult media library.

Note: This documentation covers Whisparr V2. For the newer Whisparr V3 (Eros), please see the Eros documentation.

Overview

What Whisparr V2 Does

Whisparr V2 provides automated content management for adult media by:

How Huntarr Enhances Whisparr V2

Huntarr adds intelligent automation on top of Whisparr V2:

Instance Configuration

Configure your Whisparr V2 instances to connect Huntarr with your Whisparr V2 installation(s).

Adding Your Whisparr V2 Instance

To connect your existing Whisparr V2 instance to Huntarr:

  1. Navigate to the Whisparr V2 section in Huntarr
  2. Click "Add Whisparr V2 Instance" if you don't have one configured
  3. Fill in your Whisparr V2 connection details
  4. Test the connection to ensure Huntarr can communicate with Whisparr V2

Connection Settings

Configure these settings to connect Huntarr to your Whisparr V2 instance:

Setting Description Example Notes
Name Friendly name for this Whisparr V2 instance Default, Adult-4K, Scenes Useful when running multiple Whisparr instances
URL Base URL for your Whisparr V2 instance http://10.0.0.10:6969 Include protocol (http/https) and port
API Key Whisparr V2 API key for authentication e37h10f0625g8ig7d9e1c08g6f4d802 Found in Whisparr V2 Settings > General > Security
Enabled Whether Huntarr should process this instance On/Off toggle Disable to temporarily stop processing

Search Settings

Configure how Huntarr searches for missing content and upgrades in your Whisparr V2 instance. These settings control Huntarr's behavior when processing your adult content library.

Missing Search Mode

Determines how Huntarr searches for missing content:

Upgrade Mode

Controls how Huntarr handles quality upgrades:

Search Limits

Control how many items Huntarr processes per cycle to avoid overwhelming your indexers:

Setting Description Recommended Notes
Missing Search Number of missing items to search per cycle 1-3 Set to 0 to disable missing searches
Upgrade Search Number of items to upgrade per cycle 1-2 Set to 0 to disable upgrade searches
Sleep Duration Time in seconds between processing cycles 3600 (60 min) Adult indexers often have strict limits
API Cap - Hourly Maximum API requests per hour 100 or less Adult indexers typically have very low limits
Important: Adult content indexers typically have very strict rate limits and limited content. Use very conservative settings to avoid being banned.

Additional Options

Fine-tune Huntarr's behavior with these additional settings:

Monitored Only

When enabled, Huntarr will only search for content that is marked as "Monitored" in Whisparr V2. This prevents searches for performers or content you've intentionally unmonitored.

Skip Future Releases

When enabled, Huntarr will skip content with future release dates. This prevents unnecessary searches for content that hasn't been released yet.

Performer Monitoring

When enabled, Huntarr will respect your performer monitoring settings in Whisparr V2, only searching for content from performers you're actively monitoring.

Studio Filtering

Configure which studios Huntarr should prioritize or exclude when searching for content.

Swaparr Integration

Enable Swaparr monitoring for this Whisparr V2 instance to automatically clean up stalled downloads.

What is Swaparr? Swaparr monitors your download queues and automatically removes stalled, failed, or problematic downloads to keep your automation running smoothly. Learn more about Swaparr configuration.

When to Enable Swaparr

When to Be Cautious

Troubleshooting

Common Issues

Connection Failed

If Huntarr can't connect to your Whisparr V2 instance:

No Missing Content Found

If Huntarr reports no missing content but you know there are gaps:

Limited Content Availability

If Huntarr isn't finding content that should be available:

Rate Limiting Issues

If you're getting rate limited by adult indexers: