V2.3

Key

• bolded changes are changes that are more noticable to the user.
  • Only changes outside of the Additions section will be bolded

Additions

Features

• extensions, extra config files located in $YTFZF_CONFIG_DIR/extensions
• video recommendations scraper (video-recommended)
  • the recommendations are based on a video url
    • so use a video url instead of normal search for this scraper
• Search operators
  • This isn't really a new feature as addons could've done this previously
  • The real change is that :help should but doesn't have to be in every scraper
  • Usage: when the search is :help a little bit of information about the scraper will be printed
• swayimg image viewer, should work on all terminals in the sway compositor
• YTFZF:DEFAULT.jpg
  • is an image that can be in ~/.config/ytfzf/thumbnails
  • will be shown when the actual thumbnail doens't exist

Options

• --ext load an extension
• --list-addons lists all installed addons and exits
• --url-handler-opts extra opts to pass to the url handler, by default this is mpv

Addons

Extensions

• notify-info
  • notify-send info, errors, and warnings instead of printing it
• auto-play
  • when a video finishes, automatically play the next recommended one
• gui
  • a basic gui interface instead of using the commandline (is SERIOUSLY lacking in features)
  • requires the gui interface

Scrapers

• Scrape lists (a more powerful subscriptions file)
  • can be kinda buggy when provided another scrape list, hence why it's an addon
• ard, scrapes https://www.ardmediathek.de/ (@Xystel)
  • supports --pages, and partially --thumbnail-quality

Interfaces

• gui
  • opens a gui interface instead of a tui or other

Url Handlers

• mpvq (@jose1711)
  • socat, and lsof are required commands for this
  • works with --detach,
  • when selecting videos, instead of opening new mpv windows, it appends it to the queue of the current mpv instance

Changes

• The default format_selection_screen (-f) is now simple instead of normal
• Custom thumbnails are shown before downloaded thumbnails
• ytdl_pref now defaults to $video_pref+$audio_pref/best/$video_pref/$audio_pref instead of $video_pref+$audio_pref/$video_pref/$audio_pref
• use the ueberzug json parser instead of simple parser (31b365a)

Fixes

• The default interface breaks if column is not found
• The default interface breaks if tput is not found
• add_commas messing up the view count, giving an incorrect number (@gardockt)
• When a shortcut is used in fzf, it stays permenantly
• Quotation marks and backslashes are prefixed by a \ (@gardockt)
• -f is broken with a new version of yt-dlp
• IFS not unset in various places, which could cause weird behaviour
• When -s or search_again is enabled, submenus produce an error
• handling of duplicate entries is not very good (@gardockt)
• Use posix shell in fzf instead of $SHELL
• $session_temp_dir and $session_cache_dir are not set in url handlers
• Many typos were fixed in the man pages. (@jose1711)
• --pages not working in scrape_invidious_channel
• get_missing_thumbnails does not work with busybox utils.
• get_ueberzug_positioning does not work with chafa, and other thumbnail viewers
• -x is offset in the -h text
• on_startup_* is no longer called each time a new item is selected in fzf

Docs

• Remove mentions of display thumbnail viewer

Technical Changes

• scrapers are sourced after ytdl_pref is set instead of before

Style

• shiftwidth=4, and tabstop=4 are enforced in vim now