0.5.6 • Public • Published

    Changes in this fork

    This fork adds the "progressCallbackFrequency" prop.


    Latest npm version Build Status Dependency Status devDependency Status

    A react component for playing media from YouTube, SoundCloud and Vimeo, as well as supported media files. Used by rplayr, an app to generate playlists from Reddit URLs.

    The component parses a URL and loads in the appropriate markup and external SDKs to play media from various sources. Props can be passed in to control playback and react to events such as buffering or media ending.


    npm install react-player --save
    import React, { Component } from 'react'
    import ReactPlayer from 'react-player'
    class App extends Component {
      render () {

    See the demo source for a full example.

    For platforms like Meteor without direct use of npm modules, a minified version of ReactPlayer is located in dist after installing. To generate this file yourself, checkout the repo and run npm run build:browser


    bower install react-player --save
      <script src='bower_components/react/react.js'></script> 
      <script src='bower_components/react/react-dom.js'></script> 
      <script src='bower_components/react-player/dist/ReactPlayer.js'></script> 
          <ReactPlayer url='https://www.youtube.com/watch?v=d46Azg3Pm4c' playing />,


    See a live demo, or run:

    git clone https://github.com/CookPete/react-player.git
    cd react-player
    npm install
    npm start
    open http://localhost:3000

    Mobile considerations

    Due to various restrictions, ReactPlayer is not guaranteed to function properly on mobile devices. The YouTube player documentation, for example, explains that certain mobile browsers require user interaction before playing:

    The HTML5 <video> element, in certain mobile browsers (such as Chrome and Safari), only allows playback to take place if it's initiated by a user interaction (such as tapping on the player).


    Prop Description
    url The url of a video or song to play
    playing Set to true or false to pause or play the media
    volume Sets the volume of the appropriate player
    width Sets the width of the player
    height Sets the height of the player
    className Pass in a className to set on the top level element
    progressCallbackFrequency How often onProgress callback should be called, in milliseconds (default: 1000ms)

    Callback props

    Callback props take a function that gets fired on various player events

    Prop Description
    onProgress Callback containing played and loaded progress as a fraction
    eg { played: 0.12, loaded: 0.34 }
    onDuration Callback containing duration of the media, in seconds
    onPlay Called when media starts or resumes playing after pausing or buffering
    onPause Called when media is paused
    onBuffer Called when media starts buffering
    onEnded Called when media finishes playing
    onError Called when an error occurs whilst attempting to play media

    Config props

    These props allow you to override the parameters for the various players

    Prop Description
    soundcloudConfig Configuration object for the SoundCloud player. Set clientId, to your own SoundCloud app client ID
    vimeoConfig Configuration object for the Vimeo player. Set iframeParams, to override the default params. Set preload for preloading
    youtubeConfig Configuration object for the YouTube player. Set playerVars, to override the default player vars. Set preload for preloading

    Both youtubeConfig and vimeoConfig props can take a preload value. Setting this to true will play a short, silent video in the background when ReactPlayer first mounts. This fixes a bug where videos would not play when loaded in a background browser tab.


    There is a static method ReactPlayer.canPlay(url) to determine if a URL can be played by the media player. Note that this does not detect media that is unplayable due to streaming permissions etc. In that case, onError will occur after attemping to play.

    To seek to a certain part of the media, there is a seekTo(fraction) instance method that will seek to the appropriate place in the media. See App.js for an example of this using refs.

    Supported media


    This project uses standard code style.

    npm run lint


    This project uses mocha with chai assertions for unit testing.

    npm run test



    npm i kazuldur-react-player

    DownloadsWeekly Downloads






    Last publish


    • kacperzuk