Skip to main content

Simple video transcoding application for Django framework

Project description

django-video-transcoding

Simple video transcoding application for Django Framework

build codecov Updates PyPI version

Installation

System requirements

In case of latest Ubuntu LTS (20.04):

  1. ffmpeg-4.x
$> 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 && /data/dvt/virtualenv/bin/dmypy run -- \
   --config-file ../mypy.ini -p video_transcoding

TBD:

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

Production

Graceful shutdown

  • if you are running transcoder in docker, make sure that celery master process has pid 1 (docker will send SIGTERM to it by default)
  • when using separate celery app, send SIGUSR1 from master to workers to trigger soft shutdown handling (see video_transcoding.celery.send_term_to_children)

Project details


Download files

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

Source Distribution

django_video_transcoding-0.9.0.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

django_video_transcoding-0.9.0-py3-none-any.whl (19.0 kB view details)

Uploaded Python 3

File details

Details for the file django_video_transcoding-0.9.0.tar.gz.

File metadata

  • Download URL: django_video_transcoding-0.9.0.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for django_video_transcoding-0.9.0.tar.gz
Algorithm Hash digest
SHA256 4918fe12cf49f804d90e5fc505e4e253de582ca00719fee9edf0c812ebbaa49a
MD5 e15102c42d7e48f5636ebc83ce8729c7
BLAKE2b-256 cae7ecd91e4025eb9d5e94f862e4e21177d739e6e452d8b145a10708a2fecb82

See more details on using hashes here.

File details

Details for the file django_video_transcoding-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: django_video_transcoding-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 19.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for django_video_transcoding-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 75c43607708e5773aa8b3258c441c3c33130db67af91d9f3cdc72e494a35a209
MD5 0fe9761708c7dc6c6ccf960a5e4f9a48
BLAKE2b-256 5184c3694d703ac8fc3f00ef9bc9af66f7c8199194ada51622b58993cce31203

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page