# Aria2 Download for Raycast

URL: https://www.raycast.com/1at3ncy/aria2-download

> One queue for direct URLs, torrents, magnet/BT, and LinkSwift netdisk links. Requires aria2 to be installed separately.

- Install: raycast://extensions/1at3ncy/aria2-download
- Author: [Jie](https://www.raycast.com/1at3ncy)
- Installs: 0
- Platforms: Windows
- Categories: Productivity, Developer Tools
- Updated: 2026-11-15
- Source: https://github.com/raycast/extensions/tree/8af54c245cb122054c4b0e6dda2e8e8633eb6549/extensions/aria2-download/

## Commands

- **Aria2 Tasks**: Show active, waiting, paused, completed and failed downloads.
- **Toggle Aria2**: Toggle the aria2 RPC daemon; the command subtitle shows the current daemon state.
- **Add Download**: Queue a URL, magnet link, or local .torrent file in one form.
- **Aria2 Configuration**: Edit aria2 HTTP, BT, RPC and notification settings.

## README

### Aria2 Download

Manage a local aria2 queue from Raycast.

- **Aria2 Tasks** — active, waiting, and stopped downloads with progress, speed, ETA, peers, pause/resume/remove, and a chunk heatmap or native mosaic view.
- **Toggle Aria2** — start or stop the local aria2 RPC daemon. When downloads are running, a confirmation is required before force-stopping it.
- **Add Download** — add direct URLs, magnet links, `.torrent` files, or remote `.torrent` URLs. aria2 can be started automatically and the task list opens after a successful add.
- **Aria2 Configuration** — tune HTTP, BitTorrent, RPC, notification, and auto-start/auto-stop settings. The generated RPC secret can be copied for LinkSwift.

#### Requirements

aria2 must be installed separately and available as `aria2c.exe` in `PATH` or a common install location.

If aria2 is missing, the extension prompts to open the official aria2 website instead of trying to install it automatically.

#### First Use

1. Install aria2.
2. Run **Aria2 Tasks**, **Toggle Aria2**, or **Add Download**.
3. The extension creates its settings, RPC secret, and runtime configuration automatically.

No manual engine initialization is required.

#### LinkSwift

LinkSwift can push supported netdisk links to the same local RPC endpoint. Copy the RPC secret from **Aria2 Configuration → Actions → Copy RPC Secret** and enter it in LinkSwift's aria2 settings.

Netdisk direct links should be added through LinkSwift, not pasted directly into Add Download, because those URLs require LinkSwift's Cookie, Referer, and User-Agent.

#### Notes

- The extension is Windows-only.
- The RPC endpoint listens on loopback only.
- BitTorrent downloads still upload while downloading; only download and share content you have permission to use.
- Without a public inbound port or restrictive NAT, BitTorrent peer discovery may be limited.
- Magnets without `tr=` trackers depend on DHT. If peers stay at zero, add public trackers in **Configuration → Extra Trackers** or use a `.torrent` file.

#### Privacy

The extension controls aria2 through its local RPC endpoint on `127.0.0.1`. When you add a remote `.torrent` URL, the extension asks aria2 to fetch that file using the request headers and proxy you supplied. aria2 also makes the download, tracker and peer connections needed for queued tasks.
