django-embed-video 0.3

Django template tags for YouTube and Vimeo

Django app for easy embeding YouTube and Vimeo videos and music from SoundCloud.

Installation

pip install django-embed-video

or from sources

pip install git+https://github.com/yetty/django-embed-video.git

Add embed_video to INSTALLED_APPS in your Django settings.

Examples

Template examples

First you have to load the embed_video_tags template tags in your template:

{% load embed_video_tags %}

Simple embeding of video:

{% video item.video as my_video %}
    {{ my_video|embed:'small' }}
{% endvideo %}

Default sizes are tiny (420x315), small (480x360), medium (640x480), large (960x720) and huge (1280x960). You can set your own size:

{{ my_video|embed:'800x600' }}

Usage of variables:

{% video item.video as my_video %}
    URL: {{ my_video.url }}
    Thumbnail: {{ my_video.thumbnail }}
    Backend: {{ my_video.backend }}
{% endvideo %}

There is a simplier way, if you don’t need work with parameters as my_video.url or my_video.thumbnail and you want to use just embed tag.

{{ 'http://www.youtube.com/watch?v=guXyvo2FfLs'|embed:'large' }}

Model examples

Using the EmbedVideoField provides you validation of URLs.

from django.db import models
from embed_video.fields import EmbedVideoField

class Item(models.Model):
    video = EmbedVideoField()  # same like models.URLField()

Contributing

I will be really pleased if you will provide patch to this Django app. Feel free in changing source code, but please keep PEP8 rules and Zen.

TODO

• provide AdminEmbedVideoMixin

• Vimeo thumbnail

Changes

0.3

• Security fix: faked urls are treated as invalid. See this page for more details.

• Fixes:

  • allow of empty video field.

  • requirements in setup.py

• Added simplier way to embed video in one-line template tag:

  {{ 'http://www.youtube.com/watch?v=guXyvo2FfLs'|embed:'large' }}

• backend variable in video template tag.

  Usage:

  {% video item.video as my_video %}
      Backend: {{ my_video.backend }}
  {% endvideo %}

0.2

• Support of SoundCloud

0.1

• Initial release