Whisparr V3 (Eros) Documentation
Whisparr V3 (Eros) is the newer version of the automated adult content downloading and management application. Huntarr integrates with your existing Whisparr V3 instance to automatically search for missing content and quality upgrades that Whisparr doesn't actively hunt for.
Whisparr V3 Instance Setup
Adding Your Whisparr V3 Instance
To connect your existing Whisparr V3 instance to Huntarr:
- Navigate to the Whisparr V3 section in Huntarr
- Click "Add Whisparr V3 Instance" if you don't have one configured
- Fill in your Whisparr V3 connection details
- Test the connection to ensure Huntarr can communicate with Whisparr V3
Connection Settings
Configure these settings to connect Huntarr to your Whisparr V3 instance:
| Setting | Description | Example | Notes |
|---|---|---|---|
| Name | Friendly name for this Whisparr V3 instance | Default, Eros-4K, Premium | Useful when running multiple Whisparr instances |
| URL | Base URL for your Whisparr V3 instance | http://10.0.0.10:6969 | Include protocol (http/https) and port |
| API Key | Whisparr V3 API key for authentication | f48i21g1736h9jh8e0f2d19h7g5e913 | Found in Whisparr V3 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 V3 instance. These settings control Huntarr's behavior when processing your adult content library.
Missing Search Mode
Determines how Huntarr searches for missing content:
- Movies: Searches for individual movies/scenes. Standard mode for most collections
- Performers: Searches at the performer level for complete works
- Studios: Searches by studio for specific production companies
- Series: Searches for content series and franchises (V3 enhancement)
Upgrade Mode
Controls how Huntarr handles quality upgrades:
- Movies: Upgrades individual movies/scenes when better quality becomes available
- Performers: Upgrades at the performer level for consistent quality
- Studios: Upgrades entire studio collections when better quality is found
- Series: Upgrades complete series when better quality is available (V3 enhancement)
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 |
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 V3. 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 V3, only searching for content from performers you're actively monitoring.
Studio Filtering
Configure which studios Huntarr should prioritize or exclude when searching for content.
Series Management (V3 Feature)
Whisparr V3 introduces enhanced series management. Huntarr can search for missing episodes within series and upgrade entire series collections.
Enhanced Metadata (V3 Feature)
V3 provides improved metadata handling, allowing for more accurate searches based on enhanced performer, studio, and content information.
Whisparr V3 Enhancements
What's New in V3 (Eros)
Whisparr V3 brings several improvements that enhance Huntarr's integration:
Improved Database Structure
Better organization of content, performers, and metadata for more accurate searches.
Enhanced Search Capabilities
More sophisticated search algorithms that work better with Huntarr's automated searching.
Better Performance
Optimized API responses and reduced resource usage for smoother integration with Huntarr.
Improved Security
Enhanced API security features that work seamlessly with Huntarr's authentication.
Troubleshooting
Common Issues
Connection Failed
If Huntarr can't connect to your Whisparr V3 instance:
- Verify the URL is correct and includes the protocol (http/https)
- Check that the port number is correct (default: 6969)
- Ensure the API key is copied correctly from Whisparr V3 Settings > General > Security
- Confirm Whisparr V3 is running and accessible from Huntarr's network
- Check firewall settings if Huntarr and Whisparr V3 are on different machines
V3 Migration Issues
If you're migrating from Whisparr V2 to V3:
- Ensure your V3 instance is properly configured and running
- Update your Huntarr configuration to point to the new V3 instance
- Verify that all your content has been properly migrated to V3
- Check that performer and studio information is correctly imported
No Missing Content Found
If Huntarr reports no missing content but you know there are gaps:
- Ensure "Monitored Only" is configured correctly for your needs
- Check that performers and content are marked as "Monitored" in Whisparr V3
- Verify "Skip Future Releases" isn't preventing searches for available content
- Review your performer and studio monitoring settings
- Check series monitoring settings (V3 feature)
Limited Content Availability
If Huntarr isn't finding content that should be available:
- Adult content indexers have much more limited content than mainstream indexers
- Consider adding more adult-specific indexers to Whisparr V3
- Check if your indexers support the content types you're seeking
- Verify your quality profiles match available content
- Utilize V3's enhanced metadata for better search accuracy
Rate Limiting Issues
If you're getting rate limited by adult indexers:
- Reduce the "API Cap - Hourly" setting to 50-100 requests
- Increase the "Sleep Duration" to 60+ minutes between cycles
- Lower the "Missing Search" and "Upgrade Search" limits to 1-2
- Adult indexers are typically much more restrictive than mainstream ones
V3 Specific Features Not Working
If V3-specific features aren't functioning properly:
- Ensure you're running the latest version of Whisparr V3
- Verify that Huntarr supports the V3 features you're trying to use
- Check the Huntarr logs for any V3-specific error messages
- Consider updating Huntarr if V3 support is limited