ziahamza/webui-aria2

★ 10,306JavaScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

Mindmap

mindmap
  root((webui-aria2))
    What It Does
      Browser dashboard
      Controls aria2
    Download Types
      Torrents
      Metalinks
      Direct HTTP links
    Setup Options
      Local HTML file
      Hosted GitHub Pages
      Docker container
    Features
      File selection in archives
      DirectURL file serving
      Raspberry Pi image

mindmap root((webui-aria2)) What It Does Browser dashboard Controls aria2 Download Types Torrents Metalinks Direct HTTP links Setup Options Local HTML file Hosted GitHub Pages Docker container Features File selection in archives DirectURL file serving Raspberry Pi image

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Manage torrent, metalink, and HTTP downloads through a visual browser dashboard without using terminal commands.

USE CASE 2

Run aria2 and the web interface together in a Docker container on a home server or Raspberry Pi for a self-hosted download box.

USE CASE 3

Select specific files within a torrent or metalink archive before starting the download to avoid downloading unwanted files.

Tech stack

JavaScriptHTMLDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires aria2 installed and running with its JSON-RPC interface enabled before you open the dashboard.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

WebUI-Aria2 is a browser-based interface for controlling aria2, a command-line download manager. Aria2 is a tool that downloads files, supporting formats like torrents, metalinks, and direct HTTP links, but it normally requires typing commands in a terminal. This project provides a visual dashboard so you can manage downloads through a web page instead. The setup is straightforward. You start aria2 on your computer or a server with a flag that enables its built-in remote control interface. Then you open a web page, either by downloading the project and opening a local HTML file, or by visiting the hosted version at the project's GitHub Pages URL. The dashboard connects to the running aria2 process and lets you add, pause, and monitor downloads without touching the terminal again. For torrent and metalink downloads, the interface lets you select which individual files inside an archive you want to download before starting. A directURL feature allows the dashboard to serve completed download files directly from the browser, though that requires setting up a basic file server pointed at the download directory. Docker support is included for running the combination of aria2 and the web interface in a container. One Dockerfile is for general testing, and a separate Dockerfile targets ARM devices like Raspberry Pi, bundling both aria2 and the web interface into a single image. The project has no build system or installation process beyond starting aria2. The only real dependency is aria2 itself. It was originally created as part of Google Summer of Code and has been maintained and extended by the community since then. The source code carries an MIT license.

Copy-paste prompts

Prompt 1

I have webui-aria2 connected to aria2 on my local machine. Write me a JavaScript snippet that adds a list of URLs to aria2 programmatically using its JSON-RPC API.

Prompt 2

Help me configure aria2 with the correct startup flags so webui-aria2 can connect to it securely with an RPC secret token.

Prompt 3

Write a Docker Compose file that runs both aria2 and webui-aria2 together, with downloads stored in a named volume on the host.

Open on GitHub → Explain another repo

← ziahamza on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.