django-video-transcoding

Simple video transcoding application for Django framework


License
MIT
Install
pip install django-video-transcoding==0.0.10

Documentation

django-video-transcoding

Simple video transcoding application for Django Framework

Build Status codecov Updates

Installation

System requirements

In case of latest Ubuntu LTS (18.04):

  1. ffmpeg-4.0
$> sudo add-apt-repository ppa:jonathonf/ffmpeg-4
$> sudo apt install ffmpeg
  1. mediainfo
$> sudo apt install mediainfo 
  1. RabbitMQ
$> sudo apt install rabbitmq-server

django-video-transcoding

pip install django-video-transcoding

Configure Django

Edit your project settings.py

INSTALLED_APPS += ['video_transcoding']

Env

Common env variables used in django web server and celery

DJANGO_SETTINGS_MODULE=YOUR_PROJECT.settings
VIDEO_TRANSCODING_CELERY_BROKER_URL=amqp://guest:guest@rabbitmq:15672/

Web-server-only env variables:

VIDEO_DOWNLOAD_SOURCE=0
VIDEO_EDGES='http://edge-1.localhost,http://edge-2.localhost'

Celery-only env variables:

VIDEO_TEMP_DIR=/tmp
VIDEO_TRANSCODING_CELERY_CONCURRENCY=2
VIDEO_ORIGINS='http://origin-1.localhost/video,http://origin-2.localhost/video'

Start celery worker

$> celery worker -A video_transcoding.celery

Demo project

Run admin, storage and celery worker

docker-compose up

Transcode something

  • curl -T cat.mp4 http://storage.localhost:8080/videos/sources/cat.mp4
  • Create new video with link above
  • Wait till video will change status to DONE.
  • On video change form admin page there is a sample video player.

Develop

Tests

src/manage.py test

Type checking

$> pip install mypy django-stubs
$> cd src && mypy --config-file=../mypy.ini video_transcoding

TBD:

  • travis-ci
  • sphinx docs - autodoc + manual
  • coverage
  • typing
  • badges
  • video hosting demo project with docker-compose, nginx and player demo