A brief explanation
This script provides way to setup a monitoring service of specific MACs for a Hostapd Wifi Access Point.
It uses the hostapd-cli list_sta to list the connected devices to the AP.
Setup
-
Install python3
-
Install telegram-send for python3
-
Create your own telegram bot and configure telegram-send
⚠ Important, since the script runs as root, set the configuration of telegram-send as root:$ sudo telegram-send --configure -
Setup hostapd and enable hostapd_cli by adding to the config
ctrl_interface=/var/run/hostapd ctrl_interface_group=0 -
Place the mac-monitoring.py, mac-monitoring.json in /etc/hostapd/
-
Place the daemon file mac-monitoring.service at /etc/systemd/system/ and start the daemon
$ sudo systemctl daemon-reload $ sudo systemctl enable --now mac-monitoring $ sudo systemctl restart mac-monitoring -
Configure the MACs you want to monitor
Configure the MACs to monitor
- Set your MAC monitoring filter with the file ac-monitoring.json. The format is:
["mac0", …, "macN"]
- Restart the daemon
$ sudo systemctl restart mac-monitoring
mac-monitoring.json
format
["mac0", …, "macN"]
example
["48:01:C5:76:14:53", "87:0F:32:45:01:64"]
1 Dec 26, 2021
3 Dec 27, 2021
1 Jan 5, 2022
7 Jan 31, 2022
66 Nov 18, 2022
3 Mar 24, 2022
12 Sep 12, 2022
1 Nov 30, 2021
3 Mar 23, 2022
9.3k Dec 31, 2022
5 Dec 13, 2022
3 Jan 09, 2022
1 Feb 18, 2022
2 Oct 27, 2021
1 Nov 16, 2021
89 Nov 23, 2022
9 Apr 10, 2022
6.8k Jan 04, 2023
3 Nov 03, 2022
0 Feb 12, 2022
237 Dec 29, 2022
2.5k Dec 15, 2022
3 Sep 18, 2022
15 Dec 27, 2022
449 Dec 27, 2022
3 Aug 23, 2022