diff --git a/README.md b/README.md index b800834..a3e8a04 100644 --- a/README.md +++ b/README.md @@ -114,38 +114,78 @@ uv tool install "viu-media[notifications]" # For desktop notifications ``` #### Termux You may have to have rust installed see this issue: https://github.com/pydantic/pydantic-core/issues/1012#issuecomment-2511269688. + ```bash -pkg install python # though uv will probably install python for you, but doesn't hurt to have it :) -pkg install rust # maybe required cause of pydantic - - # Recommended (with pip due to more control) +pkg install python +pkg install rust # required cause of pydantic + +# NOTE: order matters + +# get pydantic from the termux user repository +pip install pydantic --extra-index-url https://termux-user-repository.github.io/pypi/ + +# the above will take a while if you want to see more output and feel like sth is happening lol +pip install pydantic --extra-index-url https://termux-user-repository.github.io/pypi/ -v + +# now you can install viu pip install viu-media -# you may need to install pydantic manually -python -m pip install pydantic --extra-index-url https://termux-user-repository.github.io/pypi/ # may also be necessary incase the above fails +# === optional deps === +# if you have reach here awesome lol :) -# add yt-dlp by +# yt-dlp for downloading m3u8 and hls streams pip install yt-dlp[default,curl-cffi] -# prefer without standard and manually install the things you need lxml, yt-dlp and -pip install viu-media[standard] +# you may also need ffmpeg for processing the videos +pkg install ffmpeg -# you may need to manually install lxml and plyer manually eg -python -m pip install lxml --extra-index-url https://termux-user-repository.github.io/pypi/ # may also be necessary incase the above fails +# tip if you also want yt functionality +pip install yt-dlp-ejs -# Alternative With Uv may work, no promises -pkg install uv +# you require js runtime +# eg the recommended one +pkg install deno -uv tool install viu-media +# for faster fuzzy search +pip install thefuzz -# and to add yt-dlp only you can do -uv tool install viu-media --with yt-dlp[default,curl-cffi] +# if you want faster scraping, though barely noticeable lol +pip install lxml --extra-index-url https://termux-user-repository.github.io/pypi/ -# or though may fail, cause of lxml and plyer, in that case try to install manually -uv tool install viu-media[standard] +# if compilation fails you need to have +pkg install libxml2 libxslt + +# == ui setup == +pkg install fzf + +# then enable fzf in the config +viu --selector fzf config --update + +# if you want previews as well specify preview option +# though images arent that pretty lol, so you can stick to text over full +viu --preview text config --update + +# if you set preview to full you need a terminal image renderer +pkg install chafa + +# == player setup == +# for this you need to strictly install from playstore +# search for mpv or vlc (recommended, since has nicer ui) +# the only limitation is currently its not possible to pass headers to the android players +# through android intents +# so use servers like sharepoint and wixmp +# though this is not an issue when it comes to downloading ;) +# if you have installed using 'pkg' uninstall it + +# okey now you are all set, i promise the hussle is worth it lol :) +# posted a video of it working to motivate you +# note i recorded it from waydroid which is android for linux sought of like an emulator(bluestacks for example) +``` + + +https://github.com/user-attachments/assets/0c628421-a439-4dea-91bb-7153e8f20ccf - ``` #### Using pipx (for isolated environments) ```bash