vid2pdf

Simple helper utility to convert a video file to PDF image series

External Requirements

vid2pdf requires ffmpeg to be extracted to the /utils/ffmpeg folder. The latest version of ffmpeg can be downloaded from ffmpeg.org. Existing local ffmpeg installations are not currently supported.

If not using a precompiled build, Python must be installed on your local machine. You can download the latest version of Python for your OS from python.org

Installation

This project utilizes poetry for dependency & environment management. Clone or download this repository to your local machine and create a new environment:

$ cd <project_dir>
$ poetry install

Though it's recommended to utilize poetry, the project may also be installed via pip:

$ cd <project_dir>
$ pip install .

Alternatively, prebuilt binaries are provided at https://github.com/sco1/vid2pdf/releases

Usage

vid2pdf can be invoked using Python:

$ python vid2pdf.py

Or, if a prebuilt binary is present, this may be called directly

$ vid2pdf.exe

Input Parameters

Unless otherwise noted, all input parameters are prompted in the CLI

input_video

The default behavior is to open a GUI dialog for the user to specify a the input video file. An optional -cli flag may be passed to bypass this GUI and instead prompt for the video file path in the CLI.

output_dir

PDF output directory. If this value is not specified, this defaults to the parent directory of the input video.

start_time

Video start time for capture, as hh:mm:ss.sss. If this value is not specified, the beginning of the video is used.

end_time

Video end time for capture, as hh:mm:ss.sss. If this value is not specified, the end of the video is used.

Examples

$ python vid2pdf.py
Enter the output directory path [X:\vid2pdf\test]:
Enter start time (hh:mm:ss.sss). Leave blank to use the video start:
Enter end time (hh:mm:ss.sss). Leave blank to use the video end: 00:00:01.000
<ffmpeg output snipped>
Loading 30 frames...
100%|███████████████████████████████████████| 29/29 [00:00<00:00, 852.82it/s]
Generating PDF ... done

$ python vid2pdf.py -cli
Enter the video file path: X:\vid2pdf\test\test_video.mp4
Enter the output directory path [X:\vid2pdf\test]:
Enter start time (hh:mm:ss.sss). Leave blank to use the video start:
Enter end time (hh:mm:ss.sss). Leave blank to use the video end: 00:00:01.000
<ffmpeg output snipped>
Loading 30 frames...
100%|███████████████████████████████████████| 29/29 [00:00<00:00, 852.82it/s]
Generating PDF ... done