Use these common tips to start converting online videos to animated GIF's with GrabzIt's Python API. However before you start remember that after calling the URLToAnimation method the Save or SaveTo method must be called to capture the video.
The only parameter that is required is the URL of the MP4, AVI or other online video to convert into an animated GIF.
grabzIt.URLToAnimation("http://www.example.com/video.avi") # Then call the Save or SaveTo method
GrabzIt's Python API can also convert Vimeo or YouTube video's directly to animated GIF's, just specify the URL of the page that the Vimeo or YouTube video appears on and the video it contains will be converted into an animated GIF. However because this service relies on a third-party website it can not be guaranteed to work for every video.
grabzIt.URLToAnimation("https://www.youtube.com/watch?v=a1Y73sPHKxw") # Then call the Save or SaveTo method
You can pass a custom identifier into the customId
attribute of the GrabzItAnimationOptions class as shown below, this value is then returned to your GrabzIt Python handler. For instance this custom identifier could be a database identifier, allowing a animated GIF to be associated with a particular database record.
from GrabzIt import GrabzItAnimationOptions from GrabzIt import GrabzItClient grabzIt = GrabzItClient.GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret") options = GrabzItAnimationOptions.GrabzItAnimationOptions() options.customId = "123456" grabzIt.URLToAnimation("https://www.youtube.com/watch?v=a1Y73sPHKxw", options) # Then call the Save method grabzIt.Save("http://www.example.com/handler.py")
To capture a single frame from a video you need to set the duration and the frames per second attributes to be 1. You can then get your required frame by setting the start position attribute.
from GrabzIt import GrabzItAnimationOptions from GrabzIt import GrabzItClient grabzIt = GrabzItClient.GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret") options = GrabzItAnimationOptions.GrabzItAnimationOptions() options.framesPerSecond = 1 options.duration = 1 options.start = 3 grabzIt.URLToAnimation("http://www.example.com/video.avi", options) # Then call the Save or SaveTo method grabzIt.SaveTo("result.gif")