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 →


🧪 Beta Testing (v2.0)

DOCSight v2.0 is currently in beta testing! We're looking for community feedback.

Try it: docker run -d -p 8766:8765 -v docsight_v2_data:/data ghcr.io/itsdnns/docsight:v2-dev

What's new: Complete UI redesign, modular architecture, cross-source correlation

Migration safe: Your v1 data is automatically migrated. No data loss!

Report issues: GitHub Issues with tag v2-preview


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
Channel Timeline Per-channel power, SNR, error, and modulation history over time
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
Channel Timeline Event Log
Channel Timeline Events

Supported Hardware

Status
AVM Fritz!Box Cable (6590, 6660, 6690) ✅ Fully supported
Vodafone Station (Arris TG3442DE) 🔜 Planned (roadmap)
Technicolor / Sagemcom 🔜 Planned
Other DOCSIS modems Contributions welcome! See Adding Modem Support

Works with any DOCSIS cable provider: Vodafone, Pyur/Tele Columbus, eazy, Magenta (AT), UPC (CH), Virgin Media (UK), and others. Default signal thresholds are based on VFKD guidelines and can be customized in thresholds.json for your ISP.

Requirements

  • Docker (or any OCI-compatible container runtime)
  • A supported DOCSIS cable modem or router (see above)
  • 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

Next: v2.0 — Unified Collector Architecture

Feature Issue
Unified Collector Architecture #23
FritzBox Event Log Integration #17
OFDMA Channel Analysis #18
Notification System #19
Ping Monitor #20
Modulation Watchdog & Power Drift #21
Smokeping Integration #22
Vodafone Station Support #14
Technicolor TC4400 Support #24

See the full roadmap in the wiki for long-term goals and modem support plans.

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 5

Languages