Skip to content
This repository was archived by the owner on May 2, 2026. It is now read-only.

Commit 343fe97

Browse files
authored
Merge pull request #179 from viu-media/copilot/improve-installation-section
2 parents 9ef834c + 4caafda commit 343fe97

1 file changed

Lines changed: 34 additions & 1 deletion

File tree

README.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@
4949

5050
## Installation
5151

52-
Viu runs on any platform with Python 3.10+, including Windows, macOS, Linux, and Android (via Termux, see other installation methods).
52+
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.
5353

5454
### Prerequisites
5555

@@ -64,6 +64,39 @@ For the best experience, please install these external tools:
6464
* [**ffmpeg**](https://www.ffmpeg.org/) - Required for downloading HLS streams and merging subtitles.
6565
* [**webtorrent-cli**](https://github.com/webtorrent/webtorrent-cli) - For streaming torrents directly.
6666

67+
### Pre-built Binaries (Recommended for Quick Start)
68+
69+
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.
70+
71+
**Available for:**
72+
* **Linux** (x86_64): `viu-linux-x86_64`
73+
* **Windows** (x86_64): `viu-windows-x86_64.exe`
74+
* **macOS** (Intel x86_64): `viu-macos-x86_64`
75+
* **macOS** (Apple Silicon ARM64): `viu-macos-arm64`
76+
77+
**Installation Steps:**
78+
1. Download the appropriate binary for your platform from the [**releases page**](https://github.com/viu-media/viu/releases/latest).
79+
2. **Linux/macOS:** Make it executable:
80+
```bash
81+
# Replace with the actual binary name you downloaded
82+
chmod +x viu-linux-x86_64
83+
```
84+
Then move it to a directory in your PATH:
85+
```bash
86+
# Option 1: System-wide installation (requires sudo)
87+
sudo mv viu-linux-x86_64 /usr/local/bin/viu
88+
89+
# Option 2: User directory installation
90+
mkdir -p ~/.local/bin
91+
mv viu-linux-x86_64 ~/.local/bin/viu
92+
# Make sure ~/.local/bin is in your PATH
93+
```
94+
**Windows:** Simply rename `viu-windows-x86_64.exe` to `viu.exe` and place it in a directory in your PATH, or run it directly.
95+
3. Verify the installation:
96+
```bash
97+
viu --version
98+
```
99+
67100
### Recommended Installation (uv)
68101

69102
The best way to install Viu is with [**uv**](https://github.com/astral-sh/uv), a lightning-fast Python package manager.

0 commit comments

Comments
 (0)