vd-go 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2026 Saimon
+
+Permission is hereby granted, free of
+charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# vd - High-Performance Video Downloader 🚀
+
+`vd` is a lightweight, blazing-fast, and multi-threaded CLI video downloader written in Go. It supports parallel downloads using goroutines, format selection, playlist management, and much more.
+
+## 🌟 Features
+
+- **Multi-threaded:** Download multiple URLs or playlist items in parallel using `-go`.
+- **Cross-Platform:** Works seamlessly on Windows, Linux, and macOS.
+- **Format Control:** List and select specific video/audio formats.
+- **Post-processing:** Extract audio, embed subtitles, metadata, and thumbnails (requires FFmpeg).
+- **Privacy & Security:** Support for proxies, cookies (browser/file), and IPv4/IPv6 forcing.
+- **Smart Management:** Skip existing files, record download history, and restrict filenames.
+
+## 📦 Installation
+
+Since `vd` is distributed via npm, you can install it globally on any system with Node.js installed:
+
+```bash
+npm install -g vb-go
+
+```
+
+
+## 🚀 Quick Start
+
+Help menu
+```bash
+vd -h
+
+``` 
+
+Basic download:
+
+```bash
+vd "[https://www.youtube.com/watch?v=example](https://www.youtube.com/watch?v=example)"
+
+```
+
+Download multiple videos in parallel:
+
+```bash
+vd -go "URL1" "URL2" "URL3"
+
+```
+
+Download a playlist to a specific directory:
+
+```bash
+vd -P ./my-videos -yes-playlist "PLAYLIST_URL"
+
+```
+
+## 🛠️ Common Options
+
+| Flag          | Description                                             |
+| ------------- | ------------------------------------------------------- |
+| `-go`         | Download all provided URLs in parallel using goroutines |
+| `-go-workers` | Set max parallel workers (e.g., `-go-workers 3`)        |
+| `-f`          | Specify format (e.g., `bestvideo+bestaudio`)            |
+| `-x`          | Extract audio only (requires FFmpeg)                    |
+| `-P`          | Set download directory path                             |
+| `-F`          | List all available formats                              |
+| `-j`          | Print JSON information                                  |
+
+## 📖 Examples
+
+**Extract MP3 audio from a video:**
+
+```bash
+vd -x --audio-format mp3 "URL"
+
+```
+
+**Download specific items from a playlist:**
+
+```bash
+vd -I 1:5,10 "PLAYLIST_URL"
+
+```
+
+**Force IPv4 and use a proxy:**
+
+```bash
+vd -4 --proxy "socks5://127.0.0.1:1080" "URL"
+
+```
+
+## ⚙️ Requirements
+
+- **FFmpeg (Optional):** Required for merging video/audio tracks, extracting audio, or embedding metadata.
+- **Node.js:** Required for installation via npm.
+
+---
+License: MIT ([LICENSE](LICENSE))
+---
+
+Built with ❤️ by [Saimon](https://nextsaimon.com/)

package/index.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+const { spawn } = require("child_process");
+const path = require("path");
+const os = require("os");
+const fs = require("fs");
+const https = require("https");
+
+const platform = os.platform();
+const arch = os.arch();
+const version = "1.0.0";
+
+let binaryName = "";
+if (platform === "win32") {
+  binaryName = arch === "arm64" ? "vd-win-arm.exe" : "vd-win.exe";
+} else if (platform === "linux") {
+  binaryName = "vd-linux";
+} else if (platform === "darwin") {
+  binaryName = arch === "arm64" ? "vd-macos-arm" : "vd-macos-intel";
+}
+
+const binDir = path.join(__dirname, "bin");
+const binaryPath = path.join(binDir, binaryName);
+const downloadUrl = `https://github.com/nextsaimon/vd/releases/download/v${version}/${binaryName}`;
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (res) => {
+        if (
+          res.statusCode >= 300 &&
+          res.statusCode < 400 &&
+          res.headers.location
+        ) {
+          return download(res.headers.location, dest)
+            .then(resolve)
+            .catch(reject);
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`Failed to download: ${res.statusCode}`));
+        }
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on("finish", () => {
+          file.close();
+          if (platform !== "win32") fs.chmodSync(dest, 0o755);
+          resolve();
+        });
+      })
+      .on("error", (err) => {
+        fs.unlink(dest, () => {});
+        reject(err);
+      });
+  });
+}
+
+async function run() {
+  if (!fs.existsSync(binaryPath)) {
+    if (!fs.existsSync(binDir)) fs.mkdirSync(binDir);
+    console.log(`Downloading vd binary for ${platform}...`);
+    await download(downloadUrl, binaryPath);
+    console.log("Download complete.\n");
+  }
+
+  const args = process.argv.slice(2);
+  const child = spawn(binaryPath, args, { stdio: "inherit" });
+  child.on("close", (code) => process.exit(code || 0));
+}
+
+run().catch((err) => {
+  console.error("Error:", err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "vd-go",
+  "version": "1.0.1",
+  "description": "High-performance video downloader CLI using Go",
+  "main": "index.js",
+  "preferGlobal": true,
+  "bin": {
+    "vd": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "author": "Saimon",
+  "license": "MIT"
+}