Skip to content

Releases

luci-app-netstat v1.2.0-3

Choose a tag to compare

@github-actions github-actions released this 29 Oct 12:48

luci-app-netstat 1.2.0-3

A bug-fix release for the Network Usage chart, plus a rewritten README.

🐛 Fixes

  • Chart no longer overflows the page. The usage chart measured its width once, before the theme's sidebar appeared, and never resized, so its right side (the last axis value and the end of the bars) was cut off. It now resizes with its container and the window.
  • Chart labels follow dark mode. Switching the theme to dark left the axis labels and legend in the light-mode colour, because themes that fade colours were still mid-transition when the chart read them. The chart now re-checks once the transition settles.

📝 Documentation

  • New README. It covers features, installation and the vnStat 1.x → 2 upgrade, configuration options, how interface detection and vnStat tracking work, and troubleshooting. It also has new screenshots of the dashboard widget, the Usage tab in light and dark mode, and the Settings tab.

Tip

After upgrading, LuCI may keep serving the old dashboard script from your browser cache, because it only clears that cache when LuCI itself updates. If the dashboard still behaves like the previous version, clear the browser cache for the router or open it in a private window.

No other functional changes since 1.2.0-2. If you are upgrading from 1.1.x, follow the vnstat2 upgrade steps in the 1.2.0-1 notes.

📦 Packages

File For
luci-app-netstat-1.2.0-r3.apk OpenWrt 25.x (apk)
luci-app-netstat_1.2.0-r3_all.ipk OpenWrt 24.10 and older (opkg)

Both are architecture-independent (noarch / all).

Full changelog: v1.2.0-2...v1.2.0-3

luci-app-netstat v1.2.0-2

Choose a tag to compare

@github-actions github-actions released this 29 Oct 12:35

luci-app-netstat 1.2.0-2

A styling release: the Netstat pages now follow your LuCI theme, including dark mode.

🎨 Changes

  • Follows the theme switcher. The Network Usage, Settings and About tabs no longer draw their own white cards, tinted boxes or custom tab bar. They use LuCI's standard tabs and sit inside the theme's own sections, so any theme (Bootstrap, Material, Argon, NoobWRT, …) styles them like its other pages, in light or dark mode.
  • Dark mode works everywhere. Before, the pages only switched to dark colours if localStorage had luci-theme = dark. Themes that choose dark mode another way, such as NoobWRT's scheduled auto mode, were left with white panels. That check is gone; nothing depends on it now.
  • Readable chart title. The Usage chart title is no longer an h3, which some themes render as a full-width coloured bar that hid the text.
  • Chart follows the theme. Axis labels and legends use the theme's text colour and update straight away when you switch between light and dark, without a page reload.

No functional changes since 1.2.0-1. If you are upgrading from 1.1.x, follow the vnstat2 upgrade steps in the 1.2.0-1 notes.

📦 Packages

File For
luci-app-netstat-1.2.0-r2.apk OpenWrt 25.x (apk)
luci-app-netstat_1.2.0-r2_all.ipk OpenWrt 24.10 and older (opkg)

Both are architecture-independent (noarch / all).

Full changelog: v1.2.0-1...v1.2.0-2

luci-app-netstat v1.2.0-1

Choose a tag to compare

@github-actions github-actions released this 29 Oct 12:28
a2674fe

luci-app-netstat 1.2.0-1

This release makes the app work on any OpenWrt router. It now uses vnStat 2 for traffic history and finds your interfaces automatically. There are no more hard-coded interface names, device paths or board-specific settings.

⚠️ Breaking change: requires vnstat2

The package now depends on vnstat2 (vnStat 2.x) instead of the old vnstat 1.x package. The two cannot be installed together.

Upgrading from 1.1.x:

# OpenWrt 25.x (apk)
/etc/init.d/vnstat stop
apk del luci-app-netstat vnstat
apk add vnstat2
apk add --allow-untrusted luci-app-netstat-1.2.0-r1.apk

# OpenWrt 24.10 (opkg)
/etc/init.d/vnstat stop
opkg remove luci-app-netstat vnstat
opkg install vnstat2
opkg install luci-app-netstat_1.2.0-r1_all.ipk

Keeping your history: vnStat 2 imports old vnStat 1.x databases on first start, but only from its DatabaseDir. If your 1.x data is in /etc/vnstat, set DatabaseDir "/etc/vnstat" in /etc/vnstat.conf before starting vnStat 2. OpenWrt's default is /var/lib/vnstat, which is in RAM, so history there is lost on every reboot.

✨ What's new

  • Works on any router. The tracked interface is the one you pick in Settings or, on auto, whichever device holds the default route (read from /proc/net/route and /proc/net/ipv6_route). PPPoE, DHCP, LTE/5G modems, VPNs and DSA switches all work without configuration.
  • Logical interface names in Settings. You can pick wan, lan or a modem interface; it is resolved to its current device through netifd. The list shows your router's logical interfaces, network devices and anything vnStat already has history for.
  • vnStat tracks interfaces automatically. OpenWrt starts vnstatd with --noadd, so out of the box it tracks nothing. A hotplug hook now adds each interface's device to /etc/config/vnstat when it comes up, and the install does the same for interfaces that are already up. To turn this off, set option vnstat_autoadd '0' in /etc/config/netstats. You can also run /usr/libexec/netstat-vnstat-track by hand.
  • History from vnstat --json. The Network Usage tab reads vnStat 2's JSON output instead of parsing locale-dependent text, so daily and monthly charts are correct on every vnStat 2 version.
  • Clear first-run messages. While vnStat is still collecting its first data, the Usage tab says so instead of showing an empty chart. It shows separate messages when vnStat is not installed or not tracking anything yet.
  • "vnStat" traffic backend now does something. With it selected, the dashboard's downloaded/uploaded boxes show this month's totals from vnStat. With "Normal" they show the since-boot counters as before. Live rates always come from /proc/net/dev.
  • Database info in Settings. It shows the real database location and size and which interfaces are tracked, and warns when the database is stored in RAM.

🐛 Fixes

  • Network Usage tab showed no data on vnStat 2. It read vnStat 1.x files from /etc/vnstat/ and parsed MM/DD/YY text output, which vnStat 2 doesn't produce.
  • Status card IP. It now keeps the public IP (as seen through Passwall or any other proxy) instead of being overwritten every 2 seconds by the WAN interface's local or CGNAT address. Public lookups retry every 30 s until they succeed.
  • "Internet: Connected" now means a default route exists, not just "any interface has traffic".
  • Reset Historical Data works with vnStat 2 (vnstat --remove / --add) instead of deleting vnStat 1.x files.
  • CPU temperature reads every thermal zone, not only zones 0–9.
  • IP fallback no longer assumes interfaces named wan or wan6.
  • The stats endpoint URL is built with L.url() instead of a hard-coded /cgi-bin/luci path.
  • The default Preferred Interface is now auto-detect instead of wwan0_1.

🧹 Removed

  • The unused vnstat.htm template.

✅ Tested

Built with the OpenWrt 25.12.5 SDK and tested on an Arcadyan AW1000 running OpenWrt 25.12.5 (qualcommax/ipq807x) with an LTE modem uplink and Passwall2:

  • vnStat 1.18 → 2.13 upgrade with history imported; figures matched the pre-upgrade output.
  • Default-route detection, logical name resolution, stale settings falling back, local and public IP, vnStat month totals.
  • Usage (daily and monthly), Settings and About tabs render without errors.
  • Hotplug auto-add on ifup, ignoring ifdown and loopback; first-run "collecting" state.

Other router models and OpenWrt 24.10 (opkg) have not been tested on hardware yet. Reports are welcome.

📦 Packages

File For
luci-app-netstat-1.2.0-r1.apk OpenWrt 25.x (apk)
luci-app-netstat_1.2.0-r1_all.ipk OpenWrt 24.10 and older (opkg)

Both are architecture-independent (noarch / all).

Full changelog: v1.1.5-24...v1.2.0-1

luci-app-netstat v1.1.5-24

Choose a tag to compare

@github-actions github-actions released this 11 Oct 13:20
895d2e7
Merge pull request #19 from nooblk-98/fix/usage-auto-detect

Fix Network Usage tab showing no data when interface is auto-detected

luci-app-netstat v1.1.5-23

Choose a tag to compare

@github-actions github-actions released this 20 Sep 20:16
Fix status widget showing zeros: apply preferred interface, fall back…

luci-app-netstat v1.1.5-22

Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Sep 15:33
Auto-register preferred interface with vnstat; harden status widget a…

luci-app-netstat v1.1.5-21

Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Sep 05:43

Fix preferred interface never being applied on status page (#18)

luci-app-netstat v1.1.5-20

Choose a tag to compare

@github-actions github-actions released this 24 Apr 17:27

Summary

  • Tag: v1.1.5-20
  • Previous tag: v1.1.5-19

Bug Fixes

  • Fix periodic widget failure, memory stats, and thermal zone detection (b9d0c4b)

Updates

GitHub Generated Notes

Full Changelog: v1.1.5-19...v1.1.5-20

luci-app-netstat v1.1.5-19

Choose a tag to compare

@github-actions github-actions released this 13 Apr 05:33

Summary

  • Tag: v1.1.5-19
  • Previous tag: v1.1.4-19

Bug Fixes

  • Fix thermal zone detection and speed up status page load (5aeff4e)

GitHub Generated Notes

Full Changelog: v1.1.4-19...v1.1.5-19

Release v1.1.4-19

Choose a tag to compare

@github-actions github-actions released this 12 Apr 07:34

Summary

  • Tag: v1.1.4-19
  • Previous tag: v1.1.4-18

Bug Fixes

  • Fix CPU stat sleep: replace os.execute with nixio.nanosleep (ff17481)

GitHub Generated Notes

Full Changelog: v1.1.4-18...v1.1.4-19