https://github.com/just-work/django-video-transcoding

Simple video transcoding application for Django Framework
https://github.com/just-work/django-video-transcoding

Last synced: about 1 month ago
JSON representation

Simple video transcoding application for Django Framework

• Host: GitHub
• URL: https://github.com/just-work/django-video-transcoding
• Owner: just-work
• License: mit
• Created: 2020-02-07T13:58:22.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-23T03:40:54.000Z (7 months ago)
• Last Synced: 2024-05-23T04:54:32.303Z (7 months ago)
• Language: Python
• Size: 345 KB
• Stars: 23
• Watchers: 6
• Forks: 9
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-video - just-work/django-video-transcoding - Simple video transcoding application for Django Framework - just-work/django-video-transcoding (Encoding / Talks Presentations Podcasts)

README

        
# django-video-transcoding

Simple video transcoding application for Django Framework

[![build](https://github.com/just-work/django-video-transcoding/workflows/build/badge.svg?branch=master)](https://github.com/just-work/django-video-transcoding/actions?query=event%3Apush+branch%3Amaster+workflow%3Abuild)

[![codecov](https://codecov.io/gh/just-work/django-video-transcoding/branch/master/graph/badge.svg)](https://codecov.io/gh/just-work/django-video-transcoding)

[![Updates](https://pyup.io/repos/github/just-work/django-video-transcoding/shield.svg)](https://pyup.io/repos/github/just-work/django-video-transcoding/)

[![PyPI version](https://badge.fury.io/py/django-video-transcoding.svg)](http://badge.fury.io/py/django-video-transcoding)

[![Documentation Status](https://readthedocs.org/projects/django-video-transcoding/badge/?version=latest)](https://django-video-transcoding.readthedocs.io/en/latest/?badge=latest)

## Installation

### System requirements

In case of latest Ubuntu LTS (20.04):

1. ffmpeg-4.x

  ```shell script

  $> sudo apt install ffmpeg

  ```

2. mediainfo

  ```shell script

  $> sudo apt install mediainfo 

  ```

3. RabbitMQ

  ```shell script

  $> sudo apt install rabbitmq-server

```

### django-video-transcoding

```shell script

pip install django-video-transcoding

```

### Configure Django

Edit your project `settings.py`

```python

INSTALLED_APPS.append('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

```shell script

$> celery worker -A video_transcoding.celery

```

## Develop

[Development environment quickstart guide](/docs/source/quickstart.md)

### 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:

* [x] travis-ci

* [ ] sphinx docs - autodoc + manual

* [x] coverage

* [x] typing

* [x] badges

* [x] 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`)