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

Commit 5f7e10a

Browse files
authored
Update README with Termux installation instructions
Added installation instructions for Termux and clarified Python installation requirements.
1 parent 95586eb commit 5f7e10a

1 file changed

Lines changed: 35 additions & 1 deletion

File tree

README.md

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

5454
### Prerequisites
5555

@@ -112,6 +112,40 @@ uv tool install "viu-media[notifications]" # For desktop notifications
112112
# Git version (latest commit)
113113
yay -S viu-media-git
114114
```
115+
#### Termux
116+
You may have to have rust installed see this issue: https://github.com/pydantic/pydantic-core/issues/1012#issuecomment-2511269688.
117+
```bash
118+
pkg install python # though uv will probably install python for you, but doesn't hurt to have it :)
119+
pkg install rust # maybe required cause of pydantic
120+
121+
122+
# Recommended (with pip due to more control)
123+
pip install viu-media
124+
125+
# you may need to install pydantic manually
126+
python -m pip install pydantic --extra-index-url https://termux-user-repository.github.io/pypi/ # may also be necessary incase the above fails
127+
128+
# add yt-dlp by
129+
pip install yt-dlp[default,curl-cffi]
130+
131+
# prefer without standard and manually install the things you need lxml, yt-dlp and
132+
pip install viu-media[standard]
133+
134+
# you may need to manually install lxml and plyer manually eg
135+
python -m pip install lxml --extra-index-url https://termux-user-repository.github.io/pypi/ # may also be necessary incase the above fails
136+
137+
# Alternative With Uv may work, no promises
138+
pkg install uv
139+
140+
uv tool install viu-media
141+
142+
# and to add yt-dlp only you can do
143+
uv tool install viu-media --with yt-dlp[default,curl-cffi]
144+
145+
# or though may fail, cause of lxml and plyer, in that case try to install manually
146+
uv tool install viu-media[standard]
147+
148+
```
115149

116150
#### Using pipx (for isolated environments)
117151
```bash

0 commit comments

Comments
 (0)