0.1.3 • Published 6 years ago

react-video-thumbnail v0.1.3

Weekly downloads
2,357
License
ISC
Repository
-
Last release
6 years ago

React Video Thumbnail

Given a video url, attempt to generate a video thumbnail using HTML Canvas Element

Note*: The <Canvas> element will only be able to generate a thumbnail, if CORS allows it.

If not, you may see a similar console error as below:

DOMException: Failed to execute 'toDataURL' on 'HTMLCanvasElement': Tainted canvases may not be exported.

Please read about Cross-Origin Resource Sharing (CORS), if you would like more details on how it works.

Installation

git clone https://github.com/brothatru/react-video-thumbnail.git

OR

npm install --save-dev react-video-thumbnail

Usage

import VideoThumbnail from 'react-video-thumbnail'; // use npm published version
...
<VideoThumbnail
    videoUrl="https://dl.dropboxusercontent.com/s/7b21gtvsvicavoh/statue-of-admiral-yi-no-audio.mp4?dl=1"
    thumbnailHandler={(thumbnail) => console.log(thumbnail)}
    width={120}
    height={80}
    />

Properties

Prop NameTypeDefaultDescription
videoUrl (Required)stringThe url of the video you want to generate a thumbnail from
corsboolfalseWhether or not to set crossOrigin attribute to anonymous.
heightintResize thumbnail to specified height
renderThumbnailbooltrueWhether to render an image tag and show the thumbnail or not.
snapshotAtTimeint2The second at which the component should snap the image at.
thumbnailHandlerfuncCallback function that takes in thumbnail url as an argument
widthintResize thumbnail to specified width

*Note: The longer the snapshotAtTime, the more video data it may have to download.

Examples

Contributors