Based on wagtailimages. The aim was to have feature parity with images but for html5 videos. Includes the ability to transcode videos to a html5 compliant codec using ffmpeg.
- Wagtail >= 4.0 (for older wagtail version see the tags)
- ffmpeg
Install using pypi
pip install wagtailvideos
Add wagtailvideos to your installed apps.
INSTALLED_APPS = [
'wagtailvideos',
]
Implement as a ForeignKey
relation, same as wagtailimages.
from django.db import models
from wagtail.admin.edit_handlers import FieldPanel
from wagtail.core.fields import RichTextField
from wagtail.core.models import Page
from wagtailvideos.edit_handlers import VideoChooserPanel
class HomePage(Page):
body = RichtextField()
header_video = models.ForeignKey('wagtailvideos.Video',
related_name='+',
null=True,
on_delete=models.SET_NULL)
content_panels = Page.content_panels + [
FieldPanel('body'),
VideoChooserPanel('header_video'),
]
A VideoChooserBlock is included
from wagtail.admin.edit_handlers import StreamFieldPanel
from wagtail.core.fields import StreamField
from wagtail.core.models import Page
from wagtailvideos.blocks import VideoChooserBlock
class ContentPage(Page):
body = StreamField([
('video', VideoChooserBlock()),
])
content_panels = Page.content_panels + [
StreamFieldPanel('body'),
]
The video template tag takes one required postitional argument, a video
field. All extra attributes are added to the surrounding <video>
tag. The original video and all extra transcodes are added as
<source>
tags.
{% load wagtailvideos_tags %}
{% video self.header_video autoplay controls width=256 %}
Jinja2 extensions are also included.
Using the video collection manager from the left hand menu. In the video editing section you can see the available transcodes and a form that can be used to create new transcodes. It is assumed that your compiled version of ffmpeg has the matching codec libraries required for the transcode.
Transcode can be disabled using the WAGTAIL_VIDEOS_DISABLE_TRANSCODE
setting.
# settings.py
WAGTAIL_VIDEOS_DISABLE_TRANSCODE = True
Same as Wagtail Images, a custom model can be used to replace the built in Video model using the
WAGTAILVIDEOS_VIDEO_MODEL
setting.
# settings.py
WAGTAILVIDEOS_VIDEO_MODEL = 'videos.AttributedVideo'
# app.videos.models
from django.db import models
from modelcluster.fields import ParentalKey
from wagtailvideos.models import AbstractVideo, AbstractVideoTranscode
class AttributedVideo(AbstractVideo):
attribution = models.TextField()
admin_form_fields = (
'title',
'attribution',
'file',
'collection',
'thumbnail',
'tags',
)
class CustomTranscode(AbstractVideoTranscode):
video = models.ForeignKey(AttributedVideo, related_name='transcodes', on_delete=models.CASCADE)
class Meta:
unique_together = (
('video', 'media_format')
)
# Only needed if you are using the text tracks feature
class CustomTrackListing(AbstractTrackListing):
video = models.OneToOneField(AttributedVideo, related_name='track_listing', on_delete=models.CASCADE)
class CustomVideoTrack(AbstractVideoTrack):
listing = ParentalKey(CustomTrackListing, related_name='tracks', on_delete=models.CASCADE)
To enable the uploading and displaying of VTT tracks (e.g. subtitles, captions) you'll need to add wagtail.contrib.modeladmin
to your installed apps.
Once added, there will be an new area in the admin for attaching VTT files to videos with associaled metadata.
- Some docs
- Richtext embed
- Transcoding via external service rather than ffmpeg