A bandwidth monitor that shows per process network transfer(Alpha)
I built this project for my college assignment. It's my first python project/package for that matter. I am really overwhelmed by the response, however the application is still in early stages.
Here are some things that need to be fixed/added for eg.
- fix some bugs on frontend
- sort on transfer_amount instead
- fix error #15 on switching charts
- filter by device such as wlan,eth0 (frontend ui)
- show more details such as pid,user with improved ui (possible for linux)
- store history for restarts
- proper packaging
- unit tests
- nethogs (0.8.2 +) make sure its available in your path. This tool provides all the information and is quick to use from cli. Hogwatch gui plots graphs from this data over time.
- python 2.7
pip install hogwatch --upgrade
update: The package requires a pip module called pywebview for opening a webview window directly. It sometimes doesn't display output as it would on a web browser such as chrome, moreover installing it requires some additional packages on some systems as reported by users. see issue #6 and #4
As hogwatch runs a light web server. you can view using either
- Standalone (webview):
sudo hogwatchsudo is needed for nethogs. Its a bad idea to run the whole process as root. need to fix this.
sudo hogwatch serverview at
localhost:6432default port. for custom port specify port eg
sudo hogwatch server 8010. You can see this output from other devices on the network by specifying
ipin place of localhost.
The list contains the process names. Initially none of the processes is selected and global(accumulated) transfer rate/amount are displayed in the ui. Upon clicking one of the processes from the list, the metrics belonging to that process only will be shown. clicking on it again will toggle it off and will switch to global metrics once again.
note: on osx, currently only connections are shown and are yet to be mapped to the process.
Toggles on the top right:
- play/pause button stops updating the graph so you may scroll it sideways without it jumping to the end with each update. In future it will also pause list transition for easier selection.
- 5m,30m etc. are graph range selectors and determine the range window for the graph. For eg. if 5m is selected then the graph is scaled to show the latest 5 minute stats (pause and scroll for navigating history). "[ ]" button makes the range over the entire duration of the program.
- set up a virtualenv
- with python 2.7
git clone https://github.com/akshayKMR/hogwatch.git
- optional: for only server mode. remove pywebview from requirements.txt and comment it from setup.py
pip install -r requirements.txt --upgrade
python setup.py develop
- run with
sudo ./bin/hogwatch serverfor only server accessible at localhost:6432
All are welcome to fork and contribute.
Copyright Akshay Kumar firstname.lastname@example.org