A web-based tool for generating PDF sheets of labels with ASN (Archive Serial Number) numbers and corresponding QR codes, designed to work with the paperless-ngx document management system. This tool helps you create labels that can be attached to physical documents before scanning, allowing paperless-ngx to automatically assign unique identifiers to your scanned documents.
Web version available at eikowagenknecht.com/asn-label-generator/
When you scan a document with a label generated by this tool, paperless-ngx will read the QR code and use the ASN number as the document's identifier. This creates a reliable link between your physical and digital documents, making it easier to:
- Track the relationship between physical and digital documents
- Quickly locate physical documents when needed
- Maintain a consistent naming scheme across your document management system
- Automate document processing workflows in paperless-ngx
The generated labels include both human-readable ASN numbers and QR codes.
- Generate exact number of labels or full pages (189 labels per A4 sheet)
- Configure starting number, digit length, and prefixes
- Resume printing on partially used sheets
- X/Y offsets, scaling, and debug borders for printer alignment
- Adjust margins between QR codes and text
- Processing happens in your browser
- Visit eikowagenknecht.com/asn-label-generator/
- Configure your labels
- Generate and download PDF
- Print on Avery L4731 compatible label sheets
While the web application is the easiest way to use this tool, a CLI version is also available for power users and automation scenarios.
The CLI provides all the same features as the web version.
Currently supports Avery L4731 labels with the following specifications:
- 7 columns × 27 rows on A4 paper
- Label size: 25.4mm × 10mm
- Gutter size: 2.5mm horizontal, 0mm vertical
- Page margins: 13.5mm top, 9mm left
These labels are chosen for their optimal size for document management - large enough to be easily readable but small enough to not obscure important document content.
Need support for a different label format? Please open an issue with the label specifications and I'll implement it for you.
Interested in contributing? Check out the used libraries and commands in the development guide:
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the terms of the MIT license.
Built with:
- Vite for build tooling
- jsPDF for PDF generation
- QRCode for QR code generation
- Zod for runtime validation
- React for the web interface
- Tailwind CSS for styling
- Commander.js for CLI parsing (CLI version)
If this project is not exactly what you're looking for, you might also be interested in the alternatives:
- tmiaier/asn-qr-code-label-generator
- A web-based version with less customization options
- entropia/paperless-asn-qr-codes
- A similar tool built with Python with support for more label formats but no custom prefixes or offsets
- aborelis/ASN-Label-Generator
- A similar tool built with Python with support for colored labels, based on gitolicious/averyasn based on timrprobocom/AveryLabels.py