Unvlogable 
A simple interface that provides a standardized oembed output for video services.
The inspiration comes from an old idea that served as the foundation of unvlog. Back then we had it implemented in this old and rusty ruby gem.
Usage
Calling unvlogable with a video url from the supported services will return an oembed object with type, version, provider_name, title, thumbnail_url, html, width and height.
const unvlogable = require('unvlogable');
await unvlogable('https://www.youtube.com/watch?v=_Nwn9ybsCRk');
/*=> { type: 'video',
version: '1.0',
provider_name: 'youtube',
title: 'Can\'t Stop by Red Hot Chili Peppers but I can\'t start...',
thumbnail_url: 'https://i.ytimg.com/vi/_Nwn9ybsCRk/maxresdefault.jpg',
html: '<iframe width="480" height="270" src="https://www.youtube.com/embed/_Nwn9ybsCRk?feature=oembed" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>',
width: 480,
height: 270 }
*/Configure the width and height of the embed code passing the desired values.
const unvlogable = require('unvlogable');
await unvlogable('https://www.youtube.com/watch?v=_Nwn9ybsCRk', {
embed: { width: 800, height: 600 }
});
/*=> { type: 'video',
version: '1.0',
provider_name: 'youtube',
title: 'Can\'t Stop by Red Hot Chili Peppers but I can\'t start...',
thumbnail_url: 'https://i.ytimg.com/vi/_Nwn9ybsCRk/maxresdefault.jpg',
html: '<iframe width="800" height="600" src="https://www.youtube.com/embed/_Nwn9ybsCRk?feature=oembed" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>',
width: 800,
height: 600 }
*/Supported Services
- Collegehumor
- Dailymotion
- Facebook video
- Gfycat
- Giphy
- Livestream
- Metacafe
- Myspace
- Ted
- Tiktok
- Twitch
- Vimeo
- Youtube
Running tests
$ npm i -d && npm testContributing
For bugs and feature requests, please create an issue. Pull requests are always welcome.
