github.com/erunks/internet-status-reporter ↗
Screw you, unreliable ISPs
Open this visualization on its own page →
Contributors
2
Lines of Code
145
From
2020-04-08
To
2020-10-13
About erunks/internet-status-reporter
Internet Status Reporter is a Python application designed to monitor and log internet connectivity issues, allowing users to track outages from their Internet Service Provider. The project documents connection failures by periodically checking internet status and recording events to a database, creating a historical record that can be used to demonstrate service reliability problems to ISPs.
The application is built to run continuously on always-on hardware like a Raspberry Pi, using a cronjob scheduler to execute status checks at regular intervals. It stores results in a MySQL database with tables for modem events and outages, enabling users to generate statistics and reports about their internet downtime. The setup process involves configuring Python 3.6 or higher, installing dependencies through Poetry, creating the necessary database tables, and setting environment credentials.
The project targets frustrated users with unreliable internet connections who want concrete data about their service problems. It's particularly well-suited for single-board computers like Raspberry Pi, where it can run passively in the background without requiring significant computational resources.