From a752a9efddd730f64e003c5b5e9405a0d6c7885d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 1 Jan 2026 07:27:24 +0000 Subject: [PATCH 2/6] docs: Add pre-built binaries section to README installation Co-authored-by: Benexl <81157281+Benexl@users.noreply.github.com> --- README.md | 32 +++++++++++++++++++++++++++++++- 1 file changed, 31 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a3e8a04..583734c 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ ## Installation -Viu runs on any platform with Python 3.10+, including Windows, macOS, Linux, and Android (via Termux, see other installation methods). +Viu runs on Windows, macOS, Linux, and Android (via Termux). Pre-built binaries are available for quick installation without Python, or you can install via Python 3.10+ package managers. ### Prerequisites @@ -64,6 +64,36 @@ For the best experience, please install these external tools: * [**ffmpeg**](https://www.ffmpeg.org/) - Required for downloading HLS streams and merging subtitles. * [**webtorrent-cli**](https://github.com/webtorrent/webtorrent-cli) - For streaming torrents directly. +### Pre-built Binaries (Recommended for Quick Start) + +The easiest way to get started is to download a pre-built, self-contained binary from the [**GitHub Releases page**](https://github.com/viu-media/viu/releases/latest). These binaries include all dependencies and **do not require Python** to be installed. + +**Available for:** +* **Linux** (x86_64) +* **Windows** (x86_64) +* **macOS** (Intel x86_64 and Apple Silicon ARM64) + +**Installation Steps:** +1. Download the appropriate binary for your platform from the [releases page](https://github.com/viu-media/viu/releases/latest). +2. Make it executable (Linux/macOS): + ```bash + chmod +x viu-* + ``` +3. Move it to a directory in your `PATH` (optional but recommended): + ```bash + # Linux/macOS + sudo mv viu-* /usr/local/bin/viu + + # Or to a user directory + mkdir -p ~/.local/bin + mv viu-* ~/.local/bin/viu + # Make sure ~/.local/bin is in your PATH + ``` +4. Run Viu: + ```bash + viu --version + ``` + ### Recommended Installation (uv) The best way to install Viu is with [**uv**](https://github.com/astral-sh/uv), a lightning-fast Python package manager. From 2bb62fd0afb755d98b40ff6e4753d34e9a05729f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 1 Jan 2026 07:28:46 +0000 Subject: [PATCH 3/6] docs: Make binary installation instructions more specific Co-authored-by: Benexl <81157281+Benexl@users.noreply.github.com> --- README.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 583734c..78dd158 100644 --- a/README.md +++ b/README.md @@ -77,16 +77,19 @@ The easiest way to get started is to download a pre-built, self-contained binary 1. Download the appropriate binary for your platform from the [releases page](https://github.com/viu-media/viu/releases/latest). 2. Make it executable (Linux/macOS): ```bash - chmod +x viu-* + # Replace with the actual binary name you downloaded + chmod +x viu-linux-x86_64 # For Linux + chmod +x viu-macos-x86_64 # For macOS Intel + chmod +x viu-macos-arm64 # For macOS Apple Silicon ``` 3. Move it to a directory in your `PATH` (optional but recommended): ```bash - # Linux/macOS - sudo mv viu-* /usr/local/bin/viu + # Linux/macOS (replace with your binary name) + sudo mv viu-linux-x86_64 /usr/local/bin/viu # Or to a user directory mkdir -p ~/.local/bin - mv viu-* ~/.local/bin/viu + mv viu-linux-x86_64 ~/.local/bin/viu # Make sure ~/.local/bin is in your PATH ``` 4. Run Viu: From 121e02a7e29d94a4d78f07de7c4952f65a4c7864 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 1 Jan 2026 07:29:46 +0000 Subject: [PATCH 4/6] docs: Clarify binary installation with exact filenames and Windows steps Co-authored-by: Benexl <81157281+Benexl@users.noreply.github.com> --- README.md | 25 +++++++++++-------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 78dd158..d93ec2d 100644 --- a/README.md +++ b/README.md @@ -66,33 +66,30 @@ For the best experience, please install these external tools: ### Pre-built Binaries (Recommended for Quick Start) -The easiest way to get started is to download a pre-built, self-contained binary from the [**GitHub Releases page**](https://github.com/viu-media/viu/releases/latest). These binaries include all dependencies and **do not require Python** to be installed. +The easiest way to get started is to download a pre-built, self-contained binary from the [**releases page**](https://github.com/viu-media/viu/releases/latest). These binaries include all dependencies and **do not require Python** to be installed. **Available for:** -* **Linux** (x86_64) -* **Windows** (x86_64) -* **macOS** (Intel x86_64 and Apple Silicon ARM64) +* **Linux** (x86_64): `viu-linux-x86_64` +* **Windows** (x86_64): `viu-windows-x86_64.exe` +* **macOS** (Intel x86_64): `viu-macos-x86_64` +* **macOS** (Apple Silicon ARM64): `viu-macos-arm64` **Installation Steps:** 1. Download the appropriate binary for your platform from the [releases page](https://github.com/viu-media/viu/releases/latest). -2. Make it executable (Linux/macOS): +2. **Linux/macOS:** Make it executable and move to PATH: ```bash - # Replace with the actual binary name you downloaded - chmod +x viu-linux-x86_64 # For Linux - chmod +x viu-macos-x86_64 # For macOS Intel - chmod +x viu-macos-arm64 # For macOS Apple Silicon - ``` -3. Move it to a directory in your `PATH` (optional but recommended): - ```bash - # Linux/macOS (replace with your binary name) + # Example for Linux (adjust binary name for your platform) + chmod +x viu-linux-x86_64 sudo mv viu-linux-x86_64 /usr/local/bin/viu # Or to a user directory mkdir -p ~/.local/bin + chmod +x viu-linux-x86_64 mv viu-linux-x86_64 ~/.local/bin/viu # Make sure ~/.local/bin is in your PATH ``` -4. Run Viu: + **Windows:** Simply rename `viu-windows-x86_64.exe` to `viu.exe` and place it in a directory in your PATH, or run it directly. +3. Verify the installation: ```bash viu --version ``` From fd535ad3e32ad324b70e68ba893e2018d0222acd Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 1 Jan 2026 07:30:45 +0000 Subject: [PATCH 5/6] docs: Fix link consistency and chmod order in binary installation Co-authored-by: Benexl <81157281+Benexl@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d93ec2d..a70e82c 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,7 @@ The easiest way to get started is to download a pre-built, self-contained binary * **macOS** (Apple Silicon ARM64): `viu-macos-arm64` **Installation Steps:** -1. Download the appropriate binary for your platform from the [releases page](https://github.com/viu-media/viu/releases/latest). +1. Download the appropriate binary for your platform from the [**releases page**](https://github.com/viu-media/viu/releases/latest). 2. **Linux/macOS:** Make it executable and move to PATH: ```bash # Example for Linux (adjust binary name for your platform) @@ -83,8 +83,8 @@ The easiest way to get started is to download a pre-built, self-contained binary sudo mv viu-linux-x86_64 /usr/local/bin/viu # Or to a user directory - mkdir -p ~/.local/bin chmod +x viu-linux-x86_64 + mkdir -p ~/.local/bin mv viu-linux-x86_64 ~/.local/bin/viu # Make sure ~/.local/bin is in your PATH ``` From 5e9255b3d5df8b0fd81287fa5b02a2c489502894 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 1 Jan 2026 07:31:33 +0000 Subject: [PATCH 6/6] docs: Restructure binary installation to reduce redundancy Co-authored-by: Benexl <81157281+Benexl@users.noreply.github.com> --- README.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a70e82c..d95b5e2 100644 --- a/README.md +++ b/README.md @@ -76,14 +76,17 @@ The easiest way to get started is to download a pre-built, self-contained binary **Installation Steps:** 1. Download the appropriate binary for your platform from the [**releases page**](https://github.com/viu-media/viu/releases/latest). -2. **Linux/macOS:** Make it executable and move to PATH: +2. **Linux/macOS:** Make it executable: ```bash - # Example for Linux (adjust binary name for your platform) + # Replace with the actual binary name you downloaded chmod +x viu-linux-x86_64 + ``` + Then move it to a directory in your PATH: + ```bash + # Option 1: System-wide installation (requires sudo) sudo mv viu-linux-x86_64 /usr/local/bin/viu - # Or to a user directory - chmod +x viu-linux-x86_64 + # Option 2: User directory installation mkdir -p ~/.local/bin mv viu-linux-x86_64 ~/.local/bin/viu # Make sure ~/.local/bin is in your PATH