Eros Documentation

Eros 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.

Overview

What Eros Does

Eros provides automated content management for adult media by:

• Automatic Searching: Monitors for new releases and searches configured indexers
• Quality Management: Downloads content based on your quality preferences
• Library Organization: Automatically organizes downloaded content in your media library
• Upgrade Management: Can upgrade existing content to better quality when available
• Download Client Integration: Works with popular download clients like qBittorrent, Deluge, etc.

How Huntarr Enhances Eros

Huntarr adds intelligent automation on top of Eros:

• Smart Search Timing: Prevents overwhelming indexers with too many requests
• Missing Content Detection: Identifies and prioritizes missing content
• Upgrade Intelligence: Finds better quality versions of existing content
• Rate Limiting: Respects API limits to prevent bans or throttling
• Multi-Instance Support: Manage multiple Eros instances from one interface

Instance Configuration

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

Instance Name

What it does: Friendly name to identify this Eros instance in logs and notifications.

Examples: "Main Eros", "4K Eros", "Private Tracker Eros"

Best practices: Use descriptive names that help you identify the purpose of each instance, especially if you have multiple setups.

Instance URL

What it does: The base URL where your Eros instance is accessible.

Format examples:

• Local: http://localhost:6969
• Docker: http://eros:6969
• Remote: http://192.168.1.100:6969
• Reverse Proxy: https://eros.yourdomain.com

Important: Don't include /api at the end - Huntarr adds this automatically.

API Key

What it does: Authentication key that allows Huntarr to communicate with your Eros instance.

How to find it:

1. Open your Eros web interface
2. Go to Settings → General
3. Look for API Key in the Security section
4. Copy the long alphanumeric string

Security note: Keep your API key private - it provides full access to your Eros instance.

Instance Enabled

What it does: Controls whether Huntarr actively monitors this Eros instance.

When to disable: Temporarily stop monitoring without losing your configuration, during maintenance, or for testing.

Search Settings

Configure how Huntarr searches for content in your Eros instance.

Search Mode

What it does: Determines what type of content Eros will search for.

Options:

• Movie: Search for individual movies/scenes
• Collection: Search for movie collections or series

Recommendation: Use "Movie" for most setups unless you specifically focus on collections.

Missing Search

What it does: Enable (1) or disable (0) automatic searching for missing content.

How it works: When enabled, Huntarr will automatically search for content that's monitored in Eros but not yet downloaded.

Recommendation: Keep enabled (1) for automated content acquisition.

Upgrade Search

What it does: Enable (1) or disable (0) automatic searching for quality upgrades.

How it works: When enabled, Huntarr will search for higher quality versions of content you already have.

Recommendation: Enable only if you want automatic quality upgrades and have sufficient storage space.

Sleep Duration

What it does: Time (in seconds) between Huntarr processing cycles for this app.

How it affects performance:

• 300-600 seconds (5-10 min): Faster response, more system load
• 900-1800 seconds (15-30 min): Balanced approach (recommended)
• 3600+ seconds (1+ hour): Less frequent checks, lower system load

Default: 900 seconds (15 minutes) provides a good balance for most users.

API Cap - Hourly

What it does: Maximum API requests Huntarr will make to this Eros instance per hour.

Safe recommendation: 20 requests per hour is a conservative, safe limit that prevents overwhelming your Eros instance.

Why this matters:

• Prevents API abuse and potential bans
• Keeps your Eros instance responsive
• Avoids overwhelming indexers through Eros
• Maintains good neighbor policies with private trackers

Adjustment guidelines: Only increase if you have specific performance needs and understand the implications.

Filtering Options

Monitored Only

What it does: Only process content that's marked as "monitored" in Eros.

How it works: Eros allows you to add content to your library without monitoring it for downloads. This setting respects those choices.

Recommendation: Keep enabled to respect your monitoring preferences in Eros.

Skip Future Releases

What it does: Skip content with release dates in the future.

Why this helps: Prevents wasting searches on content that isn't available yet.

Recommendation: Keep enabled to avoid searching for unreleased content.

Tag Processed Items

What it does: Add a "huntarr-processed" tag to content that Huntarr has attempted to process.

Benefits:

• Track what Huntarr has worked on
• Prevent duplicate processing
• Useful for troubleshooting and statistics
• Helps identify items that may need manual attention

Recommendation: Keep enabled for better tracking and troubleshooting.

Swaparr Integration

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

When to Enable Swaparr

• You frequently have stalled downloads
• Your download queue gets clogged with failed items
• You want hands-off automation
• You use public trackers where quality varies

When to Be Cautious

• You use private trackers with strict ratio requirements
• You prefer manual control over your downloads
• You have very slow internet where downloads take a long time

Troubleshooting

Connection Issues

Can't connect to Eros:

1. Verify the URL is correct and Eros is accessible
2. Check that the API key is valid and correctly entered
3. Ensure Eros is running and not blocked by firewalls
4. Test the connection from the same network as Huntarr

Search Issues

No content being found:

1. Check that content is properly monitored in Eros
2. Verify your indexers are working in Eros
3. Review the API cap settings - too low may limit searches
4. Check Huntarr logs for specific error messages

Performance Issues

Huntarr running slowly:

1. Increase sleep duration to reduce processing frequency
2. Lower API cap to reduce server load
3. Check system resources (CPU, RAM, disk space)
4. Review logs for any error patterns

Best Practices

Recommended Settings for New Users

• Missing Search: Enabled (1)
• Upgrade Search: Disabled (0) until you understand the implications
• Sleep Duration: 900 seconds (15 minutes)
• API Cap: 20 requests per hour (safe and conservative)
• Monitored Only: Enabled
• Skip Future Releases: Enabled
• Tag Processed Items: Enabled

Safety Guidelines

• Start with conservative settings and adjust gradually
• Monitor your logs regularly, especially when starting
• Keep API limits low to maintain good relationships with indexers
• Test configuration changes during low-activity periods
• Always have backups of your Eros configuration

Community and Support

• Join our Discord community for real-time help
• Check the GitHub repository for issues and updates
• Visit our Reddit community for discussions
• Review logs carefully before asking for help - they contain valuable troubleshooting information