XcelerateDL

XcelerateDL User Guide

This guide provides detailed information on how to use XcelerateDL’s features.

Basic Usage

Adding Downloads

To add a new download:

  1. Via Web UI:
    • Navigate to the main page
    • Enter a URL in the input field
    • Click “Add Download”
    • Optionally configure download settings in the dialog that appears
  2. Via GUI:
    • Enter a URL in the input field
    • Click “Add Download” button
    • Configure download settings in the popup dialog
  3. Via API:
    curl -X POST http://localhost:8000/api/downloads \
      -H "Content-Type: application/json" \
      -d '{"url": "https://example.com/file.zip"}'
    

Managing Downloads

Viewing Downloads

All active, queued, paused, and completed downloads appear in the download list, organized by their status.

Download Controls

For each download, you can:

Bulk Actions

You can also perform bulk actions:

YouTube Downloads

XcelerateDL provides specialized support for YouTube downloads.

Adding a YouTube Download

  1. Paste a YouTube URL into the download input field
  2. Select whether you want to download the video or just extract audio
  3. Choose quality settings (if available)

YouTube Options

API Example

curl -X POST http://localhost:8000/api/downloads \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://youtube.com/watch?v=VIDEO_ID",
    "is_youtube": true,
    "youtube_type": "video"
  }'

Bandwidth Management

XcelerateDL offers sophisticated bandwidth management features.

Bandwidth Settings

You can configure:

Allocation Modes

Priority Levels

Each download can be assigned a priority:

Configuring Bandwidth

To configure bandwidth settings:

  1. Go to Settings → Bandwidth
  2. Adjust the total bandwidth value (in bytes/second)
  3. Select allocation mode
  4. Configure other settings as needed

Download Scheduling

XcelerateDL allows you to schedule downloads for specific times.

Scheduling Options

Creating a Schedule

To schedule a download:

  1. Add a new download or select an existing one
  2. Click “Schedule”
  3. Set the desired time, recurrence, and other options
  4. Click “Save Schedule”

Smart Scheduling

XcelerateDL offers smart scheduling to distribute downloads across time periods:

  1. Select multiple downloads
  2. Click “Smart Schedule”
  3. Choose the time window and parameters
  4. XcelerateDL will intelligently space out downloads

API Example

curl -X POST http://localhost:8000/api/downloads \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/large-file.zip",
    "schedule": {
      "scheduled_time": "2023-12-31T23:00:00",
      "recurrence": "weekly",
      "days_of_week": [0, 3]
    }
  }'

File Organization

XcelerateDL automatically organizes downloads by file type.

File Categories

Downloads are organized into these categories:

Custom Save Locations

You can specify a custom save location for any download:

  1. When adding a download, click “Advanced Options”
  2. Specify a custom save path
  3. Optionally set this as the default for this file type

Search and Filtering

XcelerateDL provides powerful search capabilities.

Use the search box to filter downloads by:

For more complex queries, use the advanced search:

  1. Click “Advanced Search”
  2. Set filters for:
    • Text query
    • Category
    • Status
    • Date range
    • File size range
    • Tags

Tags

You can add tags to downloads for better organization:

  1. Select a download
  2. Click “Edit Tags”
  3. Add or remove tags
  4. Click “Save”

API Example

curl -X POST http://localhost:8000/api/downloads/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "ubuntu",
    "category": "compressed",
    "status": ["completed", "failed"],
    "date_from": "2023-01-01T00:00:00",
    "date_to": "2023-12-31T23:59:59",
    "min_size": 1048576,
    "max_size": 1073741824,
    "tags": ["linux", "iso"]
  }'

Configuration Options

XcelerateDL can be configured through the Settings menu.

General Settings

Advanced Settings

Keyboard Shortcuts

XcelerateDL provides keyboard shortcuts for common operations: