Skip to content

A tool for generating printable grids of images while minimizing the unused space left on the paper

License

Notifications You must be signed in to change notification settings

elliotcubit/sticky

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sticky

A tool for creating sticker sheets for printing.

Features

  • Targets any paper size available in standard_paper_sizes
  • Supports arbitrary size specified in millimeters
  • Images can be resized to reduce leftover space
    • Horizontal waste is minimized while preserving the aspect ratio of the subject
    • Stretching can be enabled to minimize the horizontal and vertical space
  • Specifiy the maximum percentage the input may be resized by
  • Printing at arbitrary DPI

Usage

Usage: sticky [OPTIONS] --input-file <INPUT_FILE> <COMMAND>

Commands:
  standard  Choose a standard size (e.g. us-letter) for the output paper
  manual    Manually choose a size in millimeters for the output paper
  help      Print this message or the help of the given subcommand(s)

Options:
  -i, --input-file <INPUT_FILE>      The source file to print
  -o, --output-file <OUTPUT_FILE>    The file to write the output to [default: out.pdf]
  -d, --dpi <DPI>                    The DPI of the output file. Only change this if you know what you're doing [default: 300]
      --resize                       Resize the input to minimize the amount of wasted space
      --allow-stretching             When true, stretch the image in order to better fill space
      --resize-limit <RESIZE_LIMIT>  Maximum percentage to resize by [default: 10]
  -h, --help                         Print help

Demo

Preparing this sticker for printing on A4 paper looks like this:

demo

./sticky --input-file sticker.png standard iso-a4

demo

Adding --resize will change the width of the image from 512 to 495 so that it packs nicely on the paper

./sticky --input-file sticker.png --resize standard iso-a4

demo

Doing this same action on us-letter paper would leave behind wasted space in the vertical margins

./sticky --input-file sticker.png --resize standard us-letter

demo

This can be solved with --allow-stretching, but he aspect ratio of the sticker will not be preserved

./sticky --input-file sticker.png --resize --allow-stretching standard us-letter

demo

License

GPLv3

About

A tool for generating printable grids of images while minimizing the unused space left on the paper

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages