vbarrielle / phototex

A generator for latex photo albums

phototex, a photo album generator built upon latex

If you need a simple photo album as a pdf that you can print, then phototex may be the right tool for you.

phototex strives to make photo album creation by being opinionated about the layout. Photos will be sorted by creation date and disposed to optimise page usage. A small amount of configuration is possible, but it it best to have knowledge of the layout algorithm to produce the best results. See the example folder for more insights.

Usage

$ phototex  source_images -o latex_album

Then send latex_album/photobook.pdf to your favorite print shop.

Command line help

USAGE:
    phototex [FLAGS] [OPTIONS] [FOLDER]

FLAGS:
    -h, --help                  Prints help information
        --strip-inner-covers    With this flag, a version without inner covers will also be generated. This can be the
                                required format for  some print shops.
    -V, --version               Prints version information
    -v                          Increase message verbosity.

OPTIONS:
        --dpm <DOTS_PER_MM>                      Desired print definition. Defaults to 12dpm (300dpi).
        --image_ext <IMAGE_EXT>                  Extension of images files. Defaults to 'jpg'
    -o, --output_folder <OUT_FOLDER>             Path where the latex should be written. Defaults to '.'.
        --page-format <PAGE_FORMAT>              Page format. Currently supported values: 'A4' (default)
        --page-orientation <PAGE_ORIENTATION>    Page orientation. Currently supported values: 'portrait' (default)
        --title <TITLE>                          Title of the album. Defaults to "".
        --title-font-size <TITLE_FONT_SIZE>      Font size for the title. Defaults to 42pt.
        --title-image-name <TITLE_IMAGE_NAME>    Name of the optional image for the title page (with ext).

ARGS:
    <FOLDER>    Path to the images selection folders.`

Status

Album creation works. A test with a print shop is in progress.

Planned features

In the future, phototex should come with subcommands and be able to incrementally build its state with subcommands such as:

• phototex import source_images
• phototex set-title 00_first_folder "My title"
• phototex set-one-portrait 00_first_folder 2019-04-11_21-33-02.jpg

Additionaly, at some point phototex should support more book formats, such as

• A4 landscape
• A5 portrait/landscape
• square book of various sizes