commit
0b072bc6d6
174
README.md
174
README.md
|
@ -1,87 +1,87 @@
|
||||||
webui-aria2
|
webui-aria2
|
||||||
===========
|
===========
|
||||||
|
|
||||||
![Main interface](/screenshots/overview.png?raw=true)
|
![Main interface](/screenshots/overview.png?raw=true)
|
||||||
|
|
||||||
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.
|
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:
|
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
|
````bash
|
||||||
aria2c --enable-rpc --rpc-listen-all
|
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.
|
If aria2 is not installed in your local machine then head on to https://aria2.github.io/ and follow the instructions there.
|
||||||
|
|
||||||
Then download the webui, you can either do that by downloading this repository and running index.html in the browser. Or you could just head on to http://ziahamza.github.io/webui-aria2/ and just start downloading files! After that you can also save it for offline use by saving from the browser save page as option.
|
Then download the webui, you can either do that by downloading this repository and running index.html in the browser. Or you could just head on to https://ziahamza.github.io/webui-aria2/ and just start downloading files! After that you can also save it for offline use by saving from the browser save page as option.
|
||||||
|
|
||||||
Tips
|
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](http://aria2.sourceforge.net/manual/en/html/aria2c.html#cmdoption--pause-metadata)
|
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
|
Configuration
|
||||||
=============
|
=============
|
||||||
Read and edit [configuration.js](configuration.js).
|
Read and edit [configuration.js](configuration.js).
|
||||||
|
|
||||||
DirectURL
|
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.
|
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)
|
If the above is not obvious, keep reading what this is about in [directurl.md](directurl.md)
|
||||||
|
|
||||||
Dependencies
|
Dependencies
|
||||||
============
|
============
|
||||||
Well, you need aria2. And a web browser (if that even counts!)
|
Well, you need aria2. And a web browser (if that even counts!)
|
||||||
|
|
||||||
Docker support
|
Docker support
|
||||||
==============
|
==============
|
||||||
There is two Dockerfile in this project, one is a common Dockerfile, which can be use for **testing purpose**.<br>
|
There is two Dockerfile in this project, one is a common Dockerfile, which can be use for **testing purpose**.<br>
|
||||||
The second is a **production ready** Dockerfile for raspberry and other ARM plateforms.
|
The second is a **production ready** Dockerfile for raspberry and other ARM plateforms.
|
||||||
|
|
||||||
### For testing purpose
|
### For testing purpose
|
||||||
|
|
||||||
You can also try or use webui-aria2 in your LAN inside a Docker sandbox.
|
You can also try or use webui-aria2 in your LAN inside a Docker sandbox.
|
||||||
|
|
||||||
Build the image
|
Build the image
|
||||||
|
|
||||||
````bash
|
````bash
|
||||||
sudo docker build -t yourname/webui-aria2 .
|
sudo docker build -t yourname/webui-aria2 .
|
||||||
````
|
````
|
||||||
|
|
||||||
..and run it! It will be available at: `http://localhost:9100`
|
..and run it! It will be available at: `http://localhost:9100`
|
||||||
|
|
||||||
````bash
|
````bash
|
||||||
sudo docker run -v /Downloads:/data -p 6800:6800 -p 9100:8080 --name="webui-aria2" yourname/webui-aria2
|
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
|
`/Downloads` is the directory in the host where you want to keep the downloaded files
|
||||||
|
|
||||||
### Production ready (ARM platform)
|
### Production ready (ARM platform)
|
||||||
|
|
||||||
This image contains both aria2 and webui-aria2.
|
This image contains both aria2 and webui-aria2.
|
||||||
|
|
||||||
Build it (may take several hours due to the aria2 compilation process. Don't panic and grap a coffee)
|
Build it (may take several hours due to the aria2 compilation process. Don't panic and grap a coffee)
|
||||||
```
|
```
|
||||||
docker build -f Dockerfile.arm -t yourname/webui-aria2 .
|
docker build -f Dockerfile.arm -t yourname/webui-aria2 .
|
||||||
```
|
```
|
||||||
Prepare the host volume:
|
Prepare the host volume:
|
||||||
This image required few file to be mounted in the container's `/data` folder.
|
This image required few file to be mounted in the container's `/data` folder.
|
||||||
```
|
```
|
||||||
.aria2/session.txt (empty file)
|
.aria2/session.txt (empty file)
|
||||||
.aria2/aria2.log (empty file)
|
.aria2/aria2.log (empty file)
|
||||||
.aria2/aria2.conf (aria2 configuration file, not webui-aria2 conf)
|
.aria2/aria2.conf (aria2 configuration file, not webui-aria2 conf)
|
||||||
./downloads/ (where the downloaded files goes)
|
./downloads/ (where the downloaded files goes)
|
||||||
```
|
```
|
||||||
|
|
||||||
Run it
|
Run it
|
||||||
```
|
```
|
||||||
docker run --restart=always -d -v /home/<USER>/data/aria2:/data -p 6800:6800 -p 9100:8080 --name="webui-aria2" yourname/webui-aria2
|
docker run --restart=always -d -v /home/<USER>/data/aria2:/data -p 6800:6800 -p 9100:8080 --name="webui-aria2" yourname/webui-aria2
|
||||||
```
|
```
|
||||||
|
|
||||||
Support
|
Support
|
||||||
=======
|
=======
|
||||||
For any support, feature request and bug report add an issue in the github project. [link](https://github.com/ziahamza/webui-aria2/issues)
|
For any support, feature request and bug report add an issue in the github project. [link](https://github.com/ziahamza/webui-aria2/issues)
|
||||||
|
|
||||||
License
|
License
|
||||||
=======
|
=======
|
||||||
Refer to the LICENSE file (MIT License). If the more liberal license is needed then add it as an issue
|
Refer to the LICENSE file (MIT License). If the more liberal license is needed then add it as an issue
|
||||||
|
|
10
index.html
10
index.html
|
@ -119,7 +119,7 @@
|
||||||
<ul class="dropdown-menu">
|
<ul class="dropdown-menu">
|
||||||
<li>
|
<li>
|
||||||
<a href="#" ng-click="addUris()">
|
<a href="#" ng-click="addUris()">
|
||||||
<span class="fa fa-fw fa-arrow-circle-o-down"> </span> {{ 'By URIs' | translate }}
|
<span class="fa fa-fw fa-link"> </span> {{ 'By URIs' | translate }}
|
||||||
</a>
|
</a>
|
||||||
</li>
|
</li>
|
||||||
<li ng-show="isFeatureEnabled('BitTorrent') && enable.torrent">
|
<li ng-show="isFeatureEnabled('BitTorrent') && enable.torrent">
|
||||||
|
@ -180,13 +180,13 @@
|
||||||
<li>
|
<li>
|
||||||
<a
|
<a
|
||||||
ng-click="changeCSettings()"
|
ng-click="changeCSettings()"
|
||||||
href="#"><span class="fa fa-fw fa-wrench"> </span> {{ 'Connection Settings' | translate }}</a>
|
href="#"><span class="fa fa-fw fa-cog"> </span> {{ 'Connection Settings' | translate }}</a>
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li>
|
<li>
|
||||||
<a
|
<a
|
||||||
ng-click="changeGSettings()"
|
ng-click="changeGSettings()"
|
||||||
href="#"><span class="fa fa-fw fa-wrench"> </span> {{ 'Global Settings' | translate }}</a>
|
href="#"><span class="fa fa-fw fa-cogs"> </span> {{ 'Global Settings' | translate }}</a>
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li>
|
<li>
|
||||||
|
@ -1252,10 +1252,10 @@
|
||||||
<div class="modal-body">
|
<div class="modal-body">
|
||||||
<p>
|
<p>
|
||||||
{{ 'To download the latest version of the project, add issues or to contribute back, head on to' | translate }}:<br />
|
{{ 'To download the latest version of the project, add issues or to contribute back, head on to' | translate }}:<br />
|
||||||
<a href="https://github.com/ziahamza/webui-aria2">http://github.com/ziahamza/webui-aria2</a>
|
<a href="https://github.com/ziahamza/webui-aria2">https://github.com/ziahamza/webui-aria2</a>
|
||||||
<br /><br />
|
<br /><br />
|
||||||
{{ 'Or you can open the latest version in the browser through' | translate }}:<br />
|
{{ 'Or you can open the latest version in the browser through' | translate }}:<br />
|
||||||
<a href="http://ziahamza.github.io/webui-aria2">http://ziahamza.github.io/webui-aria2</a>
|
<a href="https://ziahamza.github.io/webui-aria2">https://ziahamza.github.io/webui-aria2</a>
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="modal-footer">
|
<div class="modal-footer">
|
||||||
|
|
Loading…
Reference in New Issue
Block a user