Cloudinary Blog

Video Management Made Easy

Video Management Made Easy with Cloudinary

Like it or not, visuals tell better stories than words. But using images and videos on a website presents challenges. This article is a follow-up to Website Image Performance Improvement, in which we discussed how to upload, store, manipulate, optimize and deliver images, efficiently and effectively. Now, let's talk video.

Much like we talked in our previous article about the managing images on your website, you may also have a need to render video content. Trust me -- simply throwing a <video> tag with an accurate source to the browser does not deliver user satisfaction. At a high level, you need to consider the website layout, video quality and delivery, as well as address challenges, such as:

Adjusting video quality based on network conditions. For example, users in developing countries may have a slower internet connection compared to users in developed countries Delivering content to mobile users Transcoding for different browsers Manipulating video, such as resizing, cropping and adding visual effects

All these requirements make video complex. You cannot just take care of videos in few hours. In fact, you may find it difficult to find answers to certain questions on video management. But, there is one swift solution -- Cloudinary.

Cloudinary is an all-in-one media management solution. In this article, we are going to delve into using Cloudinary to easily upload, manipulate and deliver videos.

Let's see how we can use Cloudinary in our Node application.

Setup and Installation

Using Cloudinary in your existing application is easy:

  • Create a free Cloudinary account. You will receive an API key and secret. Store the key and your cloud name somewhere safe and easily accessible.
  • Install the Cloudinary SDK in your existing project: npm install --save cloudinary
  • Include and configure Cloudinary in your Node app using the credentials received after creating a new account:
var cloudinary = require('cloudinary');

cloudinary.config({ 
    cloud_name: '<CLOUD_NAME>', 
    api_key: '<API_KEY>', 
    api_secret: '<API_SECRET>' 
});

The cloud_name is enough when making and opening API calls like delivering videos. The key and secret are needed for secure calls, such as video uploads.

Video Upload

All you need to start managing videos is to upload the best video quality you have. You can manipulate videos on-the-fly using Cloudinary's comprehensive API and easy to use manipulation URLs. Therefore, there is no need to do that before uploading. Let's see a simple code example from Node for making a video upload:

cloudinary.uploader.upload("MLB_Vid.mp4", 
        function(result) {console.log(result); }, 
        { resource_type: "video" });

It’s the same API method for images, but this time you have to explicitly tell the uploader that the resource type is video by passing the following as the third argument for the upload method:

{ resource_type: "video" }

Video Delivery

After uploading videos, you need to determine how they should be delivered. You can use the SDK's video API to achieve this:

cloudinary.video("MLB_Vid")

Video Transformation

Transformation is the act of adjusting the existing properties and quality of the videos to achieve the desired output.

Manual transformations can be complex and time-consuming. Mitigating these challenges is not easy, but that is where Cloudinary comes in.

Video transformations come in a variety of forms:

  • Quality Optimization
  • Resizing and Cropping
  • Transcoding
  • Content manipulation
  • Audio adjustment
  • and a lot more

You can transform videos at one of two different stages:

  • When uploading (known as Eager Transformation)
  • While delivering (known as Lazy Transformation)

Eager Transformation

Eager transformation is best when you do not need to manipulate video dynamically. You just need to manipulate once, store and deliver to users.

Let's see an example of transforming videos while uploading:

cloudinary.uploader.upload("MLB_Vid.mp4", 
    function(result) {console.log(result); }, 
    { resource_type: "video", 
      eager: [
      { width: 300, height: 300,
        crop: "pad", audio_codec: "none" }, 
      { width: 160, height: 100,
        crop: "crop", gravity: "south",
        audio_codec: "none" } ]});

The third argument, which is an object, is also used to specify the eager transformation using an eager property.

Lazy Transformation

In lazy transformation, the reverse becomes the case. Rather than manipulating videos during upload, you can store the best quality available and manipulate them on delivery.

Therefore, you have the control to dynamically generate a transformed variation of a given video when you are about to embed it in the browser:

Ruby:
cl_video_tag("MLB_Vid", :transformation=>[
  {:width=>300, :height=>300, :crop=>"fill"},
  {:overlay=>"cloudinary_icon", :width=>0.8, :flags=>"relative", :effect=>"brightness:200", :opacity=>50}
  ])
PHP:
cl_video_tag("MLB_Vid", array("transformation"=>array(
  array("width"=>300, "height"=>300, "crop"=>"fill"),
  array("overlay"=>"cloudinary_icon", "width"=>0.8, "flags"=>"relative", "effect"=>"brightness:200", "opacity"=>50)
  )))
Python:
CloudinaryVideo("MLB_Vid").video(transformation=[
  {'width': 300, 'height': 300, 'crop': "fill"},
  {'overlay': "cloudinary_icon", 'width': 0.8, 'flags': "relative", 'effect': "brightness:200", 'opacity': 50}
  ])
Node.js:
cloudinary.video("MLB_Vid", {transformation: [
  {width: 300, height: 300, crop: "fill"},
  {overlay: "cloudinary_icon", width: "0.8", flags: "relative", effect: "brightness:200", opacity: 50}
  ]})
Java:
cloudinary.url().transformation(new Transformation()
  .width(300).height(300).crop("fill").chain()
  .overlay(new Layer().publicId("cloudinary_icon")).width(0.8).flags("relative").effect("brightness:200").opacity(50)).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {transformation: [
  {width: 300, height: 300, crop: "fill"},
  {overlay: new cloudinary.Layer().publicId("cloudinary_icon"), width: "0.8", flags: "relative", effect: "brightness:200", opacity: 50}
  ]}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {transformation: [
  {width: 300, height: 300, crop: "fill"},
  {overlay: new cloudinary.Layer().publicId("cloudinary_icon"), width: "0.8", flags: "relative", effect: "brightness:200", opacity: 50}
  ]})
React:
<Video publicId="MLB_Vid" >
  <Transformation width="300" height="300" crop="fill" />
  <Transformation overlay="cloudinary_icon" width="0.8" flags="relative" effect="brightness:200" opacity="50" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation width="300" height="300" crop="fill">
  </cl-transformation>
  <cl-transformation overlay="cloudinary_icon" width="0.8" flags="relative" effect="brightness:200" opacity="50">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation()
  .Width(300).Height(300).Crop("fill").Chain()
  .Overlay(new Layer().PublicId("cloudinary_icon")).Width(0.8).Flags("relative").Effect("brightness:200").Opacity(50)).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation()
  .width(300).height(300).crop("fill").chain()
  .overlay(new Layer().publicId("cloudinary_icon")).width(0.8).flags("relative").effect("brightness:200").opacity(50)).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation()
  .setWidth(300).setHeight(300).setCrop("fill").chain()
  .setOverlay("cloudinary_icon").setWidth(0.8).setFlags("relative").setEffect("brightness:200").setOpacity(50)).generate("MLB_Vid.mp4")

Video Transformation Examples

Let's see five interesting techniques you can apply using video transformation:

1. Resizing and Cropping

You can adjust the size and width of your videos to fit the user’s screen, which will in turn reduce the amount of kilobytes that will need to be downloaded:

Ruby:
cl_video_tag("MLB_Vid", :width=>150, :height=>150, :crop=>"scale")
PHP:
cl_video_tag("MLB_Vid", array("width"=>150, "height"=>150, "crop"=>"scale"))
Python:
CloudinaryVideo("MLB_Vid").video(width=150, height=150, crop="scale")
Node.js:
cloudinary.video("MLB_Vid", {width: 150, height: 150, crop: "scale"})
Java:
cloudinary.url().transformation(new Transformation().width(150).height(150).crop("scale")).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {width: 150, height: 150, crop: "scale"}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {width: 150, height: 150, crop: "scale"})
React:
<Video publicId="MLB_Vid" >
  <Transformation width="150" height="150" crop="scale" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation width="150" height="150" crop="scale">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Width(150).Height(150).Crop("scale")).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation().width(150).height(150).crop("scale")).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setWidth(150).setHeight(150).setCrop("scale")).generate("MLB_Vid.mp4")

You also can retain the aspect ratio by providing only the width and using the scale crop type:

Ruby:
cl_video_tag("MLB_Vid", :width=>150, :crop=>"scale")
PHP:
cl_video_tag("MLB_Vid", array("width"=>150, "crop"=>"scale"))
Python:
CloudinaryVideo("MLB_Vid").video(width=150, crop="scale")
Node.js:
cloudinary.video("MLB_Vid", {width: 150, crop: "scale"})
Java:
cloudinary.url().transformation(new Transformation().width(150).crop("scale")).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {width: 150, crop: "scale"}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {width: 150, crop: "scale"})
React:
<Video publicId="MLB_Vid" >
  <Transformation width="150" crop="scale" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation width="150" crop="scale">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Width(150).Crop("scale")).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation().width(150).crop("scale")).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setWidth(150).setCrop("scale")).generate("MLB_Vid.mp4")

There are other scaling options that will help you gain full control over your videos' dimensions.

2. Format and Quality Control

It is possible to use a desired format or quality level that suites a given video delivery situation. The fact that you uploaded an .mp4 video does not mean you have to upload another .webm version of that video. Cloudinary uses a feature called transcoding that enables you upload a single video and deliver it dynamically in different formats:

Ruby:
cl_video_tag("MLB_Vid")
PHP:
cl_video_tag("MLB_Vid")
Python:
CloudinaryVideo("MLB_Vid").video()
Node.js:
cloudinary.video("MLB_Vid")
Java:
cloudinary.url().videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid').toHtml();
jQuery:
$.cloudinary.video("MLB_Vid")
React:
<Video publicId="MLB_Vid" >

</Video>
Angular:
<cl-video public-id="MLB_Vid" >

</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().resourceType("video").generate("MLB_Vid.webm");
iOS:
cloudinary.createUrl().setResourceType("video").generate("MLB_Vid.webm")

You also can adjust the quality of the video:

Ruby:
cl_video_tag("MLB_Vid", :quality=>50)
PHP:
cl_video_tag("MLB_Vid", array("quality"=>50))
Python:
CloudinaryVideo("MLB_Vid").video(quality=50)
Node.js:
cloudinary.video("MLB_Vid", {quality: 50})
Java:
cloudinary.url().transformation(new Transformation().quality(50)).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {quality: 50}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {quality: 50})
React:
<Video publicId="MLB_Vid" >
  <Transformation quality="50" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation quality="50">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Quality(50)).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation().quality(50)).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setQuality(50)).generate("MLB_Vid.mp4")

Find out more about format and quality control here

3. Video Trimming

You can trim video content and discard the parts you don't need by telling Cloudinary which part of the videos you want to keep:

If you would like to start at 6.5sec and end after at 10sec:

Ruby:
cl_video_tag("MLB_Vid", :start_offset=>"6.5", :end_offset=>"10")
PHP:
cl_video_tag("MLB_Vid", array("start_offset"=>"6.5", "end_offset"=>"10"))
Python:
CloudinaryVideo("MLB_Vid").video(start_offset="6.5", end_offset="10")
Node.js:
cloudinary.video("MLB_Vid", {start_offset: "6.5", end_offset: "10"})
Java:
cloudinary.url().transformation(new Transformation().startOffset("6.5").endOffset("10")).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {startOffset: "6.5", endOffset: "10"}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {start_offset: "6.5", end_offset: "10"})
React:
<Video publicId="MLB_Vid" >
  <Transformation startOffset="6.5" endOffset="10" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation start-offset="6.5" end-offset="10">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().StartOffset("6.5").EndOffset("10")).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation().startOffset("6.5").endOffset("10")).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setStartOffset("6.5").setEndOffset("10")).generate("MLB_Vid.mp4")

See more on video trimming here

4. Video Effects

Cloudinary lets you add a variety of cool effects to your videos during playtime. Effects like fade in and fade out, visual noise, blur, saturation and lots more.

Let's see a simple example of using Cloudinary to apply fade in to a video at start and fade out at end:

Ruby:
cl_video_tag("MLB_Vid", :transformation=>[
  {:effect=>"fade:2000"},
  {:effect=>"fade:-4000"}
  ])
PHP:
cl_video_tag("MLB_Vid", array("transformation"=>array(
  array("effect"=>"fade:2000"),
  array("effect"=>"fade:-4000")
  )))
Python:
CloudinaryVideo("MLB_Vid").video(transformation=[
  {'effect': "fade:2000"},
  {'effect': "fade:-4000"}
  ])
Node.js:
cloudinary.video("MLB_Vid", {transformation: [
  {effect: "fade:2000"},
  {effect: "fade:-4000"}
  ]})
Java:
cloudinary.url().transformation(new Transformation()
  .effect("fade:2000").chain()
  .effect("fade:-4000")).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {transformation: [
  {effect: "fade:2000"},
  {effect: "fade:-4000"}
  ]}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {transformation: [
  {effect: "fade:2000"},
  {effect: "fade:-4000"}
  ]})
React:
<Video publicId="MLB_Vid" >
  <Transformation effect="fade:2000" />
  <Transformation effect="fade:-4000" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation effect="fade:2000">
  </cl-transformation>
  <cl-transformation effect="fade:-4000">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation()
  .Effect("fade:2000").Chain()
  .Effect("fade:-4000")).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation()
  .effect("fade:2000").chain()
  .effect("fade:-4000")).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation()
  .setEffect("fade:2000").chain()
  .setEffect("fade:-4000")).generate("MLB_Vid.mp4")

The positive fade value controls fade in, while the negative fade value controls fade out.

5. Text Overlay

It is possible to add text content to your video at a given play time. Let's add a text, "Cool Video", at the down-middle part of our video. The text should be displayed after 2 seconds and should be removed after 5 seconds:

Ruby:
cl_video_tag("MLB_Vid", :overlay=>{:font_family=>"arial", :font_size=>60, :text=>"Cool%20Video"}, :gravity=>"south", :y=>80, :start_offset=>"2", :end_offset=>"5")
PHP:
cl_video_tag("MLB_Vid", array("overlay"=>array("font_family"=>"arial", "font_size"=>60, "text"=>"Cool%20Video"), "gravity"=>"south", "y"=>80, "start_offset"=>"2", "end_offset"=>"5"))
Python:
CloudinaryVideo("MLB_Vid").video(overlay={'font_family': "arial", 'font_size': 60, 'text': "Cool%20Video"}, gravity="south", y=80, start_offset="2", end_offset="5")
Node.js:
cloudinary.video("MLB_Vid", {overlay: {font_family: "arial", font_size: 60, text: "Cool%20Video"}, gravity: "south", y: 80, start_offset: "2", end_offset: "5"})
Java:
cloudinary.url().transformation(new Transformation().overlay(new TextLayer().fontFamily("arial").fontSize(60).text("Cool%20Video")).gravity("south").y(80).startOffset("2").endOffset("5")).videoTag("MLB_Vid");
JS:
cloudinary.videoTag('MLB_Vid', {overlay: new cloudinary.TextLayer().fontFamily("arial").fontSize(60).text("Cool%20Video"), gravity: "south", y: 80, startOffset: "2", endOffset: "5"}).toHtml();
jQuery:
$.cloudinary.video("MLB_Vid", {overlay: new cloudinary.TextLayer().fontFamily("arial").fontSize(60).text("Cool%20Video"), gravity: "south", y: 80, start_offset: "2", end_offset: "5"})
React:
<Video publicId="MLB_Vid" >
  <Transformation overlay={{fontFamily: "arial", fontSize: 60, text: "Cool%20Video"}} gravity="south" y="80" startOffset="2" endOffset="5" />
</Video>
Angular:
<cl-video public-id="MLB_Vid" >
  <cl-transformation overlay="text:arial_60:Cool%20Video" gravity="south" y="80" start-offset="2" end-offset="5">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Overlay(new TextLayer().FontFamily("arial").FontSize(60).Text("Cool%20Video")).Gravity("south").Y(80).StartOffset("2").EndOffset("5")).BuildVideoTag("MLB_Vid")
Android:
MediaManager.get().url().transformation(new Transformation().overlay(new TextLayer().fontFamily("arial").fontSize(60).text("Cool%20Video")).gravity("south").y(80).startOffset("2").endOffset("5")).resourceType("video").generate("MLB_Vid.mp4");
iOS:
cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setOverlay("text:arial_60:Cool%20Video").setGravity("south").setY(80).setStartOffset("2").setEndOffset("5")).generate("MLB_Vid.mp4")

Adaptive Bitrate Streaming

Cloudinary can deliver videos optimally using a smart technique know as Adaptive Bitrate Streaming. This is a video delivery technique that adjusts the quality of a video stream in real time according to detected bandwidth and CPU capacity. With adaptive bitrate streaming, videos start quicker, with fewer buffering interruptions, and is delivered at the best possible quality for the current device and network connection, to maximize user experience.

cloudinary.uploader.upload('MLB_Vid.mp4', 
        function(result) {console.log(result); }, 
        { resource_type: "video", 
        eager: [
            { streaming_profile: "full_hd", format: "m3u8" }],                                   
        eager_async: true,
        eager_notification_url: "http://mywebsite/upload_completed",
        public_id: "my_MLB"});

An eager transformation is initiated during upload. This transformation is an array that takes a streaming profile configuration. The MLB_Vid.mp4 video is encoded into HLS format using a Full HD streaming profile.

You can learn more about this technique in a previous article or via the documentation

Responsive Videos

Eliminate stretching or shrinking videos when adapting them for different screen dimensions. Based on the resizing and cropping transformation feature we have seen, you can perform automatic resizing and cropping to fit the graphic design and layout on any device, at any resolution, using Cloudinary’s powerful URL-based transformations.

Conclusion

Now is the time to step back and reflect. Compare what you could afford to do with your videos manually and how long it would take, to what you can accomplish with Cloudinary in your arsenal. With Cloudinary, you’ll improve your productivity with its robust features and be able to cater to whatever media management needs you might have. Get started by signing up if you haven't already!

Christian Nwamba Christian Nwamba (CodeBeast), is a JavaScript Preacher, Community Builder and Developer Evangelist. In his next life, Chris hopes to remain a computer programmer.

Recent Blog Posts

An Eye-Opening Talk: Building Apps for the Next Billion Users in Africa

William (iChuloo) Imoh, who hails from Lagos, Nigeria, recently embarked on a U.S. speaking tour, February 20-March 12, during which he powwowed with technical and product teams and communities at such renowned enterprises as Netlify, Pluralsight, Lucidchart, Twilio, and more in Salt Lake City, Dallas, Las Vegas, and San Francisco. On March 5, he gave an enlightening talk, entitled International Developers and Development: Building for the Next Billion Users at Cloudinary in Santa Clara, California. Below is a synopsis. For details, see the related slides.

Read more
The Debut of the Cloudinary Customer Advisory Board

Focus on customers has always been Cloudinary’s mantra. Because we owe them our success, we are constantly reaching out to our customers, not just for feedback on our offerings, but also for their vision, wish list, and buy-in of what Cloudinary can do to meet their needs and make them succeed. About six months ago, it occurred to us that it would be beneficial if we could meet regularly with those who are behind innovation at our key customers—executives, product gurus, developers, content managers—to swap strategies, product roadmaps, best practices, and such. In particular, we’d like to solicit actionable feedback as a foundation for our plans of product enhancements.

Read more
Media Management With the Cloudinary-Netlify CMS Integration

Static sites and the JAMstack are quickly becoming a standard for developing safe and performant websites with an optimal workflow for developers. Netlify CMS (not to be confused with the company that created it, Netlify) is an open source content management solution that works especially with static site generators such as Gatsby, Hugo, etc... enabling content storage in your Git repository along with your code for easier versioning, multichannel publishing, and direct content updates in Git.

Read more
Vitaly Friedman's Insights on Media Conferences

Vitaly Friedman is a die-hard devotee of beautiful content. Born in Minsk, Belarus, he studied Computer Science and Mathematics in Germany, unearthing in himself a passion for typography, writing, and design in the interim. After a six-year stint as a freelance designer and developer, he co-founded Smashing Magazine, a leading online publication on web design and development. You can follow SmashingMag on Twitter @SmashingMag.

Read more