Skip to the content.



Maintainer: Euro20179 Discord Discord

A POSIX script that helps you find Youtube videos (without API) and opens/downloads them using mpv/youtube-dl


This is a little showcase


Table Of Contents


Dependencies

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

Requried dependencies

Optional dependencies

Alternative Thumbnail Viewers

Program Wayland Support
chafa
catimg
w3m (buggy)
imv
kitty

Install

Repo status

if on linux and installed using make on version 2.0 or prior, run sudo make uninstall-old first

  1. Install the dependencies listed above
  2. Run the following commands
git clone https://github.com/pystardust/ytfzf
cd ytfzf
sudo make install doc

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


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>


Bugs

Credits

User Contributions Donate
Pystardust contributions  
Euro20179 contributions donate
Simonhughxyz contributions  
Jac-Zac contributions  
Mudskipper875 contributions