photos2pdf/README.md
2024-03-24 01:27:15 +01:00

43 lines
1.0 KiB
Markdown

# photos2pdf - Create PDF from Series of Photos
## Description
Optimized for the processing of ad-hoc photos of flipcharts and whiteboards,
this converter utility scans a given directory for each file with the `.jpg`
filename extension, post-processes it (stretching contrast and trimming content
to the actual drawings. From the resulting pictures a PDF is generated, one
picture per page.
## Dependencies
This utility requires the following tools to be installed:
```shell
apt install imagemagick pdfjam qpdf
```
## Installation
```shell
git clone https://tk-sls.de/git/tk-sls.de/photos2pdf.git
cd photos2pdf
sudo make install
```
## Usage
Given a directory `some_directory` containing one or more JPEG pictures (the
filenames have to end with `.jpg`):
```shell
photos2pdf --result-filename output.pdf some_directory
```
The utility offers some options that control the aspects of the conversion;
use the `--help` option for usage instructions.
## Author and Copyright
©2023 Tilman Kranz <(t.kranz@tk-sls.de)[mailto:t.kranz@tk-sls.de]>