Simple helper utility to convert a video file to PDF image series
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.