paperless-asn-qr-codes's Introduction

paperless-asn-qr-codes

paperless-asn-qr-codes is a command line utility for generating ASN labels for paperless with both a human-readable representation, as well as a QR code for machine consumption. The labels are Avery 4731 labels.

Installation

pip install paperless-asn-qr-codes

Usage

usage: paperless-asn-qr-codes [-h] [--format {averyL4731,avery5160,avery5161,avery5163,avery5167,avery5371}] [--border] start_asn output_file

CLI Tool for generating paperless ASN labels with QR codes

positional arguments:
  start_asn             The value of the first ASN
  output_file           The output file to write to (default: labels.pdf)

options:
  -h, --help            show this help message and exit
  --format {averyL4731,avery5160,avery5161,avery5163,avery5167,avery5371}, -f {averyL4731,avery5160,avery5161,avery5163,avery5167,avery5371}
  --border, -b          Display borders around labels, useful for debugging the printer alignment

Mandatory arguments

<start_asn>: The value of the first ASN to generate

Optional arguments

<output_file>: The name of the output file to write to (default: labels.pdf)

-h, --help: Shows the help message
-f, --format: Selects the format of the output sheet (see Supported Sheets)
-b, --border: Generates the borders around the labels to help debug alignment issues (see Tips & Tricks)

Supported Sheets

Some different sheet types are supported with the -f/--format argument, however, not all are tested.

The default is Avery L4731.

Currently tested and known working are:

Avery L4731 (DIN A4 Labels)

Tips & Tricks

In case your printer has alignment issues, you can generate a PDF with borders around the labels by using the -b/--border option.

License

paperless-asn-qr-codes is distributed under the terms of the GPL-3.0 license.

paperless-asn-qr-codes's People

Contributors

Stargazers

Watchers

paperless-asn-qr-codes's Issues

Allow generating multiple pages

Can also be done via the Avery Webpage

Not a real issue ticket, just as a FYI

For everyone who do not want to do this via pip or something like this, I figured out that this is also possible to do with the vendor label creator on https://avery.eu/print
I am not related to this company!

Rewrite this in rust

For performance reasons it might be sensible to rewrite this tool in Rust. The following libraries might be helpful:

Render issue with horizontal gutters

All of the sample labels are Avery brand, where there are no horizontal gutters (each label touches the one above/below it). So it was not obvious that there is a rendering bug.

What happens is if you set a horizontal gutter, it will allocate space above the first label. Thus, it artificially inflates the top margin.

For example, this was the settings I used for these labels (https://www.amazon.com/dp/B014IPO0US):

    "royalgreen1660": LabelInfo(
        labels_horizontal=7,
        labels_vertical=22,
        label_size=(25.4 * mm, 9.52 * mm),
        gutter_size=(2.5 * mm, 2.5 * mm),
        margin=(11.55 * mm, (8.73 - 2.5) * mm),
        pagesize=LETTER,
    ),

Note that I had to do 8.73 - 2.5 (subtract out the horizontal gutter height) to get it right.

entropia / paperless-asn-qr-codes Goto Github PK