Skip to content

sco1/vid2pdf

Repository files navigation

vid2pdf

PyPI - Python Version PyPI PyPI - License pre-commit.ci status

Convert a video file into 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.

The path to an existing ffmpeg installation can also be specified using an FFMPEG_PATH environment variable, either directly or by utilizing a .env file in this project's root.

Installation

Python

Install from PyPi with your favorite pip invocation:

$ pip install vid2pdf

You can confirm proper installation via the vid2pdf CLI:

$ vid2pdf --help
Usage: vid2pdf [OPTIONS] [SOURCE]

  Convert a video file to PDF image series.

  If an input video is not specified, a file selection dialog will be opened
  to select the file to process.

  Start and end arguments may be left empty to use the start and end of the
  video, respectively.

Arguments:
  [SOURCE]  Source video

Options:
  --dest DIRECTORY  Destination directory
  -s, --start TEXT  Start time (hh:mm:ss.sss)
  -e, --end TEXT    End time (hh:mm:ss.sss)
  --help            Show this message and exit.

Standalone

Standalone distribution using Nuitka is tested by this package. Due to the likelihood of false positives by AV scanners, prebuilt releases are not currently provided.

Note that Nuitka is provided as an optional dependency and can be installed by specifying the build dependency group when installing this project.

Currently tested packaging paths are:

  • python -m nuitka ./vid2pdf/vid2pdf.py --mode=standalone --enable-plugin=tk-inter
  • python -m nuitka ./vid2pdf/vid2pdf.py --mode=onefile --enable-plugin=tk-inter

For an alternative standalone option, I also maintain a UI-based Flutter version of vid2pdf at sco1/vid2pdf-flutter

About

Convert a video into a PDF series of stills

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Contributors

Languages