Cloudinary Blog

Video transcoding, resizing, cropping and manipulating made easy

Transcode, convert, resize, crop and manipulate videos

Videos are becoming more prolific with people having the capability to capture videos with a wide variety of cameras, including smartphone cameras that are available almost everywhere. Web and mobile applications that display videos online can be faced with a challenge when the videos are created or uploaded from different devices and in various formats, and then need to be delivered in a multitude of resolutions and aspect ratios to various web browsers, laptops and all kinds of mobile devices in HTML5 web friendly video formats.

On top of that, the videos may need to be further manipulated to fit the graphic design of the web application, whether that entails cropping, resizing, rotating, trimming, adding overlays, or even applying filters and various effects.

Developing and then supporting the backend required to transform videos from hi-res originals to HTML5 web friendly video formats that fit the graphic design of your application is a non-trivial technical process that requires considerable computational power. There are also many advanced tuning properties related to video encoding in the trade off between visual quality and file size, and doing this correctly can save a lot of bandwidth and load videos faster. Many developers spend considerable time building in-house solutions to support online videos.

Cloudinary offers a solution to all your development needs with:

  • No need to install any complex software - all video processing takes place in the cloud, together with an Interactive Media Library for browsing through your media files and SDKs for all popular web and mobile development frameworks for easy integration with HTML5 sites and mobile apps.
  • No need to learn how to fine tune video creation - all the best practices are already automatically applied with conversion to all formats (MP4, WebM, OGV, FLV) for optimized viewing on all web browsers and mobile devices, improving your website's loading speed while reducing your bandwidth requirements and IT costs.
  • No need to write complex code for video processing - all code is already available as a service with a URL based API for video transcoding and manipulation.
  • No need to deploy servers for video processing - it's a hosted solution.
  • No need to pre-generate all video manipulations - video transformations are done on the fly, streamed via a CDN.

Cloud-based video manipulation

Manipulating videos to fit the graphic design of the web application doesn't need to be complicated and hard to implement even if the video needs to be delivered in different sizes, formats and resolutions while supporting all the different web browsers, laptops and mobile devices. Cloudinary's rich set of video manipulation capabilities include: resizing and cropping, rotating, modifying quality, adjusting video codec settings, controlling bit rate, video trimming, thumbnail generation, conversion to animated GIF, adding text, image and video overlays, special effects and lots more. Videos are delivered using dynamic URLs with on-the-fly transcoding and real-time manipulation while streaming the video content via a worldwide CDN with streaming support for the best performance.

The following are some examples of manipulating a video called funny_dog that was uploaded to Cloudinary.

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

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

</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.BuildVideoTag("funny_dog")
Android:
MediaManager.get().url().resourceType("video").generate("funny_dog.mp4")

Video resizing and cropping

Resize the video to a width of 200 pixels and a height of 150 pixels using the fill cropping mode and focusing on the bottom of the video in the case that only a portion of the video is used:

Ruby:
cl_video_tag("funny_dog", :width=>200, :height=>150, :gravity=>"south", :crop=>"fill")
PHP:
cl_video_tag("funny_dog", array("width"=>200, "height"=>150, "gravity"=>"south", "crop"=>"fill"))
Python:
CloudinaryVideo("funny_dog").video(width=200, height=150, gravity="south", crop="fill")
Node.js:
cloudinary.video("funny_dog", {width: 200, height: 150, gravity: "south", crop: "fill"})
Java:
cloudinary.url().transformation(new Transformation().width(200).height(150).gravity("south").crop("fill")).videoTag("funny_dog")
JS:
cl.videoTag('funny_dog', {width: 200, height: 150, gravity: "south", crop: "fill"}).toHtml();
jQuery:
$.cloudinary.video("funny_dog", {width: 200, height: 150, gravity: "south", crop: "fill"})
React:
<Video publicId="funny_dog" >
  <Transformation width="200" height="150" gravity="south" crop="fill" />
</Video>
Angular:
<cl-video public-id="funny_dog" >
  <cl-transformation width="200" height="150" gravity="south" crop="fill">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Width(200).Height(150).Gravity("south").Crop("fill")).BuildVideoTag("funny_dog")
Android:
MediaManager.get().url().transformation(new Transformation().width(200).height(150).gravity("south").crop("fill")).resourceType("video").generate("funny_dog.mp4")

Resize the video to a width of 300 pixels and a height of 200 pixels using the pad cropping mode and use a blue background in the case that the video needs padding:

Ruby:
cl_video_tag("funny_dog", :width=>300, :height=>200, :background=>"#0e4167", :crop=>"pad")
PHP:
cl_video_tag("funny_dog", array("width"=>300, "height"=>200, "background"=>"#0e4167", "crop"=>"pad"))
Python:
CloudinaryVideo("funny_dog").video(width=300, height=200, background="#0e4167", crop="pad")
Node.js:
cloudinary.video("funny_dog", {width: 300, height: 200, background: "#0e4167", crop: "pad"})
Java:
cloudinary.url().transformation(new Transformation().width(300).height(200).background("#0e4167").crop("pad")).videoTag("funny_dog")
JS:
cl.videoTag('funny_dog', {width: 300, height: 200, background: "#0e4167", crop: "pad"}).toHtml();
jQuery:
$.cloudinary.video("funny_dog", {width: 300, height: 200, background: "#0e4167", crop: "pad"})
React:
<Video publicId="funny_dog" >
  <Transformation width="300" height="200" background="#0e4167" crop="pad" />
</Video>
Angular:
<cl-video public-id="funny_dog" >
  <cl-transformation width="300" height="200" background="#0e4167" crop="pad">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Width(300).Height(200).Background("#0e4167").Crop("pad")).BuildVideoTag("funny_dog")
Android:
MediaManager.get().url().transformation(new Transformation().width(300).height(200).background("#0e4167").crop("pad")).resourceType("video").generate("funny_dog.mp4")

Video overlays, trimming, transcoding and more

Scale the width to 300 pixels, the height to 200 pixels, set the quality to 40 and add an overlay saying "Funny Dog" in Roboto 30px white text starting at the 3 second mark and 10 pixels from the bottom of the video:

Ruby:
cl_video_tag("funny_dog", :transformation=>[
  {:width=>300, :height=>200, :quality=>40, :crop=>"scale"},
  {:overlay=>"text:Roboto_30px_bold:Funny%20Dog", :color=>"white", :gravity=>"south", :y=>10, :start_offset=>"3"}
  ])
PHP:
cl_video_tag("funny_dog", array("transformation"=>array(
  array("width"=>300, "height"=>200, "quality"=>40, "crop"=>"scale"),
  array("overlay"=>"text:Roboto_30px_bold:Funny%20Dog", "color"=>"white", "gravity"=>"south", "y"=>10, "start_offset"=>"3")
  )))
Python:
CloudinaryVideo("funny_dog").video(transformation=[
  {"width": 300, "height": 200, "quality": 40, "crop": "scale"},
  {"overlay": "text:Roboto_30px_bold:Funny%20Dog", "color": "white", "gravity": "south", "y": 10, "start_offset": "3"}
  ])
Node.js:
cloudinary.video("funny_dog", {transformation: [
  {width: 300, height: 200, quality: 40, crop: "scale"},
  {overlay: "text:Roboto_30px_bold:Funny%20Dog", color: "white", gravity: "south", y: 10, start_offset: "3"}
  ]})
Java:
cloudinary.url().transformation(new Transformation()
  .width(300).height(200).quality(40).crop("scale").chain()
  .overlay("text:Roboto_30px_bold:Funny%20Dog").color("white").gravity("south").y(10).startOffset("3")).videoTag("funny_dog")
JS:
cl.videoTag('funny_dog', {transformation: [
  {width: 300, height: 200, quality: 40, crop: "scale"},
  {overlay: "text:Roboto_30px_bold:Funny%20Dog", color: "white", gravity: "south", y: 10, start_offset: "3"}
  ]}).toHtml();
jQuery:
$.cloudinary.video("funny_dog", {transformation: [
  {width: 300, height: 200, quality: 40, crop: "scale"},
  {overlay: "text:Roboto_30px_bold:Funny%20Dog", color: "white", gravity: "south", y: 10, start_offset: "3"}
  ]})
React:
<Video publicId="funny_dog" >
  <Transformation width="300" height="200" quality="40" crop="scale" />
  <Transformation overlay="text:Roboto_30px_bold:Funny%20Dog" color="white" gravity="south" y="10" start_offset="3" />
</Video>
Angular:
<cl-video public-id="funny_dog" >
  <cl-transformation width="300" height="200" quality="40" crop="scale">
  </cl-transformation>
  <cl-transformation overlay="text:Roboto_30px_bold:Funny%20Dog" color="white" gravity="south" y="10" start_offset="3">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation()
  .Width(300).Height(200).Quality(40).Crop("scale").Chain()
  .Overlay("text:Roboto_30px_bold:Funny%20Dog").Color("white").Gravity("south").Y(10).StartOffset("3")).BuildVideoTag("funny_dog")
Android:
MediaManager.get().url().transformation(new Transformation()
  .width(300).height(200).quality(40).crop("scale").chain()
  .overlay("text:Roboto_30px_bold:Funny%20Dog").color("white").gravity("south").y(10).startOffset("3")).resourceType("video").generate("funny_dog.mp4")

Transcode the video to the webm format and apply the best codec settings for web viewing with the vc_auto parameter, add the cloudinary_icon image overlay with a width of 160 pixels and 10 pixels from the northeast corner with a brightness of 200% and an opacity of 70%, and adjust the total width to 350 pixels and the height to 150 pixels while padding with a blue background:

Ruby:
cl_video_tag("funny_dog", :transformation=>[
  {:video_codec=>"auto"},
  {:overlay=>"cloudinary_icon", :gravity=>"north_east", :effect=>"brightness:200", :opacity=>70, :x=>10, :y=>10, :width=>160},
  {:width=>350, :height=>150, :background=>"#0e4167", :crop=>"pad"}
  ])
PHP:
cl_video_tag("funny_dog", array("transformation"=>array(
  array("video_codec"=>"auto"),
  array("overlay"=>"cloudinary_icon", "gravity"=>"north_east", "effect"=>"brightness:200", "opacity"=>70, "x"=>10, "y"=>10, "width"=>160),
  array("width"=>350, "height"=>150, "background"=>"#0e4167", "crop"=>"pad")
  )))
Python:
CloudinaryVideo("funny_dog").video(transformation=[
  {"video_codec": "auto"},
  {"overlay": "cloudinary_icon", "gravity": "north_east", "effect": "brightness:200", "opacity": 70, "x": 10, "y": 10, "width": 160},
  {"width": 350, "height": 150, "background": "#0e4167", "crop": "pad"}
  ])
Node.js:
cloudinary.video("funny_dog", {transformation: [
  {video_codec: "auto"},
  {overlay: "cloudinary_icon", gravity: "north_east", effect: "brightness:200", opacity: 70, x: 10, y: 10, width: 160},
  {width: 350, height: 150, background: "#0e4167", crop: "pad"}
  ]})
Java:
cloudinary.url().transformation(new Transformation()
  .videoCodec("auto").chain()
  .overlay("cloudinary_icon").gravity("north_east").effect("brightness:200").opacity(70).x(10).y(10).width(160).chain()
  .width(350).height(150).background("#0e4167").crop("pad")).videoTag("funny_dog")
JS:
cl.videoTag('funny_dog', {transformation: [
  {video_codec: "auto"},
  {overlay: "cloudinary_icon", gravity: "north_east", effect: "brightness:200", opacity: 70, x: 10, y: 10, width: 160},
  {width: 350, height: 150, background: "#0e4167", crop: "pad"}
  ]}).toHtml();
jQuery:
$.cloudinary.video("funny_dog", {transformation: [
  {video_codec: "auto"},
  {overlay: "cloudinary_icon", gravity: "north_east", effect: "brightness:200", opacity: 70, x: 10, y: 10, width: 160},
  {width: 350, height: 150, background: "#0e4167", crop: "pad"}
  ]})
React:
<Video publicId="funny_dog" >
  <Transformation video_codec="auto" />
  <Transformation overlay="cloudinary_icon" gravity="north_east" effect="brightness:200" opacity="70" x="10" y="10" width="160" />
  <Transformation width="350" height="150" background="#0e4167" crop="pad" />
</Video>
Angular:
<cl-video public-id="funny_dog" >
  <cl-transformation video_codec="auto">
  </cl-transformation>
  <cl-transformation overlay="cloudinary_icon" gravity="north_east" effect="brightness:200" opacity="70" x="10" y="10" width="160">
  </cl-transformation>
  <cl-transformation width="350" height="150" background="#0e4167" crop="pad">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation()
  .VideoCodec("auto").Chain()
  .Overlay("cloudinary_icon").Gravity("north_east").Effect("brightness:200").Opacity(70).X(10).Y(10).Width(160).Chain()
  .Width(350).Height(150).Background("#0e4167").Crop("pad")).BuildVideoTag("funny_dog")
Android:
MediaManager.get().url().transformation(new Transformation()
  .videoCodec("auto").chain()
  .overlay("cloudinary_icon").gravity("north_east").effect("brightness:200").opacity(70).x(10).y(10).width(160).chain()
  .width(350).height(150).background("#0e4167").crop("pad")).resourceType("video").generate("funny_dog.webm")

There are plenty of additional video and image manipulation options that you can choose from, we have only shown a few here to give a small taste of how easy it is to manipulate your videos. See our video documentation for more details and examples.

Creating an image thumbnail from a video

You can also easily create image thumbnails of any frame in a video and then apply any of Cloudinary's image transformations to the result. For example, to create an image thumbnail of the frame at 1 second in the funny_dog video in JPG format, scaled to a width of 250 pixels and a height of 150 pixels:

Ruby:
cl_image_tag("funny_dog.jpg", :width=>250, :height=>150, :start_offset=>"1", :crop=>"scale", :resource_type=>"video")
PHP:
cl_image_tag("funny_dog.jpg", array("width"=>250, "height"=>150, "start_offset"=>"1", "crop"=>"scale", "resource_type"=>"video"))
Python:
CloudinaryVideo("funny_dog.jpg").image(width=250, height=150, start_offset="1", crop="scale")
Node.js:
cloudinary.image("funny_dog.jpg", {width: 250, height: 150, start_offset: "1", crop: "scale", resource_type: "video"})
Java:
cloudinary.url().transformation(new Transformation().width(250).height(150).startOffset("1").crop("scale")).resourceType("video").imageTag("funny_dog.jpg")
JS:
cl.videoTag('funny_dog.jpg', {width: 250, height: 150, start_offset: "1", crop: "scale"}).toHtml();
jQuery:
$.cloudinary.image("funny_dog.jpg", {width: 250, height: 150, start_offset: "1", crop: "scale", resource_type: "video"})
React:
<Video publicId="funny_dog.jpg" resource_type="video">
  <Transformation width="250" height="150" start_offset="1" crop="scale" />
</Video>
Angular:
<cl-video public-id="funny_dog.jpg" resource_type="video">
  <cl-transformation width="250" height="150" start_offset="1" crop="scale">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation().Width(250).Height(150).StartOffset("1").Crop("scale")).BuildImageTag("funny_dog.jpg")
Android:
MediaManager.get().url().transformation(new Transformation().width(250).height(150).startOffset("1").crop("scale")).resourceType("video").generate("funny_dog.jpg")
jpg created from funny_dog.mp4 scaled to 250x150

To create a circular 300x300 sharpened image thumbnail in JPG format of the frame at the 15% mark of the funny_dog video, and then adding the cloudinary_icon image overlay with a north gravity and resizing to a width of 50% of the total image with 40% opacity:

Ruby:
cl_image_tag("funny_dog.jpg", :resource_type=>"video", :transformation=>[
  {:width=>300, :height=>300, :radius=>"max", :effect=>"sharpen", :start_offset=>"15p", :crop=>"fill"},
  {:overlay=>"cloudinary_icon", :width=>0.5, :flags=>"relative", :opacity=>40, :gravity=>"north"}
  ])
PHP:
cl_image_tag("funny_dog.jpg", array("resource_type"=>"video", "transformation"=>array(
  array("width"=>300, "height"=>300, "radius"=>"max", "effect"=>"sharpen", "start_offset"=>"15p", "crop"=>"fill"),
  array("overlay"=>"cloudinary_icon", "width"=>0.5, "flags"=>"relative", "opacity"=>40, "gravity"=>"north")
  )))
Python:
CloudinaryVideo("funny_dog.jpg").image(transformation=[
  {"width": 300, "height": 300, "radius": "max", "effect": "sharpen", "start_offset": "15p", "crop": "fill"},
  {"overlay": "cloudinary_icon", "width": 0.5, "flags": "relative", "opacity": 40, "gravity": "north"}
  ])
Node.js:
cloudinary.image("funny_dog.jpg", {resource_type: "video", transformation: [
  {width: 300, height: 300, radius: "max", effect: "sharpen", start_offset: "15p", crop: "fill"},
  {overlay: "cloudinary_icon", width: "0.5", flags: "relative", opacity: 40, gravity: "north"}
  ]})
Java:
cloudinary.url().transformation(new Transformation()
  .width(300).height(300).radius("max").effect("sharpen").startOffset("15p").crop("fill").chain()
  .overlay("cloudinary_icon").width(0.5).flags("relative").opacity(40).gravity("north")).resourceType("video").imageTag("funny_dog.jpg")
JS:
cl.videoTag('funny_dog.jpg', {transformation: [
  {width: 300, height: 300, radius: "max", effect: "sharpen", start_offset: "15p", crop: "fill"},
  {overlay: "cloudinary_icon", width: "0.5", flags: "relative", opacity: 40, gravity: "north"}
  ]}).toHtml();
jQuery:
$.cloudinary.image("funny_dog.jpg", {resource_type: "video", transformation: [
  {width: 300, height: 300, radius: "max", effect: "sharpen", start_offset: "15p", crop: "fill"},
  {overlay: "cloudinary_icon", width: "0.5", flags: "relative", opacity: 40, gravity: "north"}
  ]})
React:
<Video publicId="funny_dog.jpg" resource_type="video">
  <Transformation width="300" height="300" radius="max" effect="sharpen" start_offset="15p" crop="fill" />
  <Transformation overlay="cloudinary_icon" width="0.5" flags="relative" opacity="40" gravity="north" />
</Video>
Angular:
<cl-video public-id="funny_dog.jpg" resource_type="video">
  <cl-transformation width="300" height="300" radius="max" effect="sharpen" start_offset="15p" crop="fill">
  </cl-transformation>
  <cl-transformation overlay="cloudinary_icon" width="0.5" flags="relative" opacity="40" gravity="north">
  </cl-transformation>
</cl-video>
.Net:
cloudinary.Api.UrlVideoUp.Transform(new Transformation()
  .Width(300).Height(300).Radius("max").Effect("sharpen").StartOffset("15p").Crop("fill").Chain()
  .Overlay("cloudinary_icon").Width(0.5).Flags("relative").Opacity(40).Gravity("north")).BuildImageTag("funny_dog.jpg")
Android:
MediaManager.get().url().transformation(new Transformation()
  .width(300).height(300).radius("max").effect("sharpen").startOffset("15p").crop("fill").chain()
  .overlay("cloudinary_icon").width(0.5).flags("relative").opacity(40).gravity("north")).resourceType("video").generate("funny_dog.jpg")
Sharpened, rounded jpg created from the frame at 15% of funny_dog.mp4 filled to 300x300 with an overlay

Summary

Video uploading and delivery has become more and more popular and developers face a significant challenge handling these video files for embedding in their web and mobile apps while maintaining complex clusters to handle video uploading and transcoding. Cloudinary eliminates all the R&D work involved, and with a single line of code videos are uploaded to the cloud, and then with dynamic URLs, videos are automatically converted to all required video formats and manipulated to fit the graphic design of web applications and the various devices and resolutions.

The video manipulation features are available to all our free and paid plans. If you don't have a Cloudinary account, you are welcome to sign up to our free account and try it out.

Recent Blog Posts

How the Right Tools and Training Drive SDR Success

Here at Cloudinary, I head a team of eight SDRs, who are responsible for creating the first impression potential customers have of our company’s brand. In just the first 10 months of 2017, our team of outbound SDRs have been responsible for sending more than 67,000 personalized emails and making more than 15,000 calls.

Read more
The JS video player that developers will love (How To)

It doesn't take a genius (or a statistician) to know that video represents a significant proportion of web and mobile content these days. But did you realize that in 2017, video will account for about 75% of all internet traffic and that 55% of people watch videos online every day? In fact, 52% of marketing professionals worldwide believe that video is the content type with the best ROI, with people spending up to 2.6x more time on pages with video than on those without.

Read more
 Beyond Drupal Media: Make Images and Video Fly with Cloudinary

Drupal is a very popular open source content management system (CMS) that has been deployed countless times by organizations and developers around the world. Drupal gained a reputation for being very flexible, powerful and robust in creating complex websites. With Drupal, you can create everything from plain websites, blogs and forums to ambitious enterprise systems.

Read more
Curbing Terrorist Content Online

Today, Cloudinary is proud to announce that it has joined The Global Internet Forum to Counter Terrorism (GIFCT), to help fight the spread of terrorist and violent extremist content on the Internet. The forum was established by Facebook, Microsoft, Twitter and YouTube in mid-2017. Cloudinary will contribute to the hash-sharing database, which all contributing companies can use to help identify and block terrorist related images and videos upon upload.

Read more
Introducing the complete video solution for developers

Videos in web sites and apps are starting to catch up with images in terms of popularity and they are a constantly growing part of the media strategy for most organizations. This means bigger challenges for developers who need to handle these videos in their web sites and mobile apps. Cloudinary's mission is to solve all developer needs around image and video management. In this blog post, we are excited to introduce Cloudinary's complete cloud-based video management solution for developers.

Read more
Getting Started with StencilJS

Stencil is basically a compiler, not necessarily a UI library. A compiler that transforms TSX (TypeScript + JSX) into self-contained custom components.

Before you start learning about the tool, it’s important to note that Stencil is not another heavy JavaScript framework you need to learn. If you have worked with Angular or React, or understand web components, then Stencil is worth a look.

Read more