Skip to content

VREMSoftwareDevelopment/bwmon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Workflow Status Codacy Badge codecov

Issues Star Fork

Bandwidth Monitor

A simple shell script designed to run on AsusWRT-Merlin powered routers

Sample Usage by User Screenshot

Try a demo version of this application

Software Features:

  • Designed to run on AsusWRT-Merlin powered routers
  • Provides per user Bandwidth Monitoring
  • Generates bandwidth usage reports per user/month/year

Technical Features:

  • Shell script to collect bandwidth usage and to generate data file.
  • Web Based GUI to display bandwidth usage

Installation instructions:

  • Make sure that you have a harddisk or USB flash drive attached to router and it is formated and mounted.
  • Log into your router via ssh.
  • To install application type the following command in ssh terminal:
    • cd /mnt/<mounted_name>/
    • mkdir bwmon
    • cd bwmon
    • wget https://github.com/VREMSoftwareDevelopment/bwmon/releases/download/v3.1.2/bwmon.tar.gz
    • tar -xzvf bwmon.tar.gz
    • chmod +x server/install.sh
    • ./server/install.sh
  • Visit http://<your_router_ip>:<lighttpd_port>/bwmon/index.html to view bandwidth usage statistics.

Note:

  • Problem using wget:
    • error getting response: Connection reset by peer - add the following option --no-check-certificate
    • Or download the file from the web-site and copy to the folder.

Build Instructions:

  • Install node: see https://nodejs.org
  • Create project: git clone https://github.com/VREMSoftwareDevelopment/bwmon.git
  • Go to react subfolder
  • Install required node modules: npm install
  • See README.md in react subfolder