1. Installing
LoadBox needs aria2
to run. You can install it in Debian-based distros by issuing:
$ sudo apt-get install aria2
Note: Some features like rpc_secret
cannot be used on Debian/Raspbian Wheezy because of outdated aria2
package version 1.15.1-1. Please upgrade to Jessie or use a updated version.
Its dependent on Bash and Python2.7 too, if these are even count. Although it might be important if you are not using any distros and building kernel and filesystem from scratch.
Clone the repo to a directory like ~/LoadBox/
:
$ git clone https://github.com/zxcmehran/LoadBox.git
$ cd LoadBox
$ git submodule init
$ git submodule update
$ git submodule foreach git checkout .
It contains two submodules: SecurePyServer and webui-aria2.
There are four configuration files:
- Shell scripts configuration:
configuration.sh
- Aria2 configuration:
configuration.conf
- Python scripts configuration:
scripts/configuration.py
- And Web UI configuration:
webui/configuration.js
Some of these files are not existing and you can create them by copying template files named in the form of sample-[filename]
. The script creates default ones on first run.
Note: If you are not running on Raspbian, you should change ARIA2C_WORKING_USER
and HTTP_WORKING_USER
options in shell scripts configuration file.
Its recommended to disable direct booting to GUI. It will save your CPU/RAM and let you access console log output. You can use raspi-config
in Raspberry Pi to change this option.
The easiest way is adding this line at the end of /etc/rc.local
file. With the assumption of cloning in /home/[username]/LoadBox
:
/home/[username]/LoadBox/startup.sh
If you are using Raspberry Pi, you might want to disable screen sleep for watching console log for debugging purposes. Adding this line will prevent display blackout:
setterm -blank 0