This project is a web-based QR code label generator specifically designed for generating Archive Serial Number (ASN) labels in Paperless-ngx. It's a simple and efficient tool aimed at streamlining the process of creating QR code labels for document management.
A live version of this application can be accessed at https://tobiasmaier.info/asn-qr-code-label-generator/.
This application is currently in an early alpha stage and has not been extensively tested. Users are encouraged to validate the output, especially the positioning of the labels.
The application currently supports the following label formats:
The application currently has the following limitations:
- The application is currently only available in English. This is considered a non-issue, as the application is designed to be self-explanatory.
- The application currently only supports the Avery L4731REV-25 label format. Contributions for additional label formats are welcome.
- The application only supports Google Chrome and Chromium-based browsers, such as Microsoft Edge. And partially Firefox.
This limitation is due to the use of the CSS
@pagerule for printing. Contributions for additional browser support are welcome.
-
Browser-Based Application: The application is designed to run entirely on the client side, avoiding the need for server-side logic. This approach simplifies deployment and reduces hosting requirements.
-
Simple Technology Stack: The application is built using TailwindCSS and AlpineJS. TailwindCSS provides utility-first CSS classes for styling, while AlpineJS offers reactive and declarative JavaScript for handling interactivity. This combination results in a comparatively lightweight and maintainable codebase.
Contributions to this project are welcome. If you have ideas for improvements or have found bugs, please feel free to contribute. You can submit your contributions via GitHub at https://github.com/tmaier/asn-qr-code-label-generator.
This project has been made possible with the support and sponsorship of BauCloud GmbH.
Special thanks to Marvin Gaube for the insightful blog post "paperless-ngx with qr codes as ASN: My Workflow". His workflow greatly inspired the development of this application.
Additionally, this project drew inspiration from the CLI tool paperless-asn-qr-codes developed by Jan Christian Grünhage. His work follows the same goal of streamlining the process of creating ASN labels for paperless-ng, but uses a different approach.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
All rights reserved by Tobias L. Maier.