yay

**Yet another interactive YouTube search + playback from your terminal. ** Powered by yt-dlp, fzf, and mpv.

Search YouTube, pick videos with arrow keys, play in your terminal — audio or video — and now, loop the experience as many times as you want.

---

✨ Features

• 🔍 Search YouTube directly from the terminal
• 🎬 Browse top 30 results (default, configurable)
• ⏯️ Play video or audio-only
• 🔁 Repeat selection N times (or infinitely)
• ⌨️ Keyboard-based selection (no mouse needed)
• 🚀 Fast and minimal setup
• And more importantly, no f*cking ads!

---

🛠 Requirements

Install dependencies using Homebrew:

brew install yt-dlp fzf mpv

📦 Installation

1. Clone the repo

git clone https://github.com/hepidad/yay.git

Then, enter to the directory

cd yay

2. Load the function in your shell For Zsh:

echo 'source /full/path/to/yay/yay.sh' >> ~/.zshrc
source ~/.zshrc

For Bash:

echo 'source /full/path/to/yay/yay.sh' >> ~/.bash_profile
source ~/.bash_profile

Option 2: Install as a system command (supports whereis)

If you prefer yay to be a standalone command (and discoverable by whereis), you can symlink it to your PATH:

chmod +x yay.sh
sudo ln -s "$(pwd)/yay.sh" /usr/local/bin/yay

🔄 Update

To update to the latest version:

cd /path/to/yay
git pull
source yay.sh

See RELEASE_NOTES.md for version history.

🚀 Usage

1. Basic video search

yay nature sound

• Shows top 30 YouTube results for “nature sound”
• Press arrow keys to select a result, or Esc to play the top result.
• Loops forever until you quit (Ctrl+C)
• Enable logging/history.

2. Play audio-only:

yay -a nature sound

3. Loop n times

yay -n 3 nature sound

4. Loop n times and audio only

yay -a -n 3 nature sound

5. By default, logging is enabled. To pause logging:

yay -l nature sound

6. Specify number of search results (default is 30)

yay -r 10 nature sound

7. Check version

yay --version

8. Check installation location

yay --location

9. Self-update

yay --update

Other Tips!

yay using the power of yt-dlp this mean you can:

1. Download video. For an example:

yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"

2. Download audio. For an example:

yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=VIDEO_ID"

3. Save into specific directory

yt-dlp -P /path/to/folder "https://www.youtube.com/watch?v=VIDEO_ID" 

4. Best Quality

yt-dlp -f bestvideo+bestaudio "https://www.youtube.com/watch?v=VIDEO_ID" 

📝 License

MIT — feel free to fork and improve!