winload-rust-bin 0.1.9-rc.7 → 0.1.10-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "winload-rust-bin",
-  "version": "0.1.9-rc.7",
+  "version": "0.1.10-beta.1",
   "description": "Network Load Monitor — nload-like TUI tool for Windows/Linux/macOS (prebuilt Rust binary)",
   "license": "MIT",
   "repository": {
@@ -33,11 +33,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@vincentzyuapps/winload-win32-x64": "0.1.9-rc.7",
-    "@vincentzyuapps/winload-win32-arm64": "0.1.9-rc.7",
-    "@vincentzyuapps/winload-linux-x64": "0.1.9-rc.7",
-    "@vincentzyuapps/winload-linux-arm64": "0.1.9-rc.7",
-    "@vincentzyuapps/winload-darwin-x64": "0.1.9-rc.7",
-    "@vincentzyuapps/winload-darwin-arm64": "0.1.9-rc.7"
+    "@vincentzyuapps/winload-win32-x64": "0.1.10-beta.1",
+    "@vincentzyuapps/winload-win32-arm64": "0.1.10-beta.1",
+    "@vincentzyuapps/winload-linux-x64": "0.1.10-beta.1",
+    "@vincentzyuapps/winload-linux-arm64": "0.1.10-beta.1",
+    "@vincentzyuapps/winload-darwin-x64": "0.1.10-beta.1",
+    "@vincentzyuapps/winload-darwin-arm64": "0.1.10-beta.1"
   }
 }

package/readme.md

@@ -202,12 +202,13 @@ which winload
 winload              # Monitor all active network interfaces
 winload -t 200       # Set refresh interval to 200ms
 winload -d "Wi-Fi"   # Start with a specific device
-winload --title      # Show "winload <version>" as the header title
 winload --title "My Monitor" # Use a custom header title
-winload --title ""   # Keep the default device header
 winload -e           # Enable emoji decorations 🎉
+winload --max-mode smart --max-half-life 10 # Smooth adaptive Y-axis (default)
+winload --max-mode legacy # nload-style visible-history scaling
+winload --max-mode fixed --max-y-value 10M # Fixed Y-axis max
 winload --npcap      # Capture 127.0.0.1 loopback traffic (Windows, requires Npcap)
-winload --netlink    # Use RTNETLINK on Linux/Android (Termux proot distro, etc.)
+winload --netlink    # Manually enable RTNETLINK (Linux/Android Rust edition, off by default)
 ```
 
 ### Options
@@ -224,8 +225,9 @@ winload --netlink    # Use RTNETLINK on Linux/Android (Termux proot distro, etc.
 | `-b`, `--bar-style <STYLE>` | Bar style: `fill`, `color`, or `plain` | `fill` |
 | `--in-color <HEX>` | Incoming graph color, hex RGB (e.g. `0x00d7ff`) | cyan |
 | `--out-color <HEX>` | Outgoing graph color, hex RGB (e.g. `0xffaf00`) | gold |
-| `-m`, `--max <VALUE>` | Fixed Y-axis max (e.g. `10M`, `1G`, `500K`) — *conflicts with `--smart-max`* | auto |
-| `--smart-max [SECS]` | Smart adaptive Y-axis: auto-decays after traffic spikes (default half-life: 10s) — *conflicts with `--max`* | off |
+| `--max-mode <MODE>` | Y-axis scaling mode: `smart`, `legacy`, or `fixed` | `smart` |
+| `--max-half-life <SECS>` | Half-life for smart Y-axis decay | `10` |
+| `--max-y-value <VALUE>` | Fixed Y-axis max for `--max-mode fixed` (e.g. `10M`, `1G`, `500K`) | — |
 | `-n`, `--no-graph` | Hide graph, show stats only | off |
 | `--hide-separator` | Hide the separator line (row of equals signs) | off |
 | `--no-color` | Disable all TUI colors (monochrome mode) | off |
@@ -235,15 +237,15 @@ winload --netlink    # Use RTNETLINK on Linux/Android (Termux proot distro, etc.
 | `-h`, `--help` | Print help (`--help --emoji` for emoji version!) | — |
 | `-V`, `--version` | Print version | — |
 
-> **Y-axis scaling modes** — there are three mutually exclusive scenarios:
+> **Y-axis scaling modes**
 >
 > | Mode | Flag | Behavior |
 > |------|------|----------|
-> | **Fixed max** | `--max <VALUE>` | Y-axis is locked to the specified value (e.g. `10M`, `1G`). |
-> | **Smart max** | `--smart-max [SECS]` | Y-axis adapts automatically: jumps up on traffic spikes, then smoothly decays back down (exponential decay, default half-life 10 s). |
-> | **History peak** | *(neither flag)* | Y-axis follows the historical maximum of each metric — the default behavior. |
+> | **smart** | `--max-mode smart --max-half-life 10` | Default. Jumps up on traffic spikes, then smoothly decays back down. |
+> | **legacy** | `--max-mode legacy` | nload-style scaling based on the visible graph history peak. |
+> | **fixed** | `--max-mode fixed --max-y-value 10M` | Locks the Y-axis to the specified value. |
 >
-> ⚠️ `--max` and `--smart-max` **conflict with each other** — you can only use one at a time.
+> `--max-y-value` is only valid with `--max-mode fixed`; `--max-half-life` is only valid with `--max-mode smart`.
 
 ### Keyboard Shortcuts
 
@@ -273,13 +275,13 @@ This requires [Npcap](https://npcap.com/#download) installed with "Support loopb
 
 On Linux and macOS, loopback traffic works out of the box — no extra flags needed.
 
-On **Linux/Android**, if `/proc/net/dev` is not accessible (e.g. inside a Termux proot distro or other restricted environments), use `--netlink` to collect network stats via RTNETLINK directly:
+On **Linux/Android**, if `/proc/net/dev` is not accessible (e.g. inside a Termux proot distro or other restricted environments), the Rust edition can use `--netlink` to collect network stats via RTNETLINK directly:
 
 ```bash
 winload --netlink
 ```
 
-> Note: `--netlink` is **Linux/Android only**. On macOS, netlink is not available — sysinfo is used by default.
+> Note: `--netlink` is an **opt-in backend**, similar to `--npcap`; it is never enabled unless you pass the flag. Normal Linux/Android runs still use sysinfo by default. This flag is **Linux/Android Rust edition only**; the Python edition does not support `--netlink` and continues to use psutil. macOS does not support netlink.
 >
 > 📖 For a deep dive into Linux/Android network statistics collection, see [docs/linux_android_netlink.md](docs/linux_android_netlink.md)