skip to navigation
skip to content

vecc 0.8

Video Embed Code Cleaner

Latest Version: 1.2

Cleans and updates your video’s embed code.

Over time, the embed codes used for videos from various providers have changed and evolved, to make them more and more compatible with a broader set of devices.

This is where vecc is useful: it detects the video provider and id from a given embed code, and provides various utilities to clean this code and validate that the video is still available.


Either use pip, which is the easiest way:

$ pip install vecc

Either download the tarball from, untar it, and install it manually:

$ python install


$ vecc -h
usage: vecc [-h] [--version] {clean,validate} ...

Video Embed Code Cleaner.

optional arguments:
  -h, --help        show this help message and exit
  --version         show program's version number and exit

    clean           clean the embed code
    validate        validate that the video is still available


  • clean: takes a video embed code, and returns the video id, provider, and new embed code. Takes an optional -v|--validate parameter, to check if the video is still available.
  • validate: takes a video id and provider, and check if it’s still available.


$ vecc clean '<object width="480" height="381"><param name="movie" value=""></param><param name="allowFullScreen" value="true"></param><param name="allowScriptAccess" value="always"></param><embed src="" type="application/x-shockwave-flash" width="480" height="381" allowFullScreen="true" allowScriptAccess="always"></embed></object>' -v
video id: k6Lg9UXest3kho5p9X
provider: dailymotion
embed code: <iframe frameborder="0" width="480" height="270" src=""></iframe>
This video is still valid


Video providers (Google video, Youtube, Vimeo, Dailymotion…) are configured in the vecc/ file.

Each provider configuration consists of:

  • name: youtube
  • link template: string template (that’ll be interpolated with format) used to build the cleaned code. This is the link to the embedded video player. Needs the {video_id} tag.
  • embed template: string template used to build the new embed code. Needs the {video_link} tag.
  • validation template: string template used to build the link used to validate that the video is still available. This is the link to the video itself (as seen on the provider’s website). Needs the {video_id} tag.
  • matches: regular expressions used to “match” a video embed code to a video provider. Must capture the video id.


  • v0.8:
    • compatible python 2.6 to python 3.3
    • 100% test coverage
  • v0.7:
    • dropped allowfullscreen
    • added autoPlay=1&related=0 on video links
  • v0.6:
    • video size of the cleaned embed code is now 480x395
    • all embed codes with iframes use the same format with allowfullscreen=”true”, autoPlay=”1”, related=”0”
  • v0.5:
    • compatibility with python2.6: argparse as a dependency
  • v0.4:
    • compatibility with python2.6: format needs field numbers
File Type Py Version Uploaded on Size
vecc-0.8-py2.py3-none-any.whl (md5) Python Wheel 3.3 2013-11-14 8KB
vecc-0.8.tar.gz (md5) Source 2013-04-01 6KB