An open API service indexing awesome lists of open source software.

https://github.com/squiter/ivy-youtube

Search for an Youtube video inside Emacs with Ivy
https://github.com/squiter/ivy-youtube

emacs emacs-packages ivy

Last synced: 3 months ago
JSON representation

Search for an Youtube video inside Emacs with Ivy

Awesome Lists containing this project

README

          

[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/hyperium/hyper/master/LICENSE)

#Ivy-YouTube






Ivy-YouTube is a simple plugin to query YouTube via emacs and play videos in your browser.

**IMPORTANT:** Remember to set your 'ivy-youtube-key' variable!

## Based on Helm-Youtube

This package was based on [Maximilian Roquemore](https://github.com/maximus12793)'s package called [helm-youtube](https://github.com/maximus12793/helm-youtube).
Thanks Maximilian to create this awesome package.

## Installation

The installation process is very simple:

- M-x package-install: ivy-youtube
- Obtain new google API key
[here](https://console.developers.google.com/ "Google Developer Console")

![Screenshot](https://github.com/squiter/ivy-youtube/blob/master/api.png)

- To create this API key you need to go to `Credentials` ->
`Create Credentials` and select `API Key`
- After create you need to **enable** it: go to `Library`, select
`YouTube Data API` and click in `Enable` button on top.

- **IMPORTANT:** Set 'ivy-youtube-key' variable

``` el
M-x customize-variable ;; search 'ivy-youtube-key'
Ivy Youtube Key: replace "NONE" with "API KEY" ;; FROM STEP 2
```

## Where do you want to play the video?

By default Ivy Youtube play the selected video in your default browser, but you can configure that:

### Change the default browser:

Set browse-url-generic and add to .emacs

``` elisp
;;start ivy-youtube.el
(autoload 'ivy-youtube "ivy-youtube" nil t)
(global-set-key (kbd "C-c y") 'ivy-youtube) ;; bind hotkey

;;set default browser for you will use to play videos/default generic
(setq browse-url-browser-function 'browse-url-generic)
(setq browse-url-generic-program "google-chrome-open-url")
```

### Using an external player (beta)

You can set a external player to watch your videos, like `mpv` or
`vlc`. To do that you need to set the custom varialble
`ivy-youtube-play-at`: `M-x
customize-variableivy-youtube-play-at`.
You can set in this field any binary that receives the youtube url as
parameter like: `/usr/bin/mpv` or `/usr/bin/vlc`.