Skip to main content

Youtube API wrapper app for Django. It helps to upload, display, delete, update videos from Youtube

Project description

Django Youtube

Django Youtube is a wrapper django app around youtube api. It helps you to implement the frequent api operation easily.

The main functionality is to use Youtube API to upload uplisted videos and show them in the website as a social web site do.
Basically implementing video features on a website using Youtube. In order to achieve this goal, you need a developer account on Youtube and use them to authenticate, and upload videos into this account.

Django Youtube designed to work with built in 'contrib.auth' app, although you can modify the to work without authentication.

Please feel free to contribute.


1. Retrieve specific videos
2. Retrieve feed by a user
3. Browser based upload
4. Authentication to reach private data
5. Admin panel ready
6. Supports i18n

Features are not yet implemented

1. Retrieve feeds (most visited etc)
2. Direct upload
3. oAuth authentication


gdata python library (


Add 'django_youtube' folder at your Python path.

Add 'django_youtube' to your installed apps

Add following lines to your and edit them accordingly

YOUTUBE_AUTH_PASSWORD = 'yourpassword'
YOUTUBE_DEVELOPER_KEY = 'developer key, get one from'
YOUTUBE_CLIENT_ID = 'client-id'

Optionally you can add following lines to your settings. If you don't set them, default settings will be used.

# url to redirect after upload finishes, default is respected 'video' page
YOUTUBE_UPLOAD_REDIRECT_URL = '/youtube/videos/'

# url to redirect after deletion video, default is 'upload page'

Add Following lines to your file

(r'^youtube/', include('django_youtube.urls')),

Don't forget to run ' syncdb'


Go to '/youtube/upload/' to upload video files directly to youtube. When you upload a file, the video entry is created on youtube, 'Video' model that includes video details (video_id, title, etc.) created on your db and a signal sent that you can add your logic to it.
After successful upload, it redirects to the specified page at YOUTUBE_UPLOAD_REDIRECT_URL, if no page is specified, it redirects to the corresponding video page.

Youtube API is integrated to the 'Video' model. In order to change information of the video on Youtube, just save the model instance as you normally do, django_youtube will do the necessary changes using Youtube API.

Api methods can be used separately. Please see '' to get info about methods. Please note that some operations requires authentication. Api methods will not do more than one operation, i.e. will not call authenticate method. So you will need to authenticate manually. Otherwise api methods will raise 'OperationError'. Please see '' for a sample implementation.

You can use views for uploading, displaying, deleting the videos.

You can also override templates to customise the html. 'Iframe API' used for displaying the videos for convenience. Please see Youtube API Docs ( to implement other player API's on your template files. Other options are 'Javascript API' and 'Flash API'.


The 'video_created' sent after video upload finished and video created successfully. You can also choose to register 'post_save' event of 'Video' model
Following is an example of how you process the signal

from django_youtube.models import video_created
from django.dispatch import receiver

def video_created_callback(sender, **kwargs):
Youtube Video is created.
Not it's time to do something about it

Project details

Release history Release notifications

History Node


This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-youtube-0.1.tar.gz (10.8 kB) Copy SHA256 hash SHA256 Source None Sep 8, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page