Skip to content

DOCSIS cable modem monitoring dashboard with health assessment, trend charts, and Home Assistant integration via MQTT

License

Notifications You must be signed in to change notification settings

itsDNNS/docsight

Repository files navigation

DOCSight

DOCSight

License Version Ko-fi Stars

Your cable internet is slow and your provider says everything is fine?
DOCSight proves them wrong.

DOCSight monitors your cable internet connection 24/7 and collects the hard evidence you need to hold your ISP accountable. One click generates a complaint letter with real data your provider can't ignore.

For cable internet (DOCSIS/coax) only — Vodafone Kabel, Pyur, Tele Columbus, Virgin Media, Comcast, Spectrum, and others.

Dashboard Dark Mode


Quick Start

docker run -d --name docsight -p 8765:8765 -v docsight_data:/data ghcr.io/itsdnns/docsight:latest

Open http://localhost:8765, enter your router login, done. Full installation guide →


Is This For Me?

✅ You have cable internet (coax/DOCSIS) DOCSight is built for this
✅ Your internet drops out or is slower than what you're paying for DOCSight documents it
✅ Your ISP says "everything is fine on our end" DOCSight gives you proof
❌ You have DSL or fiber This tool won't work for you

Your Data Stays With You

🏠 Runs 100% locally No cloud, no external servers
🔒 Nothing leaves your network Your data is never uploaded anywhere
📖 Open source All code is public and verifiable
🔐 Credentials encrypted Router login encrypted at rest (AES-128)

Features

Feature Description
Live Dashboard Real-time channel data with health assessment and metric cards
Signal Trends Interactive charts with DOCSIS reference zones (day/week/month)
Event Log Automatic anomaly detection with modulation watchdog
Speedtest Integration Speed test history from Speedtest Tracker
Incident Journal Document ISP issues with attachments
Complaint Generator Editable ISP letter + downloadable technical PDF
Home Assistant MQTT Auto-Discovery with per-channel sensors
BQM Integration ThinkBroadband broadband quality graphs
LLM Export Structured reports for AI analysis

4 languages (EN/DE/FR/ES) · Light/Dark mode · Setup wizard · Optional authentication


Screenshots

Click to expand
Dashboard (Dark) Dashboard (Light)
Dark Light
Signal Trends Health Assessment
Trends Health
Speedtest Tracker Incident Journal
Speedtest Journal

Requirements

  • Docker (or any OCI-compatible container runtime)
  • A DOCSIS cable modem or router with web interface (tested with AVM FRITZ!Box 6690 Cable)
  • MQTT broker (optional, for Home Assistant)

Documentation

📚 Wiki — Full documentation, guides, and DOCSIS glossary

Contributing

See CONTRIBUTING.md. Please open an issue before working on new features.

Roadmap

See the full roadmap in the wiki.

Changelog

See GitHub Releases.

Support

If DOCSight helps you, consider buying me a coffee

License

MIT

About

DOCSIS cable modem monitoring dashboard with health assessment, trend charts, and Home Assistant integration via MQTT

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors 3

  •  
  •  
  •  

Languages