ytmpv - A dmenu based shell script for loading URL's with mpv, yt-dlp, and ytfzf

---

Why does ytmpv exist?

This project was created in reaction to Youtube and it's parent company Google declaring war on adblock, removing my access to YouTube. Since I refuse to give YouTube or Google money via Ad Revenue, I created this script to provide a quick access to proxies, mainly yt-dlp.

Requirements

• yt-dlp (https://github.com/yt-dlp/yt-dlp)
• dmenu (ytfzf support will NOT work with the case insensitive patch, as it uses -i)
• mpv
• ytfzf (for Search Result Scraping)
• notify-send

How to get audio from youtube videos using ytmpv

• Run ytmpv -a SADA, ytmpv -a XAUD, or ytmpv
• If you haven't already specified the subcommand as XAUD or SADA wiht the -a flag specify either subcommand by typing "XAUD::" or "SADA::" before your URL or search term.
• If your specified subcommand is XAUD provide the URL to the video you wish to download. If it is "SADA", provide a search term.
• If you have specified a search term, you will be prompted with the search results for that term, Select one.
• You will be asked for a subdirectory of ~/Music to save the file in, if you do not chose one, it will be placed in ~/Music/
• You will be asked for a filename, ".ogg" will automatically be appended to the end of the filename. If you do not choose a filename, it will be saved to "Song".
• The video will be downloaded, audio extracted, and you will be notified (unless -q is given) when the audio is done downloading, automatically saved to vorbis format.

How to browse and play Youtube videos with ymtpv

• Run ytmpv -a SAP, or ytmpv
• If you haven't already specified the subcommand as SAP specify it by typing "SAP::" before your search term.
• If you have specified a search term, you will be prompted with the search results for that term, Select one.
• The video will be played with mpv; You will be notified (unless -q is given) if the video has failed to play

Subcommands

Special subcommands can be specified by putting FOOBAR:: at the start of the URL. For example DOWN::https://www.foo.bar will download the video located at https://www.foo.bar The default subcommand when no other one is specified "PLAY", which will play the URL given in mpv.

• DOWN Downloads video with yt-dlp instead of playing it
• XAUD Extract Audio, Downloads video with yt-dlp with flags passed to yt-dlp to extract only audio in Vorbis format, It will prompt for a name using dmenu and only start downloading after the name is given, Downloads default to the "$HOME/Music" Directory.
• SADA Runs ytfzf on prompt, Preforms the XAUD subcommand on the URL of the selected video
• SAP Runs ytfzf on prompt, Preforms the PLAY subcommand on the URL of the selected video

Configuration and flags

-q can be used to silence notifications

-s or -a can be used to specify a subcommand before processing the prompt, so you don't have to specify it in the prompt

-p Can be used to change the default player from mpv

-g Can be used to change the default downloader (Ex. curl)

-d Can be used to change the Music Directory from ~/Music

Refer to the source code and the docuentation for specified applications for further configuration