Download Manager

A high-performance download manager based on the aria2 engine, supporting app downloads, Adobe component downloads, and Bilibili video downloads.

Accessing Download Manager

Click the "Downloads" icon in the left navigation bar to enter.

Interface Layout

The Download Manager page is divided into the following areas:

Top Metric Cards

Four cards display real-time download statistics:

Card	Content
In Progress	Number of currently downloading tasks
Completed	Number of completed download tasks
Failed	Number of failed tasks
Total Tasks	Total number of all tasks + new today

Toolbar

Button	Function
Import Adobe Package	Manually import a downloaded Adobe package folder; scan and install directly
Scan Local	Scan local download directory to recover historical download records (one-click recovery after DB clear)
Open Download Folder	Open the current download directory in Finder
Retry All	One-click retry for all failed tasks
Aria2 Downloader Settings	Open the aria2 RPC configuration panel

Filter Tabs

• Apps: Only show app download tasks
• Completed: Only show completed downloads

Task List

Each download task is displayed as a card containing:

• App icon and name (Adobe downloads displayed with a red-themed card)
• Download progress bar (percentage + downloaded/total size)
• Download speed (MB/s)
• Estimated time remaining (ETA: seconds/minutes/hours)
• Status label: Downloading / Paused / Completed / Queued
• Action buttons: Pause/Resume, Cancel, Open Folder

Task Operations

Pause and Resume

• Pause: Click the pause button on the right side of the task
• Resume: Click the resume button of a paused task (card displays "Paused, click to resume")
• Queued: When the number of tasks exceeds the maximum concurrent count, new tasks are queued (displaying "Queued · {size}")

Retry Failed Tasks

1. Failed tasks show a red status marker
2. Click the Retry button on a single task
3. Or click the "Retry All" button at the top to batch retry all failed tasks

Cancel and Delete

• Cancel: Stop download and clean up task record
• Delete: Delete completed/failed task records

Open File

For completed tasks, click "Open in Folder" to locate the downloaded file in Finder.

Download Path

Downloaded files are saved to the path configured by the user in Manage → System Settings → Download Settings. The path can be changed at any time in settings, and new tasks will save to the new path.

Aria2 Downloader Settings

Click the "Aria2 Downloader Settings" button in the toolbar to open the configuration panel. This panel communicates with the aria2 engine through the daemon's RPC interface.

Status Bar

The top of the panel displays:

• Running status indicator: Green dot indicates running; gray indicates stopped or disabled
• RPC Address: Current JSON-RPC connection address
• WebSocket Connections: {n} connections label
• Refresh button: Manually refresh status
• Error notice: If there is a recent error, a yellow warning bar displays detailed information

Service Configuration

Setting	Description	Default
Enable Aria2 RPC	Master switch. When off, downloads use the built-in engine; when on, exposes the RPC interface externally	On
Host	RPC listening address	127.0.0.1
Port	RPC listening port	6800
Allow Non-Loopback Hosts	Allow other devices on the LAN to access RPC. Security warning: only enable when explicitly needed	Off

Authentication Configuration

Setting	Description
RPC Token	Auto-generated secret key for aria2 RPC authentication. Can be copied and pasted into aria2 clients (e.g., AriaNg, Aria2 Explorer, etc.)
Show/Hide	Toggle key visibility
Copy	One-click copy key to clipboard
Reset	Clear the current key; a new random key will be generated by the backend upon saving
RPC Address	Complete JSON-RPC connection address (e.g., http://127.0.0.1:6800/jsonrpc), can be copied for use with external clients

External Client Access

After enabling Aria2 RPC and configuring the Token, you can use any aria2 client (such as AriaNg web interface, Aria2 Explorer browser extension) to connect to the RPC address, enter the Token, and remotely manage download tasks.

Security Whitelist

To prevent unauthorized access and path traversal attacks, three levels of whitelisting are provided (one value per line):

Whitelist	Description	Example
Allowed Origins	CORS origin whitelist, controls which web pages can access RPC	http://localhost:6880
Directory Whitelist	Directory paths where aria2 is allowed to write	/Users/name/Downloads
Option Whitelist	aria2 configuration items allowed to be modified via RPC	dir / out / split

Bilibili Video Download

For the full guide — Bilibili login, downloading favorites and collections, and download settings (quality / codec, etc.) — see the dedicated page Bilibili Video Download.

Download tasks are managed together here in the Downloads page, can be played once finished, and also appear in the media library after their directory is scanned.

Download Status Descriptions

Status	Color	Description
Downloading	Blue progress bar	Downloading, showing speed and ETA
Paused	Yellow	Manually paused; click to resume
Completed	Green	Download successful; can open folder to view
Failed	Red	Download error; can retry

Empty State

When there are no download tasks, the page displays the "No download tasks" message, guiding you to the Apps page to browse and select apps.