YouTube helper script for mpv & yt-dlp
Go to file
2023-12-12 22:42:25 -07:00
COPYING initial commit 2023-11-02 22:09:01 -06:00
README updated README 2023-12-12 22:42:25 -07:00
yt updated README 2023-12-12 22:42:25 -07:00
yt.1 initial commit 2023-11-02 22:09:01 -06:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

yt(1) is a helper script providing functions for use with mpv and yt-dlp for
viewing and interacting with YouTube videos.

- curl(1)
- jq(1)
- yt-dlp(1)

Environment Variables:
- Set this variable to get debug output to stderr

- Set this variable to a video player that can utilize yt-dlp to playback
videos from YouTube

- Set this variable to a dmenu-compatible picker for use with the pick

- Set this variable to the directory where playlists should be stored; defaults

yt add | archive | cache | clone | list | localsearch | new | pick | play | queue | search | sync | verify

add uri playlist
- Adds a video by URI to a playlist

archive uri...
- Archives videos on the Wayback Machine

cache video...
- Caches video titles

clone uri [playlist]
- Clones a YouTube playlist to a file

- lists local playlists

- uses $YTPICK to search for videos from the local cache

new playlist...
- creates new playlists

pick playlist...
- Opens $PICKER to a list of videos in a file

play uri...
- Plays videos, caching their titles first

queue playlist...
- Queues playlists

search term [count]
- Searches YouTube for term and returns count results

sync [playlist]
- If a playlist is specified, sync that playlist with its remote YouTube
counterpart; otherwise, sync all playlists with remotes

verify playlist...
- Verifies that all the videos in a playlist are existent on YouTube, and if
they arent, attempts to replace the URI with one from the Wayback Machine. If
the video isnt available on the Wayback Machine, it comments the video link. It
then caches the title of the video.