@vincentzyuapps/winload 0.1.8-rc.3 → 0.1.8-rc.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincentzyuapps/winload",
-  "version": "0.1.8-rc.3",
+  "version": "0.1.8-rc.31",
   "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.8-rc.3",
-    "@vincentzyuapps/winload-win32-arm64": "0.1.8-rc.3",
-    "@vincentzyuapps/winload-linux-x64": "0.1.8-rc.3",
-    "@vincentzyuapps/winload-linux-arm64": "0.1.8-rc.3",
-    "@vincentzyuapps/winload-darwin-x64": "0.1.8-rc.3",
-    "@vincentzyuapps/winload-darwin-arm64": "0.1.8-rc.3"
+    "@vincentzyuapps/winload-win32-x64": "0.1.8-rc.31",
+    "@vincentzyuapps/winload-win32-arm64": "0.1.8-rc.31",
+    "@vincentzyuapps/winload-linux-x64": "0.1.8-rc.31",
+    "@vincentzyuapps/winload-linux-arm64": "0.1.8-rc.31",
+    "@vincentzyuapps/winload-darwin-x64": "0.1.8-rc.31",
+    "@vincentzyuapps/winload-darwin-arm64": "0.1.8-rc.31"
   }
 }

package/readme.md

@@ -26,6 +26,7 @@
 [![AUR](https://img.shields.io/badge/AUR-1793D1?style=for-the-badge&logo=archlinux&logoColor=white)](https://aur.archlinux.org/packages/winload-rust-bin)
 [![APT](https://img.shields.io/badge/APT-E95420?style=for-the-badge&logo=debian&logoColor=white)](https://github.com/VincentZyuApps/winload/releases)
 [![RPM](https://img.shields.io/badge/RPM-CB1626?style=for-the-badge&logo=redhat&logoColor=white)](https://github.com/VincentZyuApps/winload/releases)
+[![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)
 
 > **[📖 Build Docs](.github/workflows/build.md)**
 
@@ -49,6 +50,27 @@ https://github.com/rolandriegel/nload
 
 ![Winload Benchmark](docs/benchmark/benchmark.svg)
 
+## 🔧 Run from Source
+
+### Python
+```bash
+git clone https://github.com/VincentZyuApps/winload.git
+# or clone from Gitee (faster in China Mainland):
+# git clone https://gitee.com/vincent-zyu/winload.git
+cd winload/py
+pip install -r requirements.txt
+python main.py
+```
+
+### Rust
+```bash
+git clone https://github.com/VincentZyuApps/winload.git
+cd winload/rust
+cargo run --release
+cargo run --release -- --help    # Show help
+cargo run --release -- --version # Show version
+```
+
 ## 🐍 Python Edition Installation
 > 💡 **Implementation Note**: Only PyPI and GitHub/Gitee provide Python edition.  
 > Only Cargo provides Rust source code for local compilation.  
@@ -59,7 +81,7 @@ pip install winload
 # recommend use uv:
 # https://docs.astral.sh/uv/getting-started/installation/
 # https://gitee.com/wangnov/uv-custom/releases
-uv venv
+uv venv --python 3.12
 uv pip install winload
 uv run winload
 uv run python -c "import shutil; print(shutil.which('winload'))"
@@ -85,8 +107,13 @@ cargo install winload
 cargo install --list
 ```
 ### Windows (Scoop)
+> 📄 [Scoop Bucket (GitHub)](https://github.com/VincentZyuApps/scoop-bucket/blob/main/bucket/winload.json)
+> 📄 [Scoop Bucket (Gitee)](https://gitee.com/vincent-zyu/scoop-bucket/blob/main/bucket/winload.json)
 ```powershell
 scoop bucket add vincentzyu https://github.com/VincentZyuApps/scoop-bucket
+# or from Gitee:
+# scoop bucket add vincentzyu https://gitee.com/vincent-zyu/scoop-bucket
+scoop update   # optional: manually refresh bucket list before install
 scoop install winload
 # execute bin file
 win-nload
@@ -99,6 +126,7 @@ where win-nload # CMD
 > scoop install windows-terminal-preview
 > wtp
 > ```
+> 💡 **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).
 
 ### Arch Linux (AUR):
 ```bash
@@ -123,7 +151,19 @@ which winload
 ```
 > 📄 [View Gitee install script](https://gitee.com/vincent-zyu/winload/blob/main/docs/install_scripts/install_gitee.sh)
 
-> ⚠️ 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.
+> ⚠️ 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.
+
+### macOS / Linux (Homebrew)
+> 📄 [Homebrew Formula (GitHub)](https://github.com/VincentZyuApps/homebrew-tap/blob/main/Formula/winload.rb)
+> 📄 [Homebrew Formula (Gitee)](https://gitee.com/vincent-zyu/homebrew-tap/blob/main/Formula/winload.rb)
+```bash
+brew tap vincentzyuapps/tap
+# or from Gitee (manual tap clone):
+# git clone https://gitee.com/vincent-zyu/homebrew-tap.git "$(brew --prefix)/Library/Taps/vincentzyuapps/homebrew-tap"
+brew update && brew install winload
+which winload
+```
+> 💡 Homebrew supports **macOS** (Intel & Apple Silicon) and **Linux** (x86_64 & ARM64).
 
 <details>
 <summary>Manual install</summary>
@@ -131,15 +171,15 @@ which winload
 **DEB (Debian/Ubuntu):**
 ```bash
 # Download the latest .deb from GitHub Releases
-sudo dpkg -i ./winload_*_amd64.deb
+sudo dpkg -i ./winload*.deb
 # or use apt (auto-resolves dependencies)
-sudo apt install ./winload_*_amd64.deb
+sudo apt install ./winload*.deb
 which winload
 ```
 
 **RPM (Fedora/RHEL):**
 ```bash
-sudo dnf install ./winload-*-1.x86_64.rpm
+sudo dnf install ./winload*.rpm
 which winload
 ```
 
@@ -228,6 +268,11 @@ On Linux and macOS, loopback traffic works out of the box — no extra flags nee
 ##### Rust Edition Preview GIF
 ![docs/preview-rust.gif](docs/preview-rust.gif)
 
+##### Terminal Recording
+<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>
+
+> ↑ Recorded by [asciinema](https://github.com/asciinema/asciinema)
+
 ## 📦 Dependencies
 
 ### Python Edition