A POSIX script that helps you find Youtube videos (without API) and opens/downloads them using mpv/youtube-dl which can be easily installed on the termux application on android. The purpose of this fork is to enable easy installation of ytfzf with all of its documentation on termux.

---

This is a little showcase

---

Table Of Contents

• Dependencies
• Install
• Features
• Examples
• Todo
• Bugs
• Credits

---

Dependencies

There are only 2 required dependencies, however the rest require some configuration before you can replace them.

Requried dependencies

• jq
• curl

Recommended dependencies

• mpv (the default video and audio player)
• fzf (the default menu selection screen)

Optional dependencies

• yt-dlp (for downloading)
• dmenu (only if using the -D option)
• ueberzug (if using thumbnails (-t) on x11)
  • If on wayland, or you do not want ueberzug, see the alternatives below.
  • To use an alternative include --thumb-viewer=<alternative> in the command when running ytfzf

Alternative Thumbnail Viewers

Program	Wayland Support
chafa	✅
catimg	✅
w3m (buggy)	❌
imv	✅
kitty	✅

Install

1. Install the dependencies listed above
2. Run the following commands

git clone https://github.com/sattopadhyay/termux-ytfzf
cd termux-ytfzf
make install doc

• If you wish to not install documentation (highly unrecommended) run make install instead.

• You may also install ytfzf through your package manager, as listed on the side.

Addons

Addons are extra features that will not be as supported as everything built into ytfzf itself.

Addons are located in addons, copy any addon to ~/.config/ytfzf/{addon-type}/{addon}, and give it execute permissions.

You may also just copy the entire addon folder type, eg: cp -r addons/thumbnail-viewers ~/.config/ytfzf/

Usage

To use a scraper addon run ytfzf -c <scraper> ...

To use a thumbnail-viewer addon run ytfzf --thumb-viewer=<viewer> ...

To use a interface addon run ytfzf --interface=<interface> ...

To use a url-handler addon run ytfzf --url-handler=<handler> ...

To use a sort-name addon run ytfzf --sort-name=<sort-name> ...

---

Features

• Subscriptions
• Thumbnails
• Watch history
• Downloading
• Queueing multiple videos

---

Examples

Search with thumbnails

ytfzf -t <search>

Use dmenu as the menu instead of fzf

ytfzf -D <search>

Print the link of the selected video instead of playing it

ytfzf -L <search>

Search Odysee instead of youtube

ytfzf -cO <search>