# pucherot/pi.alert

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/pucherot-pi-alert).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

2,521 stars · 153 forks · JavaScript · GPL-3.0

## Links

- GitHub: https://github.com/pucherot/Pi.Alert
- awesome-repositories: https://awesome-repositories.com/repository/pucherot-pi-alert.md

## Topics

`adminlte` `arp-scan` `dnsmasq` `ids` `intrusion-detection` `lan` `mac-address` `network` `pi-hole` `scan` `security` `wifi`

## Description

Pi.Alert is a self-hosted local area network monitoring utility and scanner that catalogs connected hardware, tracks real-time online status, and alerts administrators to unauthorized devices. It combines multiple discovery methods including address resolution protocol requests, dynamic host configuration protocol lease parsing, and domain name system query logs to comprehensively locate and identify active equipment.

The application serves a centralized web-based management interface backed by a relational database inventory to store device metadata, user classifications, and historical activity records. Administrators can organize and customize hardware details such as friendly names, owners, categories, groups, comments, and vendor information while marking favorites. Stateful presence tracking records connection histories, session timestamps, and internet protocol address transitions to monitor the online and offline status of every tracked device over time.

A rule-based alert dispatcher evaluates network events against customized user thresholds and cooldown periods to send targeted notifications via email. This system triggers warnings when unknown devices join the network, internet protocol addresses change, or monitored equipment goes offline unexpectedly.

## Tags

### Security & Cryptography

- [Network Intruder Scanners](https://awesome-repositories.com/f/security-cryptography/security-and-access-control/network-intruder-scanners.md) — Acts as a self-hosted network monitoring utility that catalogs connected hardware and alerts administrators to unauthorized devices.

### Web Development

- [Web-Based Management Interfaces](https://awesome-repositories.com/f/web-development/web-based-management-interfaces.md) — Serves a centralized web-based management interface for organizing and monitoring connected network hardware.

### Data & Databases

- [Relational Inventory Schemas](https://awesome-repositories.com/f/data-databases/asset-inventory-management/relational-inventory-schemas.md) — Stores device metadata and historical activity records inside a structured relational database inventory.

### DevOps & Infrastructure

- [Network Device Dashboards](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-applications/network-device-managers/network-device-dashboards.md) — Provides a centralized web-based management interface for organizing hardware metadata, custom classifications, and connection histories.

### Hardware & IoT

- [Automatic Network Hardware Discovery](https://awesome-repositories.com/f/hardware-iot/automatic-network-hardware-discovery.md) — Searches local networks continuously using multiple discovery methods to catalog connected hardware and IP addresses. ([source](https://github.com/pucherot/Pi.Alert/blob/main/README.md))
- [Inventory Tracking](https://awesome-repositories.com/f/hardware-iot/device-connection-management/inventory-tracking.md) — Manages, classifies, and tracks characteristics, status, and history for all connected hardware. ([source](https://github.com/pucherot/pi.alert#readme))
- [Device Configuration and Diagnostics](https://awesome-repositories.com/f/hardware-iot/device-configuration-and-diagnostics.md) — Assigns friendly names, owners, categories, groups, comments, and vendor information to network hardware. ([source](https://github.com/pucherot/Pi.Alert/blob/main/docs/DEVICE_MANAGEMENT.md))

### Networking & Communication

- [Multi-Protocol Scanners](https://awesome-repositories.com/f/networking-communication/local-network-discovery/periodic-network-scanners/multi-protocol-scanners.md) — Combines ARP requests, DHCP lease parsing, and DNS query logs to discover active equipment and monitor online status.
- [Network Change Observers](https://awesome-repositories.com/f/networking-communication/network-change-observers.md) — Detects new devices, reconnections, disconnections, and IP address changes by continuously checking network activity. ([source](https://github.com/pucherot/Pi.Alert))
- [Network Device Discovery](https://awesome-repositories.com/f/networking-communication/network-device-discovery.md) — Scans local networks using multiple discovery methods to catalog connected hardware and active IP addresses.
- [Automated Report Notifications](https://awesome-repositories.com/f/networking-communication/email-notification-services/automated-report-notifications.md) — Sends automated email notifications whenever unrecognized devices appear or monitored equipment goes offline. ([source](https://github.com/pucherot/pi.alert#readme))
- [System Alert Dispatchers](https://awesome-repositories.com/f/networking-communication/system-alert-dispatchers.md) — Evaluates network events against customized user thresholds and cooldown periods to send targeted email alerts.

### System Administration & Monitoring

- [Equipment Health Monitors](https://awesome-repositories.com/f/system-administration-monitoring/health-monitoring/instance-health-monitors/equipment-health-monitors.md) — Tracks the real-time online status and historical presence of critical hardware to ensure equipment stays online.
- [Multi-Protocol Probing Engines](https://awesome-repositories.com/f/system-administration-monitoring/multi-protocol-probing-engines.md) — Continuously scans local networks using ARP, DHCP lease parsing, and DNS query logs to discover connected hardware.
- [Network Connectivity Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/network-connectivity-monitoring.md) — Scans the local area network continuously to detect newly connected devices and unexpected disconnections. ([source](https://github.com/pucherot/pi.alert#readme))
- [Network Device Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/network-device-monitoring.md) — Combines ARP scanning, DNS query logs, and DHCP lease data to locate and identify active network hardware. ([source](https://github.com/pucherot/Pi.Alert))
- [Unauthorized Device Detections](https://awesome-repositories.com/f/system-administration-monitoring/unauthorized-device-detections.md) — Automatically detects unknown devices joining the local area network and alerts administrators to potential intruders.
- [Address Transition Records](https://awesome-repositories.com/f/system-administration-monitoring/client-device-tracking/device-connectivity-tracking/address-transition-records.md) — Records connection histories, session timestamps, and IP address transitions to monitor device status over time.
- [Connection History Tracking](https://awesome-repositories.com/f/system-administration-monitoring/connection-history-tracking.md) — Tracks real-time online status, session timestamps, and historical IP addresses to maintain complete connection records. ([source](https://github.com/pucherot/Pi.Alert/blob/main/docs/DEVICE_MANAGEMENT.md))
- [Device Inventory Reports](https://awesome-repositories.com/f/system-administration-monitoring/device-inventory-reports.md) — Organizes device details, connection histories, and historical presence events through a dedicated interface. ([source](https://github.com/pucherot/Pi.Alert/blob/main/README.md))
- [Network Alerting Systems](https://awesome-repositories.com/f/system-administration-monitoring/network-alerting-systems.md) — Configures notification rules and dispatches email alerts whenever network changes or disconnections occur.
- [Email Alert Notifications](https://awesome-repositories.com/f/system-administration-monitoring/notification-channels/slack-notifications/email-alert-notifications.md) — Sends email notifications when unknown devices join the network or critical devices disconnect unexpectedly. ([source](https://github.com/pucherot/Pi.Alert/blob/main/README.md))

### User Interface & Experience

- [Device Alert Customization](https://awesome-repositories.com/f/user-interface-experience/custom-notification-sounds/device-alert-customization.md) — Manages alerting rules per hardware item by setting notification frequency and cooldown periods. ([source](https://github.com/pucherot/Pi.Alert/blob/main/docs/DEVICE_MANAGEMENT.md))
