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
13 Oct 09, 2022
3 Jan 29, 2022
69 Jan 01, 2023
9 Apr 10, 2022
56 Dec 29, 2022
57 Dec 12, 2022
7.8k Jan 08, 2023
2 Oct 27, 2021
32 Dec 30, 2022
738 Jan 04, 2023
329 Dec 16, 2022
7.2k Jan 07, 2023
1 Nov 13, 2021
13 Sep 29, 2022
26 Nov 07, 2022
31 Jul 30, 2021
47 Dec 29, 2022
13 Nov 17, 2022
37 Dec 21, 2022
17 Nov 09, 2022