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.
Source Distribution
Built Distribution
File details
Details for the file vid2pdf-1.1.0.tar.gz
.
File metadata
- Download URL: vid2pdf-1.1.0.tar.gz
- Upload date:
- Size: 4.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.10 CPython/3.9.5 Windows/10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1b998b0b2e1cf1306ebfebaecc575a63c04f03bb9a7820b444ba2ee39495ceae |
|
MD5 | e650216c53454a8552d4851f1123efb0 |
|
BLAKE2b-256 | 60a66ac6dd02ac58c9af3ea128aa9c9d882a2d2973a34460cd34269ae7cbef28 |
File details
Details for the file vid2pdf-1.1.0-py3-none-any.whl
.
File metadata
- Download URL: vid2pdf-1.1.0-py3-none-any.whl
- Upload date:
- Size: 4.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.10 CPython/3.9.5 Windows/10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a3997ad6c296ed83aa60aebc75e62125647d4fe359a2b3332e19f1c0742cf80a |
|
MD5 | bff17f908b81925553f955ab794d5054 |
|
BLAKE2b-256 | aefc89cc63f5c4b5f19e01c6dc2441ed135ed5ece0792895dec32dd595d84139 |