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")

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")

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")

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")

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")

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")
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")
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

Build the Back-End For Your Own Instagram-style App with Cloudinary

Github Repo

Managing media files (processing, storage and manipulation) is one of the biggest challenges we encounter as practical developers. These challenges include:

A great service called Cloudinary can help us overcome many of these challenges. Together with Cloudinary, let's work on solutions to these challenges and hopefully have a simpler mental model towards media management.

Read more

Build A Miniflix in 10 Minutes

By Prosper Otemuyiwa
Build A Miniflix in 10 Minutes

Developers are constantly faced with challenges of building complex products every single day. And there are constraints on the time needed to build out the features of these products.

Engineering and Product managers want to beat deadlines for projects daily. CEOs want to roll out new products as fast as possible. Entrepreneurs need their MVPs like yesterday. With this in mind, what should developers do?

Read more

Your Web Image is Unnecessarily Bloated

By Christian Nwamba
Your Web Image is Unnecessarily Bloated

As a developer, it seems inefficient to serve a 2000kb JPEG image when we could compress images to optimize the performance without degrading the visual quality.

We are not new to this kind of responsibility. But our productivity will end up being questioned if we do not deliver fast. In order to do so, the community has devised several patterns to help improve productivity. Let's review few of these patterns based on their categories:

Read more

Google For Nigeria: We saw it all…

By Christian Nwamba
Google For Nigeria: We saw it all…

Note from Cloudinary: Christian Nwamba, a frequent Cloudinary contributor, recently attended, and was a main speaker, at the Google Developer Group (GDG) Conference in Lagos, Nigeria. Christian led a session teaching more than 500 developers how to “Build Offline Apps for the Next Billion Users.” The stack he used included JS (Vue), Firebase, Service Workers and Cloudinary. Below is his account of the conference and his talk.

Read more
Viral Images: Securing Images and Video uploads to your systems

When was the last time you got paid $40,000 for a few days of work? That is what happened last year to Russian independent security researcher Andrey Leonov, who discovered that if you upload a specially constructed image file to Facebook, you can make Facebook's internal servers, nested deep within their firewalls, run arbitrary commands to expose sensitive internal files in a way that could easily lead to a data breach.

Read more