Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Django app for easy embeding YouTube and Vimeo videos and music from SoundCloud.
Python HTML
branch: master



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


Documentation is here:

Quick start

  1. Install django-embed-video:

    pip install django-embed-video

    or from sources

    pip install git+
  2. Add embed_video to INSTALLED_APPS in your Django settings.

  3. If you want to detect HTTP/S in template tags, you have to set request context processor in settings.TEMPLATE_CONTEXT_PROCESSORS:

  4. Usage of template tags:

    {% load embed_video_tags %}
    The video tag:
    {% video as my_video %}
      URL: {{ my_video.url }}
      Thumbnail: {{ my_video.thumbnail }}
      Backend: {{ my_video.backend }}
      {% video my_video "large" %}
    {% endvideo %}
    Or embed shortcut:
    {% video my_video '800x600' %}
  5. Usage of model fields

    from django.db import models
    from embed_video.fields import EmbedVideoField
    class Item(models.Model):
        video = EmbedVideoField()  # same like models.URLField()
Something went wrong with that request. Please try again.