Play first result of YouTube search using mpv
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Felix Stupp bc9d00e174
README: Fixed "further" description about idea
4 years ago
LICENSE Initial commit 4 years ago
README.md README: Fixed "further" description about idea 4 years ago
mpv-yt-search.plugin.zsh Initial commit 4 years ago

README.md

MPV YouTube Search Plugin for ZSH

Allows searching for YouTube videos and playing the first result with mpv. Requires youtube-dl to be installed for search and play YouTube videos with mpv.

Repository clones

The original repository will be stored on GitHub. You can use the original reopsitory if you want to use GitHub. Also issues and pull requests will be collected there for convenience.

This repository will be cloned to my own server. You can use the clone instead of this repository if you want to avoid use GitHub.

Installation

zsh (without plugin support)

  1. Clone project
  2. Add following line to your .zshrc:
source "path/to/repo/mpv-yt-search.plugin.zsh"

oh-my-zsh

  1. Clone project into ~/.oh-my-zsh/custom/plugins/mpv-yt-search
  2. Add mpv-yt-search to your plugin list
plugins=(… mpv-yt-search …)

Antigen

  1. Add following line to your .zshrc:
antigen bundle Zocker1999NET/zsh-mpv-yt-search # GitHub if default repository unchanged
antigen bundle https://git.banananet.work/zsh-plugins/mpv-yt-search # Own Server

or

  1. Add the repository to your plugin list
antigen bundles <<EOBUNDLES
  Zocker1999NET/zsh-mpv-yt-search # GitHub if default repository unchanged
  https://git.banananet.work/zsh-plugins/mpv-yt-search # Own Server
EOBUNDLES

Antibody

  1. Add following line to your .zshrc:
antibody bundle Zocker1999NET/zsh-mpv-yt-search # GitHub if default repository unchanged
antibody bundle https://git.banananet.work/zsh-plugins/mpv-yt-search # Own Server

or

  1. Add the repository to your plugin list
antibody bundles <<EOBUNDLES
  Zocker1999NET/zsh-mpv-yt-search # GitHub if default repository unchanged
  https://git.banananet.work/zsh-plugins/mpv-yt-search # Own Server
EOBUNDLES

Usage

Command Description
yt *search terms* Plays first result as video
yta *search terms* Plays first result as audio-only (only streams audio data if possible)

License

This plugin is licensed under WTFPL. Do the fuck you want to with this plugin, but please contribute to this plugin if you have made any improvements which could be useful for others.

Contribute

If you find any issue, report it or fix it yourself and create a pull request.

Idea

The code for the command yta was taken originally from the mpv Arch Wiki page. Further the command yt was added and the commands can now be imported by others easily.