Xfinity Status Monitor

A lightweight CLI tool that monitors Xfinity service status at a given address and alerts you to outages without manual checks. No API key required.

Requirements

• Python 3.10+
• Git Bash (Windows) or any bash-compatible shell (Mac/Linux)

Setup

The below instructions are for Windows users. Linux users would activate the venv in a slightly different way and may have different names for Python and Pip.

1. Clone the repo

git clone https://github.com/spiritualhost/xfinity-status
cd xfinity_status/

2. Run the setup script to create a virtual environment and install dependencies

./setup.sh

3. Activate the venv and run the script

source venv/Scripts/activate
python xfinity_status.py

On first run you will be prompted to enter your service address. This is validated against the Xfinity portal and saved to config.ini for future runs.

Usage

Run interactively:

python xfinity_status.py

Pipe output to a log file:

python xfinity_status.py > log.txt

Status is checked every 30 minutes by default. This can be changed by editing the sleep value in config.ini, which is measured in seconds.

Notes

• config.ini is generated on first run and stores your service address and poll interval
• The browser runs headlessly and defaults to chromium
• Press Ctrl+C to exit cleanly