Skip to Content
DocsApplicationsAutomationSeedCross
SeedCross

SeedCross

Cross-seed torrents across multiple BitTorrent clients

SeedCross - Cross-Seed Automation

SeedCross is a web application for cross-seeding torrents across Deluge, qBittorrent, and Transmission. It’s a fork of Cross-Seed-AutoDL, providing an intuitive interface for automated torrent matching and management.

What is SeedCross?

SeedCross helps you maximize your seeding ratio by automatically finding and cross-seeding torrents across different trackers:

🔌 Multi-Client Support

Works with Deluge, qBittorrent, and Transmission seamlessly

🔍 Automated Matching

Automatically finds matching torrents across trackers

🌐 Web Interface

Easy-to-use Django-based web dashboard

📜 History Tracking

Keep track of all cross-seeded torrents

⚙️ Settings Management

Configure tracker connections and preferences

📊 Ratio Optimization

Maximize upload credit across multiple trackers

BitTorrent Client Required

You must have at least one supported BitTorrent client (Deluge, qBittorrent, or Transmission) installed and configured before using SeedCross.

Supported Integrations

🌊

BitTorrent Clients

qBittorrentDelugeTransmission
🔗

Tracker Types

Private TrackersSemi-Private TrackersRatio-Based Sites
🐍

Technology Stack

Python 3.11Django FrameworkSQLite DatabaseGunicorn WSGI

Installation

Install SeedCross

Install SeedCross for a specific user:

qb install seedcross -u username

Per-User Installation

SeedCross is installed per-user and runs under the specified user’s context. Each user gets their own isolated instance with separate configuration and database.

Installation Process

During installation, QuickBox Pro will:

  1. Create Python Virtual Environment - Isolated Python 3.11 environment at /opt/username/lib/python/SeedCross
  2. Clone SeedCross Repository - Downloads latest version from GitHub
  3. Install Dependencies - All required Python packages via pip
  4. Configure Django - Sets up the Django application with SQLite database
  5. Create Superuser - Automatically creates admin account using your QuickBox credentials
  6. Configure Nginx - Sets up reverse proxy for web access
  7. Enable Service - Starts the systemd service for automatic startup

CLI Commands

Basic Operations

CommandDescription
qb install seedcross -u usernameInstall SeedCross for a user
qb reinstall seedcross -u usernameReinstall SeedCross (preserves database)
qb update seedcross -u usernameUpdate to latest version
qb remove seedcross -u usernameRemove SeedCross completely

Usage Examples

Install SeedCross:

qb install seedcross -u myuser

Update SeedCross:

qb update seedcross -u myuser

Reinstall (fix corrupted installation):

qb reinstall seedcross -u myuser

Remove SeedCross and clean up:

qb remove seedcross -u myuser

Features

SeedCross on QuickBox Pro includes several enhanced features:

🔒 Isolated Environment

Runs in a dedicated Python virtual environment with per-user isolation and security

🔄 Auto-Restart

Systemd service with automatic restart on failure for reliable operation

🌐 Nginx Reverse Proxy

Integrated with QuickBox's nginx configuration with proper URL rewriting and CSRF handling

💾 Automatic Backups

Database and configuration automatically backed up during installation and updates

🔐 SSO Integration

Superuser account automatically created using your QuickBox credentials

📊 WAL Mode Database

SQLite configured with Write-Ahead Logging for improved performance and reliability

Service Management

SeedCross runs as a systemd service for reliable operation:

Check Service Status

systemctl status seedcross@username

Restart Service

systemctl restart seedcross@username

Stop Service

systemctl stop seedcross@username

View Live Logs

journalctl -u seedcross@username -f

Automatic Recovery

The SeedCross service is configured to automatically restart on failure (with a 5-second delay), ensuring continuous operation.

Accessing SeedCross

After installation, access the dashboard at:

https://your-server-ip/username/seedcross/

Or via your QuickBox Pro dashboard navigation, or the Service Control Panel on the main QuickBox dashboard.

Default Credentials

SeedCross uses your QuickBox Pro credentials:

  • Username: Your QuickBox username
  • Password: Your QuickBox password
  • Email: Your registered email address

Dashboard Features

The SeedCross interface provides:

  • Cross-Seed List - View and manage cross-seeded torrents
  • History - Track all cross-seeding activity
  • Settings - Configure tracker connections and client settings
  • Admin Panel - Django admin interface for advanced configuration

Configuration

Installation Paths

Application Files
/opt/username
SeedCross/
├── manage.py# Django management script
├── db/
│ └── db.sqlite3# SQLite database
├── seedcross/# Application code
└── static/# Static assets
lib/
└── python/
│ └── SeedCross/
│ │ └── .venv/# Python virtual environment
System Configuration
/etc
nginx/
└── software/
│ └── username.seedcross.conf# Nginx reverse proxy config
systemd/
└── system/
│ └── seedcross@username.service# Systemd service file

Default Port

SeedCross runs on port 8019 by default (auto-assigned if unavailable). The service is accessed via nginx reverse proxy at /username/seedcross/.

Troubleshooting

Common Issues

SeedCross not loading:

# Check if service is running
systemctl status seedcross@username
 
# Restart the service
systemctl restart seedcross@username
 
# Check logs for errors
journalctl -u seedcross@username -n 50

Permission errors:

# Fix ownership
chown -R username:username /opt/username/SeedCross
chown -R username:username /opt/username/lib/python/SeedCross
 
# Reinstall if issues persist
qb reinstall seedcross -u username

Database issues:

# Check database integrity
sqlite3 /opt/username/SeedCross/db/db.sqlite3 "PRAGMA integrity_check;"
 
# Run migrations
/opt/username/lib/python/SeedCross/.venv/bin/python3 /opt/username/SeedCross/manage.py migrate

Nginx 502 errors:

# Test nginx configuration
nginx -t
 
# Reload nginx
systemctl reload nginx
 
# Check if SeedCross service is running
systemctl status seedcross@username

Use Cases

Maximize Seeding Ratio

Cross-seed the same content across multiple trackers to:

📈 Increase Upload Credit

Earn ratio on multiple trackers simultaneously from a single download

✅ Maintain Requirements

Keep ratio requirements satisfied across different private trackers

🚀 Efficient Bandwidth

Maximize seeding efficiency by serving the same files to multiple places

Consolidate Torrent Management

Use SeedCross to:

📜 Track Content

Comprehensive history and logging of all cross-seeded content

🎛️ Manage Clients

Control multiple BitTorrent clients from a single unified interface

🤖 Automate Matching

Automatically detect and process matching torrents for new downloads

Best Practices

Do

  • Install your preferred BitTorrent client before SeedCross
  • Configure tracker API credentials securely in the web interface
  • Review cross-seed history regularly to verify successful operations
  • Use the same download paths across trackers for efficient matching
  • Keep SeedCross updated for latest tracker compatibility
  • Monitor your ratio requirements and adjust cross-seeding accordingly

Don't

  • Don't cross-seed content that violates tracker rules
  • Don't share your tracker API keys or passkeys
  • Don't run multiple SeedCross instances pointing to the same client
  • Don't ignore database integrity warnings
  • Don't forget to verify torrent hashes match before cross-seeding
  • Don't cross-seed without understanding tracker hit-and-run policies

Additional Resources

SeedCross GitHub

Source code and issue tracker

Cross-Seed Wiki

General cross-seeding documentation

r/trackers

Private tracker community discussions

🌊

BitTorrent Clients

qBittorrentDelugeTransmission
🤖

Automation Tools

AutobrrAutoscan
🎬

*arr Stack

RadarrSonarr

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support
Feature Previews
Community Configs
Active Discussions
Join Discord Server
NotifiarrUnpackerr