vaginessa / netwatch-1

Netwatch is a tool to monitor the presence of the devices into a network.

Netwatch

Netwatch - a tool to monitor the presence of the devices into a network.

Here is a list of features Netwatch provides:

• Active/passive devices monitoring
• Timeline data visualization of a specific time frame
• Group the devices into people to get a per-person presence timeline
• Automatically determine device name from network traffic
• Manually assign a name to a device mac address

In order to do its job, Netwatch uses a combination of passive and active scanning techniques. Active scanning is only used as fallback method to verify a device presence when passive scanning fails. It is nevertheless possible to disable active scanning on a device basis or turn off periodic active scan to have a passive-only (stealth) solution.

Dependecies

In order to run Netwatch, you will need to satisfy the following dependencies:

• python2
• python2-webpy
• python2-pysqlite
• python2-prctl
• libdnet
• python2-dev (for C modules compilation)

Build

Netwatch is written in python but requires some C modules to implement the low level stuff. Before running Netwatch you will need to execute the following commands:

cd c_modules
make
cd ..

Run

After building the C modules, you can run netwatch with the following command:

sudo ./main.py

Note: you should add -u user option to drop the privileges to the specified user.

You can now visit the page http://127.0.0.1:8000/ from your browser to access the Netwatch gui.

System wide installation is not curretly supported. You can modify the sample service file packages/netwatch.service to run the program at startup.

Licence

Netwatch is under the GPL 3 license.

TODO 0.1

• Add no data view
• People timeline
• Handle login

TODO 0.2

• Unknown devices filter