From 2678ab539667b73939fd387b3a6ead63466a0443 Mon Sep 17 00:00:00 2001
From: juyoung <git@juyoun.gg>
Date: Sun, 17 Nov 2024 14:33:33 -0800
Subject: [PATCH] Initial release

---
 .gitignore                  |   1 +
 README.md                   | 113 ++++++++++++++++++++
 conf.yml                    |   3 +
 device_data.log             |   0
 device_list.log             |   0
 docs/assets/img/math.png    | Bin 0 -> 2022 bytes
 docs/assets/img/preview.png | Bin 0 -> 21605 bytes
 requirements.txt            |  23 +++++
 wifeye.py                   | 200 ++++++++++++++++++++++++++++++++++++
 9 files changed, 340 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md
 create mode 100644 conf.yml
 create mode 100644 device_data.log
 create mode 100644 device_list.log
 create mode 100644 docs/assets/img/math.png
 create mode 100644 docs/assets/img/preview.png
 create mode 100644 requirements.txt
 create mode 100644 wifeye.py

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..1d17dae
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.venv
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b84b70d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,113 @@
+# Wifeye
+
+Track all Wi-Fi connected devices for real-time updates and better network security. This program works with routers that use 10.0.0.1 as the admin panel, like Xfinity routers.
+
+<p align="center"><img src="docs/assets/img/preview.png" width=80% alt=""></p>
+
+## Installation
+
+```
+virtualenv -p python .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+## Usage
+
+```
+python wifeye.py
+```
+
+### Configuration
+
+Edit `conf.yml`:
+
+```yaml
+ADMIN_USERNAME: admin
+ADMIN_PASSWORD: Password
+REFRESH_TIME: 10
+```
+
+- ADMIN_USERNAME: Username for the router's admin panel
+- ADMIN_PASSWORD: Password for the router's admin panel
+- REFRESH_TIME: How often the data refreshes (in seconds)
+
+### Log Files
+
+1. `device_data.log` saves the status of all devices every time it refreshes. Each record has the time and details about each device.
+
+**Example**:
+
+```json
+{
+  "timestamp": "2024-01-01 00:00:00",
+  "data": [
+    {
+      "name": "phone",
+      "online": true,
+      "ip_type": "DHCP",
+      "rssi": -40,
+      "network": "Wi-Fi 5G",
+      "frequency": 5000,
+      "distance": 0.02,
+      "device_info": {
+        "ipv4_address": "10.0.0.2",
+        "ipv6_address": "1111:000:ffff:0000:0000:000:0000:1111",
+        "local_link_ipv6_address": "fe80::1111:0000:ffff:1111",
+        "mac_address": "01:00:01:00:00:01"
+      }
+    },
+    {
+      "name": "laptop",
+      "online": false,
+      "ip_type": null,
+      "rssi": null,
+      "network": null,
+      "frequency": null,
+      "distance": null,
+      "device_info": {
+        ...
+      }
+    }
+  ]
+}
+{
+  "timestamp": "2024-01-01 00:01:00",
+  "data": [
+    {
+      ...
+```
+
+| Key                     | Description                                                                                                                                                                                                                                                                                                                                     |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| timestamp               | Date and time of the log (YYYY-MM-DD HH:mm:ss)                                                                                                                                                                                                                                                                                                  |
+| data                    | Array of device objects                                                                                                                                                                                                                                                                                                                         |
+| name                    | Device name (e.g., "Phone")                                                                                                                                                                                                                                                                                                                     |
+| online                  | Connection status (true for online, false for offline)                                                                                                                                                                                                                                                                                          |
+| ip_type                 | Type of IP allocation (e.g., "DHCP" or "Reserved")                                                                                                                                                                                                                                                                                              |
+| rssi                    | Signal strength (dBm)                                                                                                                                                                                                                                                                                                                           |
+| network                 | Wi-Fi network name (e.g., "Wi-Fi 5G" or "Wi-Fi 2.4G")                                                                                                                                                                                                                                                                                           |
+| frequency               | Wi-Fi frequency in MHz                                                                                                                                                                                                                                                                                                                          |
+| distance                | Distance to the router in meters.<br><img src="./docs/assets/img/math.png" width=300px alt="The distance is equal to ten raised to the power of the fraction where the numerator is 30 minus the received signal strength indicator (RSSI) minus twenty times the base ten logarithm of the frequency minus 32.44, and the denominator is 20."> |
+| device_info             | Detailed device information, including:                                                                                                                                                                                                                                                                                                         |
+| ipv4_address            | Assigned IPv4 address                                                                                                                                                                                                                                                                                                                           |
+| ipv6_address            | Assigned IPv6 address                                                                                                                                                                                                                                                                                                                           |
+| local_link_ipv6_address | Local link IPv6 address                                                                                                                                                                                                                                                                                                                         |
+| mac_address             | Device MAC address                                                                                                                                                                                                                                                                                                                              |
+
+2. `device_list.log` keeps a list of all unique devices and tracks when they go online or offline, including the time of each change.
+
+**Example**:
+
+```json
+{
+  "timestamp": "2024-01-01 00:00:00",
+  "name": "phone",
+  "online": true
+}
+{
+  "timestamp": "2024-01-01 00:01:00",
+  "name": "phone",
+  "online": false
+}
+```
diff --git a/conf.yml b/conf.yml
new file mode 100644
index 0000000..c743309
--- /dev/null
+++ b/conf.yml
@@ -0,0 +1,3 @@
+ADMIN_USERNAME: admin
+ADMIN_PASSWORD: Password
+REFRESH_TIME: 10
diff --git a/device_data.log b/device_data.log
new file mode 100644
index 0000000..e69de29
diff --git a/device_list.log b/device_list.log
new file mode 100644
index 0000000..e69de29
diff --git a/docs/assets/img/math.png b/docs/assets/img/math.png
new file mode 100644
index 0000000000000000000000000000000000000000..0f83cc1d04b2ee19f6b0c9c7d4c7033203bd1193
GIT binary patch
literal 2022
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
Ef{G5V#Q*>R

literal 0
HcmV?d00001

diff --git a/docs/assets/img/preview.png b/docs/assets/img/preview.png
new file mode 100644
index 0000000000000000000000000000000000000000..1b3232d2d0acaa0019faa82029e08963d1595058
GIT binary patch
literal 21605
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
Ui{7w>>B39D+B({lT6>-SFPb;*ga7~l

literal 0
HcmV?d00001

diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..e9a8368
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,23 @@
+blinker==1.8.2
+certifi==2024.8.30
+charset-normalizer==3.4.0
+click==8.1.7
+idna==3.10
+importlib_metadata==8.5.0
+itsdangerous==2.2.0
+Jinja2==3.1.4
+lxml==5.3.0
+markdown-it-py==3.0.0
+MarkupSafe==3.0.2
+mdurl==0.1.2
+Pygments==2.18.0
+PyYAML==6.0.2
+requests==2.32.3
+rich==13.9.2
+soupsieve==2.6
+typing_extensions==4.12.2
+urllib3==2.2.3
+wcwidth==0.2.13
+Werkzeug==3.0.4
+zipp==3.20.2
+
diff --git a/wifeye.py b/wifeye.py
new file mode 100644
index 0000000..ec42af5
--- /dev/null
+++ b/wifeye.py
@@ -0,0 +1,200 @@
+import re
+import requests
+import math
+import json
+import time
+import os
+import yaml
+from lxml import html
+from datetime import datetime
+from rich.console import Console
+from rich.table import Table
+
+with open('conf.yml', 'r') as file:
+  config = yaml.safe_load(file)
+
+ADMIN_USERNAME = config['ADMIN_USERNAME']
+ADMIN_PASSWORD = config['ADMIN_PASSWORD']
+REFRESH_TIME = config['REFRESH_TIME']
+
+session = requests.Session()
+console = Console()
+
+base_url = 'http://10.0.0.1'
+login_page_scope = '/check.php'
+devices_page_scope = '/connected_devices_computers.php'
+
+payload = {
+  'username': ADMIN_USERNAME,
+  'password': ADMIN_PASSWORD
+}
+
+# log in
+def login():
+  response = session.post(base_url + login_page_scope, data=payload)
+
+  if response.ok:
+    print("Login successful")
+  else:
+    print("Login failed")
+    return False
+  return True
+
+# fetch devices information
+def fetch_devices_data():
+  devices_url = base_url + devices_page_scope
+  devices_response = session.get(devices_url)
+  tree = html.fromstring(devices_response.content)
+
+  def device_info(device_info):
+    info_dict = {}
+    for info in device_info:
+      k = info.xpath('./b//text()')[0].strip() if info.xpath('./b//text()') else None
+      v = info.xpath('.//text()')[1].strip() if len(info.xpath('.//text()')) > 1 else None
+      if k and v:
+        info_dict[k.lower().replace(" ", "_")] = v.strip()
+    return info_dict
+
+  devices_data = {
+    "online_devices": [],
+    "offline_devices": []
+  }
+
+  # process online devices
+  online_devices = tree.xpath('//div[@id="online-private"]/table//tr')[1:-1]
+  for row in online_devices:
+    host_name = row.xpath('.//td[@headers="host-name"]/a//text()')[0].strip()
+    dhcp_or_reserved = row.xpath('.//td[@headers="dhcp-or-reserved"]//text()')[0].strip()
+    rssi_text = row.xpath('.//td[@headers="rssi-level"]//text()')[0].strip()
+
+    try:
+      rssi = int(float(rssi_text.replace(" dBm", "")))
+    except ValueError:
+      print(f"Invalid RSSI value for {host_name}: {rssi_text}")
+      rssi = None
+
+    connection_type = row.xpath('.//td[@headers="connection-type"]//text()')[0].strip()
+    frequency = int(float(re.findall(r'\d+\.?\d*', connection_type)[0]) * 1000) if connection_type else None
+    distance = round(10 ** ((30 - rssi - (20 * math.log10(frequency)) - 32.44) / 20), 2) if rssi is not None and frequency is not None else None
+
+    device_entry = {
+      "name": host_name,
+      "online": True,
+      "ip_type": dhcp_or_reserved,
+      "rssi": rssi,
+      "network": connection_type,
+      "frequency": frequency,
+      "distance": distance,
+      "device_info": device_info(row.xpath('.//td[@headers="host-name"]//div[@class="device-info"]/dl/dd'))
+    }
+
+    devices_data["online_devices"].append(device_entry)
+
+  # process offline devices
+  offline_devices = tree.xpath('//div[@id="offline-private"]/table//tr')[1:-1]
+  for row in offline_devices:
+    host_name = row.xpath('.//td[@headers="offline-device-host-name"]/a//text()')[0].strip()
+
+    device_entry = {
+      "name": host_name,
+      "online": False,
+      "ip_type": None,
+      "rssi": None,
+      "network": None,
+      "frequency": None,
+      "distance": None,
+      "device_info": device_info(row.xpath('.//td[@headers="offline-device-host-name"]//div[@class="device-info"]/dl/dd'))
+    }
+
+    devices_data["offline_devices"].append(device_entry)
+
+  # sort online devices by distance
+  known_distances = [device for device in devices_data["online_devices"] if device["distance"] is not None]
+  unknown_distances = [device for device in devices_data["online_devices"] if device["distance"] is None]
+
+  sorted_known_distances = sorted(known_distances, key=lambda x: x["distance"])
+  devices_data["online_devices"] = sorted_known_distances + unknown_distances
+
+  return devices_data
+
+# format keys
+def format_keys(data):
+  return {k.lower().replace(" ", "_"): v for k, v in data.items()}
+
+# log data
+def log_devices_data(devices_data):
+  timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+  combined_devices = devices_data["online_devices"] + devices_data["offline_devices"]
+
+  # format keys for each device entry
+  formatted_devices = [format_keys(device) for device in combined_devices]
+  log_entry = {"timestamp": timestamp, "data": formatted_devices}
+
+  with open("device_data.log", "a") as log_file:
+    log_file.write(json.dumps(log_entry) + "\n")
+
+# log status changes
+def log_device_status_change(device_name, online):
+  timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+  log_entry = {"timestamp": timestamp, "name": device_name, "online": online}
+
+  with open("device_list.log", "a") as log_file:
+    log_file.write(json.dumps(format_keys(log_entry)) + "\n")
+
+# display devices
+def display_devices(devices_data, current_device_status):
+  os.system('cls' if os.name == 'nt' else 'clear')
+
+  header = f"{'Name':<20}{'Online':<10}{'IP Type':<15}{'RSSI':<10}{'Network':<20}{'Frequency (MHz)':<20}{'Distance (m)':<15}{'Last Activity':<20}"
+  print(header)
+
+  def format_device_row(device, last_activity):
+    return f"{device['name']:<20}{str(device['online']):<10}{(device['ip_type'] if device['ip_type'] is not None else 'null'):<15}{(str(device['rssi']) if device['rssi'] is not None else 'null'):<10}{(device['network'] if device['network'] is not None else 'null'):<20}{(str(device['frequency']) if device['frequency'] is not None else 'null'):<20}{(str(device['distance']) if device['distance'] is not None else 'null'):<15}{(last_activity if last_activity is not None else 'null'):<20}"
+
+  # add online devices
+  for device in devices_data["online_devices"]:
+    last_activity = current_device_status.get(device["name"], {}).get("last_activity", None)
+    print(format_device_row(device, last_activity))
+
+  # add offline devices
+  for device in devices_data["offline_devices"]:
+    last_activity = current_device_status.get(device["name"], {}).get("last_activity", None)
+    print(format_device_row(device, last_activity))
+
+# main
+if login():
+  current_device_status = {}
+
+  try:
+    while True:
+      devices_data = fetch_devices_data()
+      if devices_data:
+        log_devices_data(devices_data)
+
+        new_device_status = {}
+        for d in devices_data["online_devices"] + devices_data["offline_devices"]:
+          device_name = d["name"]
+          online = d["online"]
+          if device_name in current_device_status:
+            new_device_status[device_name] = current_device_status[device_name]
+            if current_device_status[device_name]["online"] != online:
+              new_device_status[device_name]["last_activity"] = datetime.now().strftime("%y-%m-%d %H:%M:%S")
+              # log only on status change
+              if online != current_device_status[device_name]["online"]:
+                log_device_status_change(device_name, online)
+                new_device_status[device_name]["online"] = online
+          else:
+            new_device_status[device_name] = {
+              "online": online,
+              "last_activity": datetime.now().strftime("%y-%m-%d %H:%M:%S")
+            }
+            log_device_status_change(device_name, online)
+
+        current_device_status = new_device_status
+        display_devices(devices_data, current_device_status)
+      # refesh
+      time.sleep(REFRESH_TIME)
+  except KeyboardInterrupt:
+    print("Stopped by user.")
+  finally:
+    session.close()