Skip to content

Configuration Guide

Ghost Downloader offers a rich set of options, allowing you to customize the software's behavior and appearance according to your needs. The configuration is typically stored in JSON format in the user's directory or the program directory, named Ghost Downloader 配置文件.json.

You can modify these options through the "Settings" menu in the software interface. Here's an explanation of some key configuration items:

General Settings

  • Language: Select the display language for the software. Ghost Downloader supports internationalization, currently with built-in Chinese and English.
  • Theme Mode:
    • System: Follow the operating system's light/dark mode setting.
    • Light: Force use of the light theme.
    • Dark: Force use of the dark theme.
  • Accent Color: The theme color for the software interface. On Windows and macOS, it defaults to trying to get the system accent color. It also attempts to read the system configuration in Linux KDE environments.
  • DPI Scale: Adjust the interface scaling factor, useful for high-resolution displays. Set to 0 for automatic detection.

Download Settings

  • Default Download Path: Set the default location where downloaded files are saved.
  • Max Concurrent Tasks (maxTaskNum): Limit the number of download tasks running simultaneously (Default 3, Range 1-10).
  • Global Speed Limit (speedLimitation): Limit the total download speed for all tasks, in KB/s (Default 0 for unlimited, Max 102400 KB/s).
  • Initial Chunks (preBlockNum): The number of parallel download threads used initially for each new download task (Default 8, Range 1-256). This option is ineffective (forced to 1) if the server does not support Range requests.
  • Min Chunk Size for Dynamic Allocation (maxReassignSize): When the remaining task size of a download thread exceeds this value (in MB), it will attempt to split the task to add more threads (Default 8 MB, Range 1-100 MB).
  • AI Smart Acceleration (autoSpeedUp): Enable or disable the acceleration feature that dynamically adds threads based on download efficiency (Default True).
  • Proxy Server (proxyServer): Set up a network proxy. Can be Off, Auto (attempts to detect system proxy), or a specific proxy address in the format (e.g., socks5://127.0.0.1:1080, http://user:pass@host:port).
  • SSL Certificate Verification (SSLVerify): Whether to verify the server's SSL certificate when establishing HTTPS connections (Default True). Disabling this might be insecure but can sometimes resolve download issues in specific network environments. Requires restarting the software after changing.

Browser Extension

  • Enable Browser Extension (enableBrowserExtension): Enable the communication interface with the browser extension (Default False).
  • Raise Window on Message (enableRaiseWindowWhenReceiveMsg): Whether to automatically bring the main window to the foreground when the browser extension sends a download task (Default False).

Plugin Settings

  • Plugin Load Path: Fixed to the plugins folder within the program directory.
  • Enable/Disable Plugins: (Likely managed via the interface)

Other

  • Check for Updates at Startup: Whether to automatically check for new versions when the program starts.
  • Silent Start: Whether to start in the background without showing the main window (can be controlled via the --silence command-line argument).

Note: Specific configuration item names and available values may change with version updates. Please refer to the actual options in the software's settings interface.