Parse media easily
Simple JavaScript library to ease integration with media and oEmbed. Useful for obtaining direct links to media content and thumbnails. Uses a combination of oEmbed APIs and custom APIs.
You should see media-embed-server for a server that provides this as a JSON/JSONP service.
Installing the library
Installing the service is quite easy:
npm install media-parser
Parsing info about a resource
// Signature (timeout is in milliseconds):media_parser = media_parser
// Examplemedia_parser = { console; console; }media_parser // Will print "get_thumbnail_url": Function "title": 'PSY - GANGNAM STYLE (강남스타일) M/V' "raw": raw oEmbed data
Result description
// Example "title": "..." "underlying_type": ... can be: page image video audio "content_url": ... direct link to the "content_type": ... MIME type of content_url "raw": ... raw oEmbed { ... returns thumbnail }
Other useful functions
// Extract supported URLs from contentmedia_parser
// Return an object of supported services:media_parser
// Return a pattern that can match supported services:media_parser
Running tests
Requires buster:
sh compile.sh; buster-test
Adding a new service
It should be quite trivial to add a new service:
- Add a new handler in
src/media_services.coffee
- Add the handler to
src/media_parser.coffee
- Add a test suite in
tests/test_core.coffee
- Test using
sh compile.sh; buster-test
Supported services
These services are supported:
- deviantart.com (oEmbed)
- flickr.com (oEmbed)
- hulu.com (oEmbed)
- justin.tv (oEmbed)
- rdio.com (oEmbed)
- screenr.com (oEmbed)
- slideshare.com (oEmbed)
- soundcloud.com (oEmbed)
- spotify.com (oEmbed)
- ted.com (oEmbed)
- vimeo.com (oEmbed)
- youtube.com (oEmbed)
- img.ly (custom)
- instagr.am (custom)
- twitpic.com (custom)
- yfrog.com (custom)
Related
- TodoistMediaParser - similar version done in Java