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

Commit 1144937

Browse files
authored
docs: Revise Termux installation instructions in README
Updated installation instructions for Termux, including required packages and optional dependencies.
1 parent 8837c54 commit 1144937

1 file changed

Lines changed: 58 additions & 18 deletions

File tree

README.md

Lines changed: 58 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -114,38 +114,78 @@ uv tool install "viu-media[notifications]" # For desktop notifications
114114
```
115115
#### Termux
116116
You may have to have rust installed see this issue: https://github.com/pydantic/pydantic-core/issues/1012#issuecomment-2511269688.
117+
117118
```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
119+
# Recommended (with pip due to more control)
120+
pkg install python
121+
pkg install rust # required cause of pydantic
120122

123+
# NOTE: order matters
121124

122-
# Recommended (with pip due to more control)
125+
# get pydantic from the termux user repository
126+
pip install pydantic --extra-index-url https://termux-user-repository.github.io/pypi/
127+
128+
# the above will take a while if you want to see more output and feel like sth is happening lol
129+
pip install pydantic --extra-index-url https://termux-user-repository.github.io/pypi/ -v
130+
131+
# now you can install viu
123132
pip install viu-media
124133

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
134+
# === optional deps ===
135+
# if you have reach here awesome lol :)
127136

128-
# add yt-dlp by
137+
# yt-dlp for downloading m3u8 and hls streams
129138
pip install yt-dlp[default,curl-cffi]
130139

131-
# prefer without standard and manually install the things you need lxml, yt-dlp and
132-
pip install viu-media[standard]
140+
# you may also need ffmpeg for processing the videos
141+
pkg install ffmpeg
133142

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
143+
# tip if you also want yt functionality
144+
pip install yt-dlp-ejs
136145

137-
# Alternative With Uv may work, no promises
138-
pkg install uv
146+
# you require js runtime
147+
# eg the recommended one
148+
pkg install deno
139149

140-
uv tool install viu-media
150+
# for faster fuzzy search
151+
pip install thefuzz
141152

142-
# and to add yt-dlp only you can do
143-
uv tool install viu-media --with yt-dlp[default,curl-cffi]
153+
# if you want faster scraping, though barely noticeable lol
154+
pip install lxml --extra-index-url https://termux-user-repository.github.io/pypi/
144155

145-
# or though may fail, cause of lxml and plyer, in that case try to install manually
146-
uv tool install viu-media[standard]
156+
# if compilation fails you need to have
157+
pkg install libxml2 libxslt
158+
159+
# == ui setup ==
160+
pkg install fzf
161+
162+
# then enable fzf in the config
163+
viu --selector fzf config --update
164+
165+
# if you want previews as well specify preview option
166+
# though images arent that pretty lol, so you can stick to text over full
167+
viu --preview text config --update
168+
169+
# if you set preview to full you need a terminal image renderer
170+
pkg install chafa
171+
172+
# == player setup ==
173+
# for this you need to strictly install from playstore
174+
# search for mpv or vlc (recommended, since has nicer ui)
175+
# the only limitation is currently its not possible to pass headers to the android players
176+
# through android intents
177+
# so use servers like sharepoint and wixmp
178+
# though this is not an issue when it comes to downloading ;)
179+
# if you have installed using 'pkg' uninstall it
180+
181+
# okey now you are all set, i promise the hussle is worth it lol :)
182+
# posted a video of it working to motivate you
183+
# note i recorded it from waydroid which is android for linux sought of like an emulator(bluestacks for example)
184+
```
185+
186+
187+
https://github.com/user-attachments/assets/0c628421-a439-4dea-91bb-7153e8f20ccf
147188

148-
```
149189

150190
#### Using pipx (for isolated environments)
151191
```bash

0 commit comments

Comments
 (0)