django-thumb is a simple Django app contains two models fields to generate images from videos and write on images.

• Quick Preview for VideoThumbnailField(thumbnail)

pip install django-thumb # try pip3 if it didn't work

1. Add "thumb" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = [
        ...
        'thumb',
    ]

   STATIC_ROOT = os.path.join(BASE_DIR, "static")
   MEDIA_ROOT = 'media'
   MEDIA_URL = '/media/'

	....
    from django.conf.urls.static import static
    from django.conf import settings

    urlpatterns = [
        ...
    ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

from thumb import ImageThumbnailField, VideoThumbnailField

• create the models:

in any app inside models.py file we will made these two models:

from django.db import models
from thumb import ImageThumbnailField, VideoThumbnailField

class Media(models.Model):
    video = models.FileField()
    # it's to be VideoThumbnailField(video_field_name="video") but "video" is the default
    thumbnail = VideoThumbnailField()


class MediaTwo(models.Model):
    thumbnail = ImageThumbnailField()

• now run the migrations in your terminal:

python manage.py makemigrations
python manage.py migrate

• add the models to your admin.py inside the same app to test it

from django.contrib import admin
from .models import Media, MediaTwo

admin.site.register(Media)
admin.site.register(MediaTwo)

• in the Model media we can choose cascade like human appear to caputre at or enter the time MM:SS or just choose random

• in the Model media two it's just one field thumbnail it's normal ImageField but you can add text to it

• you can add more cascade choices by adding yours in a folder in the your django project dir then add the xml cascade files their, after you've to add the choices in the settings.py :

CASCADE_DATA = (
    ('eyes', [os.path.join(BASE_DIR, "<your_cascades_folder>/haarcascade_eyes.xml")]),
    ('human with clear eyes', [os.path.join(BASE_DIR, "<your_cascades_folder>/haarcascade_frontalface.xml"),
                              os.path.join(BASE_DIR, "<your_cascades_folder>/haarcascade_eyes.xml")]),
)

• note: you can add more than 1 cascade in the same choice but the each one has to be inside the later like the eyes inside the face ..etc, but don't do it except you really need to because it'll slow down the save process

• by default each cascade has to be at least 0.3 of the hole width and height of the video frame, you can change it by add in the settings.py:

CASCADE_RATIO = {
		"width": <your_value_has_to_be_from_0_to_1>,
                 "height": <your_value_has_to_be_from_0_to_1>,
		 }

• note: if you've a choice with multi cascade like human with smile each cascade has to have this ratio to the later

• opencv in image processing and text writing
• jscolor in the color field