Skip to content

cloudinary/cloudinary-video-player

Folders and files

NameName
Last commit message
Last commit date

Latest commit

69926d5 · Apr 21, 2025
Feb 16, 2025
Jan 3, 2024
Apr 20, 2025
Apr 20, 2025
Apr 20, 2025
Apr 14, 2024
Jan 7, 2025
Jun 1, 2020
Apr 14, 2024
Jul 15, 2024
Nov 1, 2023
Dec 8, 2022
Apr 21, 2025
Jul 19, 2017
Feb 16, 2025
Jan 11, 2024
Jan 3, 2024
Nov 21, 2017
Feb 8, 2024
Jul 20, 2020
Dec 8, 2022
Apr 21, 2025
Apr 21, 2025
Mar 17, 2024

Repository files navigation

cloudinary-video-player

Cloudinary Video Player is a JavaScript-based HTML video player bundled with many valuable customization and integration capabilities, and is monetization and analytics-ready. The player is fully responsive for use in any device or screen size, and is integrated with Cloudinary's video delivery and manipulation solution.

This README includes basic information for installation and getting started. View the documentation for comprehensive guidance on integration and all the available features.

Installation

NPM

  1. Install using:

    npm install cloudinary-video-player
  2. Import the package:

    import cloudinary from 'cloudinary-video-player';
    // Also possible:
    // import { videoPlayer } from 'cloudinary-video-player';
    import 'cloudinary-video-player/cld-video-player.min.css';

CDN

Cloudinary Video Player can also be included directly from the jsDelivr CDN:

<link href="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.css" rel="stylesheet">

<script src="https://cdn.jsdelivr.net/npm/cloudinary-video-player/dist/cld-video-player.min.js" type="text/javascript"></script>

Packages

The Cloudinary video player offers standard and light package variations, available in either minified or non-minified formats.

  • Standard package: Includes all functionality described in this video player documentation.
  • Light package: Excludes the following optional functionality: Adaptive bitrate streaming (HLS and MPEG-DASH), Video ads, Shoppable videos (alpha)
  • cld-video-player.js - Non minified version which includes all optional modules.
  • cld-video-player.min.js - Minified version which includes all optional modules.
  • cld-video-player.light.js - Non minified version which does not include any optional modules.
  • cld-video-player.light.min.js - Minified version which does not include any optional modules. (for smaller bundle size)

Getting started

Create a video tag containing cld-video-player class and a supported skin class:

<video
  id="player"
  controls
  autoplay
  data-cld-public-id="dog"
  class="cld-video-player cld-fluid">
</video>

Instantiate a new cloudinary Video Player:

cloudinary.videoPlayer('player', {
   cloudName: 'demo'
});

Documentation

Development

In order to run this project locally:

  1. Clone this repository
  2. npm install
  3. npm start