@vincentzyuapps/winload 0.1.8-rc.8 โ†’ 0.1.9-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +7 -7
  2. package/readme.md +59 -9
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vincentzyuapps/winload",
3
- "version": "0.1.8-rc.8",
3
+ "version": "0.1.9-beta.1",
4
4
  "description": "Network Load Monitor โ€” nload-like TUI tool for Windows/Linux/macOS (prebuilt Rust binary)",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -33,11 +33,11 @@
33
33
  "access": "public"
34
34
  },
35
35
  "optionalDependencies": {
36
- "@vincentzyuapps/winload-win32-x64": "0.1.8-rc.8",
37
- "@vincentzyuapps/winload-win32-arm64": "0.1.8-rc.8",
38
- "@vincentzyuapps/winload-linux-x64": "0.1.8-rc.8",
39
- "@vincentzyuapps/winload-linux-arm64": "0.1.8-rc.8",
40
- "@vincentzyuapps/winload-darwin-x64": "0.1.8-rc.8",
41
- "@vincentzyuapps/winload-darwin-arm64": "0.1.8-rc.8"
36
+ "@vincentzyuapps/winload-win32-x64": "0.1.9-beta.1",
37
+ "@vincentzyuapps/winload-win32-arm64": "0.1.9-beta.1",
38
+ "@vincentzyuapps/winload-linux-x64": "0.1.9-beta.1",
39
+ "@vincentzyuapps/winload-linux-arm64": "0.1.9-beta.1",
40
+ "@vincentzyuapps/winload-darwin-x64": "0.1.9-beta.1",
41
+ "@vincentzyuapps/winload-darwin-arm64": "0.1.9-beta.1"
42
42
  }
43
43
  }
package/readme.md CHANGED
@@ -1,4 +1,5 @@
1
1
  ![winload](https://socialify.git.ci/VincentZyu233/winload/image?custom_language=Rust&description=1&forks=1&issues=1&language=1&logo=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F250448479%3Fs%3D200%26v%3D4&name=1&owner=1&pulls=1&stargazers=1&theme=Auto)
2
+ ![onefetch](docs/images/onefetch.png)
2
3
 
3
4
  # Winload <img src="https://github.com/user-attachments/assets/62fec846-0442-47f6-bbba-78acdc8803ef" height="32px">
4
5
 
@@ -26,6 +27,7 @@
26
27
  [![AUR](https://img.shields.io/badge/AUR-1793D1?style=for-the-badge&logo=archlinux&logoColor=white)](https://aur.archlinux.org/packages/winload-rust-bin)
27
28
  [![APT](https://img.shields.io/badge/APT-E95420?style=for-the-badge&logo=debian&logoColor=white)](https://github.com/VincentZyuApps/winload/releases)
28
29
  [![RPM](https://img.shields.io/badge/RPM-CB1626?style=for-the-badge&logo=redhat&logoColor=white)](https://github.com/VincentZyuApps/winload/releases)
30
+ [![Homebrew](https://img.shields.io/badge/Homebrew-FBB040?style=for-the-badge&logo=homebrew&logoColor=black)](https://github.com/VincentZyuApps/homebrew-tap/blob/main/Formula/winload.rb)
29
31
 
30
32
  > **[๐Ÿ“– Build Docs](.github/workflows/build.md)**
31
33
 
@@ -49,6 +51,27 @@ https://github.com/rolandriegel/nload
49
51
 
50
52
  ![Winload Benchmark](docs/benchmark/benchmark.svg)
51
53
 
54
+ ## ๐Ÿ”ง Run from Source
55
+
56
+ ### Python
57
+ ```bash
58
+ git clone https://github.com/VincentZyuApps/winload.git
59
+ # or clone from Gitee (faster in China Mainland):
60
+ # git clone https://gitee.com/vincent-zyu/winload.git
61
+ cd winload/py
62
+ pip install -r requirements.txt
63
+ python main.py
64
+ ```
65
+
66
+ ### Rust
67
+ ```bash
68
+ git clone https://github.com/VincentZyuApps/winload.git
69
+ cd winload/rust
70
+ cargo run --release
71
+ cargo run --release -- --help # Show help
72
+ cargo run --release -- --version # Show version
73
+ ```
74
+
52
75
  ## ๐Ÿ Python Edition Installation
53
76
  > ๐Ÿ’ก **Implementation Note**: Only PyPI and GitHub/Gitee provide Python edition.
54
77
  > Only Cargo provides Rust source code for local compilation.
@@ -59,7 +82,7 @@ pip install winload
59
82
  # recommend use uv:
60
83
  # https://docs.astral.sh/uv/getting-started/installation/
61
84
  # https://gitee.com/wangnov/uv-custom/releases
62
- uv venv
85
+ uv venv --python 3.13
63
86
  uv pip install winload
64
87
  uv run winload
65
88
  uv run python -c "import shutil; print(shutil.which('winload'))"
@@ -85,8 +108,13 @@ cargo install winload
85
108
  cargo install --list
86
109
  ```
87
110
  ### Windows (Scoop)
111
+ > ๐Ÿ“„ [Scoop Bucket (GitHub)](https://github.com/VincentZyuApps/scoop-bucket/blob/main/bucket/winload.json)
112
+ > ๐Ÿ“„ [Scoop Bucket (Gitee)](https://gitee.com/vincent-zyu/scoop-bucket/blob/main/bucket/winload.json)
88
113
  ```powershell
89
114
  scoop bucket add vincentzyu https://github.com/VincentZyuApps/scoop-bucket
115
+ # or from Gitee:
116
+ # scoop bucket add vincentzyu https://gitee.com/vincent-zyu/scoop-bucket
117
+ scoop update # optional: manually refresh bucket list before install
90
118
  scoop install winload
91
119
  # execute bin file
92
120
  win-nload
@@ -99,6 +127,7 @@ where win-nload # CMD
99
127
  > scoop install windows-terminal-preview
100
128
  > wtp
101
129
  > ```
130
+ > ๐Ÿ’ก **All builds require Windows 10+** (Rust 1.77+ dropped Windows 7/8 support). Scoop provides only **MSVC + Npcap** for **x86_64** and **ARM64**. For other variants (MinGW, non-Npcap, i686) or older Windows, download from [GitHub Releases](https://github.com/VincentZyuApps/winload/releases).
102
131
 
103
132
  ### Arch Linux (AUR):
104
133
  ```bash
@@ -123,7 +152,19 @@ which winload
123
152
  ```
124
153
  > ๐Ÿ“„ [View Gitee install script](https://gitee.com/vincent-zyu/winload/blob/main/docs/install_scripts/install_gitee.sh)
125
154
 
126
- > โš ๏ธ These install scripts only support systems with **apt or dnf** package managers on **x86_64 / aarch64** architectures. For other platforms, use **npm** (`npm install -g @vincentzyuapps/winload`) or **Cargo** (`cargo install winload`) instead.
155
+ > โš ๏ธ The two `curl ... | bash` install scripts above support **x86_64 / aarch64** systems with **apt** (Debian/Ubuntu), **dnf** (Fedora/RHEL), or **Termux** (Android). For other platforms, use **npm** (`npm install -g @vincentzyuapps/winload`) or **Cargo** (`cargo install winload`) instead.
156
+
157
+ ### macOS / Linux (Homebrew)
158
+ > ๐Ÿ“„ [Homebrew Formula (GitHub)](https://github.com/VincentZyuApps/homebrew-tap/blob/main/Formula/winload.rb)
159
+ > ๐Ÿ“„ [Homebrew Formula (Gitee)](https://gitee.com/vincent-zyu/homebrew-tap/blob/main/Formula/winload.rb)
160
+ ```bash
161
+ brew tap vincentzyuapps/tap
162
+ # or from Gitee (manual tap clone):
163
+ # git clone https://gitee.com/vincent-zyu/homebrew-tap.git "$(brew --prefix)/Library/Taps/vincentzyuapps/homebrew-tap"
164
+ brew update && brew install winload
165
+ which winload
166
+ ```
167
+ > ๐Ÿ’ก Homebrew supports **macOS** (Intel & Apple Silicon) and **Linux** (x86_64 & ARM64).
127
168
 
128
169
  <details>
129
170
  <summary>Manual install</summary>
@@ -131,15 +172,15 @@ which winload
131
172
  **DEB (Debian/Ubuntu):**
132
173
  ```bash
133
174
  # Download the latest .deb from GitHub Releases
134
- sudo dpkg -i ./winload_*_amd64.deb
175
+ sudo dpkg -i ./winload*.deb
135
176
  # or use apt (auto-resolves dependencies)
136
- sudo apt install ./winload_*_amd64.deb
177
+ sudo apt install ./winload*.deb
137
178
  which winload
138
179
  ```
139
180
 
140
181
  **RPM (Fedora/RHEL):**
141
182
  ```bash
142
- sudo dnf install ./winload-*-1.x86_64.rpm
183
+ sudo dnf install ./winload*.rpm
143
184
  which winload
144
185
  ```
145
186
 
@@ -153,6 +194,9 @@ which winload
153
194
  winload # Monitor all active network interfaces
154
195
  winload -t 200 # Set refresh interval to 200ms
155
196
  winload -d "Wi-Fi" # Start with a specific device
197
+ winload --title # Show "winload <version>" as the header title
198
+ winload --title "My Monitor" # Use a custom header title
199
+ winload --title "" # Keep the default device header
156
200
  winload -e # Enable emoji decorations ๐ŸŽ‰
157
201
  winload --npcap # Capture 127.0.0.1 loopback traffic (Windows, requires Npcap)
158
202
  ```
@@ -164,6 +208,7 @@ winload --npcap # Capture 127.0.0.1 loopback traffic (Windows, requires Npc
164
208
  | `-t`, `--interval <MS>` | Refresh interval in milliseconds | `500` |
165
209
  | `-a`, `--average <SEC>` | Average calculation window in seconds | `300` |
166
210
  | `-d`, `--device <NAME>` | Default device name (partial match) | โ€” |
211
+ | `--title [TITLE]` | Override header title: no value shows `winload <version>`; empty string keeps the default device header | โ€” |
167
212
  | `-e`, `--emoji` | Enable emoji decorations in TUI ๐ŸŽ‰ | off |
168
213
  | `-U`, `--unicode` | Use Unicode block characters for graph (โ–ˆโ–“โ–‘ยท) | off |
169
214
  | `-u`, `--unit <UNIT>` | Display unit: `bit` or `byte` | `bit` |
@@ -220,13 +265,18 @@ On Linux and macOS, loopback traffic works out of the box โ€” no extra flags nee
220
265
 
221
266
  ## ๐Ÿ–ผ๏ธ Previews
222
267
  #### Python Edition Preview
223
- ![docs/preview-py.png](docs/preview-py.png)
268
+ ![docs/images/preview-py.png](docs/images/preview-py.png)
224
269
 
225
270
  #### Rust Edition Preview
226
- ![docs/preview-rust.png](docs/preview-rust.png)
271
+ ![docs/images/preview-rust.png](docs/images/preview-rust.png)
227
272
 
228
273
  ##### Rust Edition Preview GIF
229
- ![docs/preview-rust.gif](docs/preview-rust.gif)
274
+ ![docs/images/preview-rust.gif](docs/images/preview-rust.gif)
275
+
276
+ ##### Terminal Recording
277
+ <a href="https://asciinema.org/a/1030894?startAt=30" target="_blank"><img src="https://asciinema.org/a/1030894.svg" alt="winload demo" width="100%" /></a>
278
+
279
+ > โ†‘ Recorded by [asciinema](https://github.com/asciinema/asciinema)
230
280
 
231
281
  ## ๐Ÿ“ฆ Dependencies
232
282
 
@@ -234,7 +284,7 @@ On Linux and macOS, loopback traffic works out of the box โ€” no extra flags nee
234
284
 
235
285
  | Package | Version | Description |
236
286
  |:---|:---|:---|
237
- | [![Python](https://img.shields.io/badge/Python-3.12.12-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org/) | 3.12.12 | Programming language |
287
+ | [![Python](https://img.shields.io/badge/Python-3.13.11-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org/) | 3.13.11 | Programming language |
238
288
  | [![psutil](https://img.shields.io/badge/psutil-โ‰ฅ7.0-FFD43B?style=flat-square&logo=python&logoColor=white)](https://github.com/giampaolo/psutil) | โ‰ฅ7.0 | Process and system utilities |
239
289
  | [![windows-curses](https://img.shields.io/badge/windows--curses-โ‰ฅ2.0-FFD43B?style=flat-square&logo=python&logoColor=white)](https://github.com/zhirui2020/windows-curses) | โ‰ฅ2.0 | Windows curses support |
240
290