feat(doc): updates the readme

Author: Wamy-Dev

README.md

@@ -1,40 +1,76 @@
-# video-link-debugger
+# Video Link Debugger
 
-A CLI built with Bunli
 
-## Installation
+## Install
+
+Pre-built binaries are published to the [Releases page](https://github.com/TorBox-App/video-link-debugger/releases) for every push. Pick the file matching your OS and CPU:
+
+| OS | File |
+| --- | --- |
+| macOS (Apple Silicon) | `video-link-debugger-darwin-arm64` |
+| Linux x64 | `video-link-debugger-linux-x64` |
+| Linux x64 (older CPUs) | `video-link-debugger-linux-x64-baseline` |
+| Linux ARM64 | `video-link-debugger-linux-arm64` |
+| Windows x64 | `video-link-debugger-windows-x64.exe` |
+| Windows ARM64 | `video-link-debugger-windows-arm64.exe` |
+
+The binaries are unsigned, so the first time you run one you'll see a security warning. The one-time fix per platform:
+
+### macOS
+
+If you see **"video-link-debugger-darwin-arm64 is damaged and can't be opened"**, that's macOS Gatekeeper rejecting the binary because it's unsigned. Run this once to remove the quarantine flag:
 
 ```bash
-bun install
+xattr -dr com.apple.quarantine ~/Downloads/video-link-debugger-darwin-arm64
+chmod +x ~/Downloads/video-link-debugger-darwin-arm64
+./video-link-debugger-darwin-arm64
 ```
 
-## Development
+### Windows
+
+If SmartScreen says **"Windows protected your PC"**, click **More info** → **Run anyway**.
+
+You can also right-click the `.exe` → Properties → check **Unblock** → OK before launching.
+
+### Linux
+
+No security prompts. Just make it executable:
 
 ```bash
-bun dev -- [command]
+chmod +x ~/Downloads/video-link-debugger-linux-x64
+./video-link-debugger-linux-x64
 ```
 
-## Building
+## Usage
 
 ```bash
-bun run build
+video-link-debugger test https://example.com/video.mp4
+# or
+video-link-debugger test --link https://example.com/video.mp4
 ```
 
-## Testing
+### Commands
+
+- `test` — Tests a video link and reports link information, network timings, seek behavior, and single- vs. multi-connection download speed.
+
+## Development
 
 ```bash
-bun test
+bun install
+bun dev -- [command]
 ```
 
-## Usage
+### Building
 
 ```bash
-video-link-debugger hello --name World
+bun run build
 ```
 
-## Commands
+### Testing
 
-- `hello` - A simple greeting command
+```bash
+bun test
+```
 
 ## License