https://github.com/ziahamza/webui-aria2
The aim for this project is to create the worlds best and hottest interface to interact with aria2. Very simple to use, just download and open index.html in any web browser.
https://github.com/ziahamza/webui-aria2
Last synced: 7 days ago
JSON representation
The aim for this project is to create the worlds best and hottest interface to interact with aria2. Very simple to use, just download and open index.html in any web browser.
- Host: GitHub
- URL: https://github.com/ziahamza/webui-aria2
- Owner: ziahamza
- License: mit
- Created: 2012-05-01T09:15:18.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2024-04-05T14:52:57.000Z (about 1 year ago)
- Last Synced: 2024-10-29T15:04:34.882Z (6 months ago)
- Language: JavaScript
- Homepage:
- Size: 15.4 MB
- Stars: 9,942
- Watchers: 267
- Forks: 1,468
- Open Issues: 132
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- stars - ziahamza/webui-aria2
- favorite-link - webui-aria2。
- awesome-starz - ziahamza/webui-aria2 - The aim for this project is to create the worlds best and hottest interface to interact with aria2. Very simple to use, just download and open index.html in any web browser. (JavaScript)
- awesome-hacking-lists - ziahamza/webui-aria2 - The aim for this project is to create the worlds best and hottest interface to interact with aria2. Very simple to use, just download and open index.html in any web browser. (JavaScript)
- awesome-homelab - WebUI-aria2 - aria2](https://img.shields.io/github/stars/ziahamza/webui-aria2?style=flat)  | The aim for this project is to create the worlds best and hottest interface to interact with aria2. Very simple to use, just download and open index.html in any web browser. | (Apps / Download)
- StarryDivineSky - ziahamza/webui-aria2 - aria2项目旨在打造最佳的aria2交互界面。它简单易用，只需下载并在浏览器中打开index.html即可使用。该项目致力于提供一个便捷的web界面来管理和控制aria2下载。特色在于其简洁的设计和易于上手的操作方式。用户可以通过web界面轻松添加、暂停、恢复和删除下载任务。项目目标是成为最受欢迎的aria2前端。它简化了aria2的使用，无需复杂的命令行操作。用户可以直观地监控下载进度和管理下载队列。该项目的核心是提供一个用户友好的图形界面，让更多人能够轻松使用aria2强大的下载功能。 (网络信息服务 / 资源传输下载)
README
# WebUI-Aria2
The aim for this project is to create the worlds best and hottest interface to interact with aria2. aria2 is the worlds best file downloader, but sometimes the command line brings more power than necessary. The project was initially created as part of the GSOC scheme, however it has rapidly grown and changed with tremendous support and feedback from the aria2 community.
Very simple to use, no build scripts, no installation scripts. First start aria2 in the background either in your local machine or in a remote one. You can do that as follows:
```bash
aria2c --enable-rpc --rpc-listen-all
```
If aria2 is not installed in your local machine then head on to https://aria2.github.io/ and follow the instructions there.
Then to use the WebUI-Aria2,
- You can either download this repository and open index.html from `docs` folder.
- Or you could just head on to https://ziahamza.github.io/webui-aria2 and start downloading files! Once you have visited the URL thanks to [Progressive Web Apps](https://developers.google.com/web/progressive-web-apps/) you can open the same URL even when you are offline.
- Or you can also use NodeJS to create simple server by using the following command from the project folder.
```bash
node node-server.js
```
# Tips
1. You can always select which files to download in case of torrents or metalinks. Just pause a download and a list icon should appear next to the settings button. To select which files to download before starting the download, give the flag --pause-metadata to aria2. See [link](https://aria2.github.io/manual/en/html/aria2c.html#cmdoption--pause-metadata)
# Configuration
Read and edit [configuration.js](src/js/services/configuration.js).
## DirectURL
This feature allows users to download files that they download from aria2 directly from the webui dashboard. If you are familiar with how webservers work, setup a http server that points at the configured aria2 download directory, check permissions. Then Specify a full url: `http://server:port/` in the webui directURL configuration.
If the above is not obvious, keep reading what this is about in [directurl.md](directurl.md)
# Dependencies
Well, you need aria2. And a web browser (if that even counts!)
# Docker support
There is two Dockerfile in this project, one is a common Dockerfile, which can be use for **testing purpose**.
The second is a **production ready** Dockerfile for arm32v7 platforms (including Raspberry Pi).
### For testing purpose
You can also try or use webui-aria2 in your LAN inside a Docker sandbox.
Build the image
```bash
sudo docker build -t yourname/webui-aria2 .
```
..and run it! It will be available at: `http://localhost:9100`
```bash
sudo docker run -v /Downloads:/data -p 6800:6800 -p 9100:8080 --name="webui-aria2" yourname/webui-aria2
```
`/Downloads` is the directory in the host where you want to keep the downloaded files
### Production ready (ARM platform)
This image contains both aria2 and webui-aria2.
Build it (may take several hours due to the aria2 compilation process. Don't panic and grab a coffee).
```
docker build -f Dockerfile.arm32v7 -t yourname/webui-aria2 .
```
This command will ends up building three images:
- The first one is just about compiling aria2 and goreman binaries. It MUST be deleted each time the `ARIA2_VERSION` is changed in the Dockerfile, otherwise you won't benefit from the update.
- The second is about building and downloading some go dependencies (goreman and gosu).
- The second one is the acutal aria2 container, the one you must use.
Prepare the host volume:
This image required few file to be mounted in the container.
```
/home/aria/aria2/session.txt (empty file)
/home/aria/aria2/aria2.log (empty file)
/home/aria/aria2/aria2.conf (aria2 configuration file, not webui-aria2 conf) must contains at least `enable-rpc=true` and `rpc-listen-all=true`
/data/downloads/ (where the downloaded files goes)
```
Run it
```
docker run --restart=always \
-v /home//data/aria2/downloads:/data/downloads \
-v /home//data/aria2/.aria2:/home/aria/.aria2 \
-p 6800:6800 -p 9100:8080 \
--name="webui-aria2" \
-d yourname/webui-aria2
```
# Contributing
Checkout [contributor's guide](CONTRIBUTING.md) to know more about how to contribute to this project.
# Deploy to Heroku
[](https://heroku.com/deploy)
# Support
For any support, feature request and bug report add an issue in the github project. [link](https://github.com/ziahamza/webui-aria2/issues)
# License
Refer to the LICENSE file (MIT License). If the more liberal license is needed then add it as an issue