PHPackages                             wmrsp/bluebillywig-youtube-importer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. wmrsp/bluebillywig-youtube-importer

ActiveLibrary

wmrsp/bluebillywig-youtube-importer
===================================

Composer package allowing to easily import video's from a YouTube channel into a Blue Billywig VMS publication.

1.1.1(7y ago)05MITPHPPHP >= 7.1.3

Since Mar 29Pushed 7y agoCompare

[ Source](https://github.com/wmrsp/bluebillywig-youtube-importer)[ Packagist](https://packagist.org/packages/wmrsp/bluebillywig-youtube-importer)[ RSS](/packages/wmrsp-bluebillywig-youtube-importer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (5)Versions (5)Used By (0)

Blue Billywig YouTube Importer
==============================

[](#blue-billywig-youtube-importer)

Composer package allowing to easily import video's from a YouTube channel into a Blue Billywig VMS publication.

**NOTE**

All video's must be publicly accessible.

**DISCLAIMER**

Youtube-dl does not use the YouTube API but scrapes web pages to collect data from the YouTube videos. This could cause youtube-dl or this package to stop working without notice.

Getting Started
---------------

[](#getting-started)

### Requirements

[](#requirements)

This package uses the command line software youtube-dl under the hood. This piece of software **must** be installed on your computer in order to use this package. To install youtube-dl, follow these instruction [here](https://ytdl-org.github.io/youtube-dl/).

In order to communicate with the Blue Billywig API a shared secret is required. A shared secret can be generated by going to https://*YourPublication*.bbvms.com/ovp/#/publication/api-keys (where *YourPublication* needs to be substituted with the name of your publication) and clicking *CREATE NEW KEY*.

### Why youtube-dl? Why not use the YouTube API directly?

[](#why-youtube-dl-why-not-use-the-youtube-api-directly)

In order to communicate with the YouTube API, a special API key is required. In order to obtain such a key, one needs to create a Google account, create a project inside the Developer Console and then follow some elaborate instructions. On top of that, one is only able to make x amount of requests (for free) using this key.

Since there is a security risk involved as well as a limit to the amount of API calls that can be made using the YouTube API key, it is not feasible to include a YouTube API key with this package.

Since it is a pain to force you to create a Google account and make you jump through hoops in order to create a YouTube API key, this package uses youtube-dl instead. Yes, that does require you to install an extra piece of software on your computer but, it is easier to install and delete than a Google account. Also, youtube-dl does not only work with YouTube but with [hundreds of other sites](https://ytdl-org.github.io/youtube-dl/supportedsites.html) as well.

All in all, youtube-dl is the more flexible and open-ended solution to gather information from the video's on your YouTube channel.

Usage
-----

[](#usage)

### Include bluebillywig-youtube-importer into your project

[](#include-bluebillywig-youtube-importer-into-your-project)

In the root of your project run the following command:

```
composer require wmrsp/bluebillywig-youtube-importer
```

### Downloading metadata

[](#downloading-metadata)

```