Metadata-Version: 1.2
Name: thumb_gen
Version: 1.0.3
Summary: Python application that can be used to generate video thumbnail for mp4 and mkv file types.
Home-page: https://github.com/truethari/thumb-gen
Author: tharindu.dev
Author-email: tharindu.nm@yahoo.com
License: MIT
Project-URL: Bug Tracker, https://github.com/truethari/thumb-gen/issues
Description: ===================
        Thumbnail Generator
        ===================
        
        .. image:: https://github.com/truethari/thumb-gen/actions/workflows/thumb-gen.yml/badge.svg
           :target: https://github.com/truethari/thumb-gen/actions/workflows/thumb-gen.yml
        .. image:: https://app.codacy.com/project/badge/Grade/01b66feeb94743ac80e413e4e9075595
           :target: https://www.codacy.com/gh/truethari/thumb-gen/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=truethari/thumb-gen&amp;utm_campaign=Badge_Grade
        
        -------------
        What is This?
        -------------
        
        This is a Python application that can be used to generate video thumbnail for mp4 and mkv file types.
        
        .. image:: https://i.imgur.com/CXJbxUl.png
           :target: https://github.com/truethari/thumb-gen
        
        ------------
        Installation
        ------------
        
        You can use pip:
        
        .. code-block:: bash
        
           ~$ pip3 install thumb-gen
        
        --------------
        Configurations
        --------------
        
        (These may change during the update)
        
        - The number of screen images that should be included in the final thumbnail image.
        
        - Thumbnail image quality
        
        - Font type in the video info panel. You can add a file path of a font file (.ttf) to this.
        
        - Font size in the video info panel
        
        - Custom text in the video info panel
        
        Download font files : `FontSquirrel <https://www.fontsquirrel.com/>`_
        
        .. code-block:: bash
        
           ~$ thumb-gen -c
        
        or
        
        .. code-block:: bash
        
           ~$ thumb-gen --config
        
        By program default:
        
        .. code-block:: ini
        
           IMAGES = 12
           IMAGE_QUALITY = 80
           FONT = 
           FONT_SIZE = 30
           CUSTOM_TEXT = 
        
        -----
        Usage 
        -----
        
        Usage options:
        ==============
        
        .. code-block::
        
           -h, --help      show this help message and exit
        
           -c, --config    configurations
        
           -v, --version   show program's version number and exit
        
           -f, --file      input a single video
        
           -d, --dir       input videos from a directory
        
        Console
        ========
        
        .. code-block:: bash
        
           ~$ thumb-gen -h
           ~$ thumb-gen --help
        
           ~$ thumb-gen -c
           ~$ thumb-gen --config
        
           ~$ thumb-gen -v
           ~$ thumb-gen --version
        
           ~$ thumb-gen -f input.mp4
           ~$ thumb-gen --file input.mp4
           ~$ thumb-gen --file "d:/videos/input.mp4"
        
           ~$ thumb-gen -d videos
           ~$ thumb-gen --dir videos
           ~$ thumb-gen --dir "d:/videos"
        
        Python
        ======
        
        - If you don't set an output folder, thumbnail images will be saved in the video folder (video_path).
        
        - If you don't need a custom text and custom font file (including font size) and you have already set these for the configuration file (using console or defaults), it will be added automatically. To avoid this set the `custom_text` value to `False` and add a custom font file location.
        
        Example 1
        
        .. code-block:: Python
        
           from thumb_gen.worker import Generator
        
           #video_path, output_path='', custom_text=True
           app = Generator("C:/input/video.mp4", "C:/output/", "www.example.com")
           app.run()
        
        Example 2
        
        .. code-block:: Python
        
           import os
           from thumb_gen.worker import Generator
           
           folder = 'C:/input'
           for video in os.listdir(folder):
               if video.endswith('.mp4') or video.endswith('.mkv'):
                   app = Generator(os.path.join(folder, video), custom_text=False)
                   app.run()
        
Keywords: thumbnails video screenshot
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
