DOCSIOS – iOS, iPadOS, macOS and watchOS Companion App (App Store & TestFlight)

[neofabrics]

DOCSIOS is an independent iOS, iPadOS, macOS and watchOS companion app for DOCSight.
It focuses on mobile usability and provides fast, structured access to DOCSIS connection metrics generated by DOCSight.
The interface is optimized for iPhone, iPad and Apple Watch form factors.
It does not replace the DOCSight web interface, but complements it with focused mobile diagnostics and analysis.

✨ Feature Set

DOCSIOS covers nearly all DOCSight API features, including dashboard, channel analysis, trends, speedtest, BQM, Smokeping, gaming score, events, and journal. Administrative endpoints are out of scope.
The app ships with native iOS home screen widgets, English and German localization, and optimized layouts for both iPhone and iPad.

📸 Screenshots

🔒 Privacy & Telemetry

Important

All diagnostic data remains on the device.

DOCSIOS uses Apple's MetricKit to monitor app performance and stability.

• No analytics or usage tracking is sent to external services.
• Diagnostic data is only shared if explicitly exported or reported by the user.
• The app does not collect or transmit modem data outside of your configured backend.

🧪 TestFlight Beta Access

👉 TestFlight Link:
https://testflight.apple.com/join/5FXpNb6X

If the tester limit is reached, please leave a comment and additional slots may be opened.

🐞 Reporting Issues

All DOCSIOS-related bugs and feature requests are handled in the DOCSIOS repository:
👉 https://github.com/neofabrics/DOCSIOS

Please do not open DOCSight issues for DOCSIOS-related topics.
When reporting a bug, include device model, OS version, DOCSIOS version/build, DOCSight version, and screenshots if applicable.

🔎 Scope Clarification

DOCSIOS visualizes metrics produced by DOCSight. It does not collect modem data directly and does not modify DOCSight.
Issues related to metric generation or DOCSight backend logic should be reported in the official DOCSight repository.

[neofabrics]

Hi all, quick update from the iOS side 👋

A new TestFlight build is now available: Build 14.

This build now targets the latest DOCSight API changes and expects backend compatibility from v2026-02-27.1 onward.

Changelog highlights (Build 14):

• Adopted new summary fields from GET /api/channels (overall health and aggregate signal metrics)
• Added backend version awareness via GET /health
• Added compatibility messaging in Dashboard (shows current vs required backend version)
• Integrated GET /api/device and added expandable modem details in the Connection card
• Updated signal issue mapping to new backend issue keys
• Improved dashboard card appearance/loading transitions (smooth fade/slide in)

Full changelog here:
https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-14---2026-02-27

Thanks for the fast backend updates @itsDNNS — this made it much easier to remove client-side derivations and align app behavior with DOCSight as source of truth 🙏

[itsDNNS]

I finally found the time to check out the app on my iPad, and I am really impressed. The smooth integration with the new backend updates looks excellent.

Would you perhaps be interested in building something for Tribu as well? https://github.com/itsDNNS/tribu
If so, and if possible, it would be great if you could adopt the design of the current Tribu UI.

[neofabrics]

Hi @itsDNNS, really glad you like it! 😊

I'll definitely take a look at Tribu in the next few days – once DOCSIOS is in a more stable state I'd love to explore it!

[neofabrics]

Hello 👋

Build 16 is now available on TestFlight. Here's what's new:

• A new Complaint Workflow lets you generate ready-to-send ISP complaint letters directly in the app via the DOCSight API — choose your time period, language, and customer details, then export as PDF or share.
• Speedtest results now include color-coded quality indicators based on your booked bandwidth, visible in the list, dashboard, and detail view. The detail view also shows an overall Speed Health rating (Good / Warning / Poor). Thanks again @itsDNNS for the quick implementation of the Speedtest classification in the API 🙂
• Temperature data can now be overlaid as a dashed line in Trends and Timeline charts, normalized to each chart's scale. Requires weather integration to be enabled in DOCSight (minimum version v2026-02-27.3).
• The iPad Channels View has been refactored to a NavigationSplitView for a native sidebar experience, with a new DS/US segmented picker for easier navigation.

Further improvements include local home screen badge counts for unacknowledged events (updated on app launch, not via push notifications), active filter indicators on toolbar icons, unified filter interactions across Events and Timeline, and standardized Mark All Read behavior.

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-16---2026-02-27

[neofabrics]

Hi everyone,

Build 17 of DOCSIOS is now available for testing. This update focuses on a unified charting system and improved stability during orientation changes.

What's new in this build:

• Unified all app charts (Speedtest, Broadband, Correlation, Trends) using a new global system for a consistent experience.
• Added interactive chart legends that allow toggling the visibility of individual metrics.
• Introduced a full-screen landscape mode for all charts to allow for detailed inspection.
• Implemented smart scaling for metrics with different magnitudes (SNR, Power, Errors) to match the web dashboard.
• Expanded the Correlation timeline to include Upstream Power, Correctable Errors, and Uncorrectable Errors.
• Aligned the visual design of Timeline and Event rows for a more cohesive look and feel across the app.
• Resolved navigation resets and tab jumping during orientation changes, specifically on iPhone Pro Max models.

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-17---2026-03-01

[neofabrics]

Hello 👋

Just a quick update, Build 18 is now available on TestFlight.

Highlights in this build:

• Optimized Correlation chart: event markers from the timeline now appear directly in the chart; scrubbing shows event details in the tooltip
• Charts in trends and channel details: Now containing optional thresholds, can be enabled and disabled by the user per chart including optional zoom to fit
• Fullscreen charts (Correlation & Trends) now include a time range picker
• Channel Detail: added 3-day time range option
• Settings: new "Chart Defaults" section to configure threshold lines, labels, and fit behaviour
• Dashboard – Signal Summary: power and SNR values are now color-coded by health status, with measured min–max range shown
• Dashboard – Channels card: shows percentage of healthy DS/US channels in the header; renamed from "Affected Channels"
• Weather overlay repositioned with padding to avoid touching chart edges

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-18---2026-03-01

[neofabrics]

Hi everyone! 👋

Build 19 is live on TestFlight!

• Added a modulation history chart in Channel Detail showing QAM changes over time (with fullscreen support)
• The Signal Summary now shows uncorrectable errors as a percentage; one-time error spikes flagged separately
• Fixed a rotation loop bug in fullscreen charts after rotating the device

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-19---2026-03-01

[itsDNNS]

I just wanted to leave some feedback here again. I really like the app and hope that other users will get a lot of use out of it. :)

[neofabrics]

Hello! 👋

Just a quick update, build 20 is now available on TestFlight.

Highlights:

• Introduces Channel Compare: compare up to 6 channels simultaneously from the channel detail view
• Dashboard visual hierarchy cleanup
• Event details are now fully localized and human-readable

With Channel Compare now complete, the app has reached a point where it covers most of the DOCSight API, aside from administrative settings. Feedback is highly appreciated as the experience continues to be refined, and there will still be a few smaller design adjustments along the way. The official App Store launch is getting closer.

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-20---2026-03-03

[neofabrics]

Hi everyone!

Build 20.0.1 is now live on TestFlight and contains 3 bug fixes:

• Fixed a stale app icon badge incorrectly showing unread events
• Fixed channel comparison not working when opened from the Dashboard
• Complaint View now correctly auto-detects all 4 supported languages based on device language settings

[neofabrics]

Hello! 👋

Build 21 is now available on TestFlight:

• Tolerated health status — new intermediate signal state between Good and Marginal, shown consistently across all views
• Correlation chart: health bands now have a saturated color strip along the top edge for clearer boundaries

[itsDNNS]

Added DOCSIOS to the wiki under Community Apps. It's linked from the home page and sidebar so users can find it when browsing the docs.

[neofabrics]

That’s awesome, thank you! 🙏

[neofabrics]

Hi everyone!

Build 22.0.2 is now live on TestFlight and adds support for DOCSight's new Modulation Feature.

• Support for DOCSight's new Modulation feature — distribution overview and intraday detail sheet (requires at least DOCSight v2026-03-06.3)
• Smoother reload experience — views now animate and scroll back to top when switching filters
• Fullscreen image viewer — black screen on open prevented

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-2202---2026-03-07

[neofabrics]

Hello everyone 👋

Build 23 is now live on TestFlight. Some of the new features I would explicitly announce as experimental or very early beta as I'm able to test just certain scenarios with my DOCSight instance (besides mocking some scenarios in the app directly) 🙂

Insights Tab

The new Insights tab runs four statistical analyses against your local history:

• Prime-Time Degradation — flags consistent evening SNR drops (e.g. "SNR drops 3.1 dB between 20:00–22:00")
• Temperature Correlation — cross-references SNR history with collected weather data; flags if hot days reliably hurt your signal
• Error Trend — flags if uncorrectable errors have tripled compared to last week
• Channel Instability — counts modulation changes per DS channel in the last 24h; flags anything beyond two changes

Everything runs on-device — no extra API calls, no backend changes needed.

Background Notifications

Uses iOS BGAppRefreshTask to periodically check events, health, and speedtest results in the background. Three notification types, independently toggleable. Single-event notifications show the actual event message. All processing happens entirely on-device — no third-party push service involved, so alerts work even when your internet connection is down.

Live Activity / Dynamic Island

Full Dynamic Island support — compact (dot + SNR), expanded (health + SNR Avg + degraded + uncorr. errors), and a Lock Screen banner with a 2×2 metric grid. Starts automatically on degradation detected via background task, stops automatically on recovery. When the backend suppresses a known error spike, a shield badge makes that visible so elevated error counts don't cause unnecessary alarm. The Live Activity and Dynamic Island behaviour can also be triggered manually in the Dashboard.

Fun fact: Dynamic Island brings some sort of Apple Watch support (but more to come 😉)

Due to how iOS interacts with Apple Watch, the Dynamic Island is without real Apple Watch support in DOCSIOS already mirrored to the smart stack on your Apple Watch. Means: If you're using an Apple Watch together with your iPhone and have either auto show of smart stack enabled or swipe down on the watch face you already may see on your wrist if DOCSight identified issues on your DOCSIS health.

Temperature overlay in Channel Detail

Per-channel Power and SNR charts now include the temperature overlay that was previously only available in the Trends and Correlation views.

Note

Background Notifications and Live Activity require the app to reach your DOCSight instance. Since DOCSight typically runs on your local network, these features will only work reliably when your iPhone/iPad is on the same Wi-Fi — or if you've made DOCSight accessible remotely (e.g. via VPN or reverse proxy).

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-23---2026-03-08

[neofabrics]

Hello everyone 👋

Build 24 is now live on TestFlight — and it's a big one. DOCSIOS now runs on nearly all Apple platforms: iOS, iPadOS, macOS, and as of today, watchOS.

⌚ Apple Watch
A native watchOS companion app with Signal, Gamingscore, Speedtest, and Events pages. Data is fetched directly from DOCSight using credentials synced from the iPhone app during setup — after that, the Watch app operates independently without requiring the iPhone nearby.

📡 Connection Monitor
A new tab featuring a multi-target latency chart with P95/avg/min/max stats, packet loss, per-target detail rows, and a dashboard summary card fetched directly from DOCSight (requires DOCSight v2026-03-11.1).

🔔 Notifications
Background event notifications are now fully localized (EN/DE), include a "Mark as Read" action, and can be filtered by severity level (critical, warning, info) — applying to both banners and the badge count.

🔧 Fixes & Improvements
Smokeping and BQM image viewer gets a redesigned close button and swipe-to-dismiss. Several smaller fixes around the Modulation Detail Sheet, Live Activity, pull-to-refresh, and notification fallback behavior.

Some watchOS screenshots (also supports english 😉):

Smart stack:

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-24---2026-03-12

[neofabrics]

Hi everyone 👋

Build 25 is now available on TestFlight. Highlights in this build:

• Watch Dashboard — a proper glance-view with channel health, error rate, BNetz, Connection Monitor, and collector status all in one place
• Two new Watch complications — a health state gauge and an SNR gauge ring
• Configurable Watch page order — reorder pages from iOS Settings, synced to the Watch
• Comparison Tab — pick two custom time periods and compare signal quality side by side with threshold overlays
• Signal Insights moved into the Health card as a sheet, now backed by the backend's health issue diagnostics
• Individual push notifications per event with timestamps

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-25---2026-03-16

[neofabrics]

Hello 👋

Build 26.0.10 is now live on TestFlight. This release brings three major additions:

watchOS gets a complete overhaul. The companion app has been rebuilt from the ground up with a consistent card-based design across all views. Dashboard, Monitor, and Trends are new, and the dashboard card order is now configurable from iOS Settings.

Traceroute is now part of Connection Monitor including hop-by-hop path visualization gathered from DOCSight.

App Intents — Early Beta. First steps towards system integration (Shortcuts, Siri). Rough around the edges, but functional.

On the smaller side: you can now trigger a speedtest directly from the Speedtest tab, notifications are automatically cleared when acknowledged, and the app icon badge is properly cleared on event acknowledgement.

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-26010---2026-03-22

Some screenshots of the new watchOS design:

[neofabrics]

Hey everyone 👋

Build 27 is now available on TestFlight. DOCSight's segment utilization data is now surfaced in DOCSIOS, showing downstream and upstream utilization over time with min/avg/max stats.

[neofabrics]

Hello 👋

Build 79 is now available on TestFlight. This release brings a handful of new views, Watch improvements, and a round of performance and security work under the hood:

• The biggest addition is the Snapshots tab, which lets you browse and compare historical modem snapshots. Each day shows a 24-hour heatmap so you can quickly spot when signal health changed.
• The Monitor View now includes an outage timeline, and Trends, Speedtest, Broadband, and Modulation views now cache their last data load so they stay usable when the backend is temporarily unreachable.
• The BQM view gets an interactive latency chart with lost polls visualization, matching the web UI.
• On Apple Watch, this release adds Segment Utilization, a Channel Detail view for flagged channels, a Speedtest trigger with live status feedback, and latency/packet loss charts on the Monitor page.
• On the performance side, API requests across the app and Watch now load in parallel, chart scrubbing is smoother, and Watch skips unnecessary refreshes on wrist-raise when data is still fresh.

A number of smaller fixes and security improvements are included as well.

Full Changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#01-build-79---2026-04-04

[neofabrics]

Quick update, I've just released build 80 on TestFlight: Snapshot heatmap health requests are now serialised and debounced — previously multiple visible days would load in parallel causing request bursts; fixes CrowdSec bans when accessing remotely e.g. via Pangolin/Traefik.

[neofabrics]

🎉 DOCSIOS is now available on the App Store!

👉 https://apps.apple.com/us/app/docsios/id6759523137

The TestFlight link will remain active for future beta builds.

@itsDNNS Would you mind updating the wiki

[itsDNNS]

Congrats on the App Store launch! Wiki updated.

[neofabrics]

Thank you 🙂

[neofabrics]

Hello everyone, small DOCSIOS update. I realized I had not posted here since April 😅

DOCSIOS 1.4 is now available on the App Store.

This update aligns the app with the newer DOCSight signal-family metrics and brings an updated Dashboard, clearer signal KPI cards, refreshed widgets, an improved Apple Watch Dashboard, and simplified navigation.

Full functionality requires DOCSight backend v2026-05-27.1 or newer, because older backend versions do not provide all signal-family metrics used by the new Dashboard and family-based trend views.

Full changelog: https://github.com/neofabrics/DOCSIOS/blob/main/CHANGELOG.md#14-build-196---2026-06-01

[neofabrics]

I wanted to give a quick update on DOCSIOS: I recently moved to a fiber connection and no longer use a DOCSIS setup in daily operation. Because of that, DOCSIOS is now effectively in maintenance mode. I don’t plan to add new features going forward, but I’ll keep it compatible with DOCSight and will address issues or breaking changes if needed.

I may also consider making the project fully open source at some point and potentially open it up for community maintenance if there is interest.