plasn

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 10 Open GitHub ↗

Browser-based ASN label and separator sheet generator for Paperless-ngx

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>
  <img src="public/plasn-mark.svg" alt="Plasn logo" width="120" align="left" />
  <span>Plasn</span>
</h1>

Plasn is a lightweight web app for generating:

- ASN label sheets for Paperless-ngx
- separator sheets for barcode-based document splitting
- overlay test sheets for label alignment on plain paper

The app runs fully client-side in the browser. No backend is required.

## Live app

- [https://plasn.getathome.dedyn.io](https://plasn.getathome.dedyn.io)

## What Plasn does

Plasn is built for Paperless-ngx users who want to:

- print ASN QR label sheets
- create barcode separator sheets for document splitting
- calibrate label output without wasting real label stock

Everything runs locally in the browser after the app has loaded. The server only delivers static files.

## Features

- ASN QR label generator with multiple A4 presets and custom label geometry
- Separate calibration profiles per label preset
- PDF download and direct printing
- Separator sheet mode using Code 128 barcodes
- Overlay test sheet PDF for alignment on plain paper
- German and English UI

## Quick start

1. Open the live app.
2. Choose your label preset or switch to separator sheets.
3. Configure the values you need.
4. Export a PDF or print directly.
5. For label sheets, use the overlay test sheet first if your printer needs calibration.

## Print example

This example shows Avery Zweckform L4731 labels printed with the default preset values.
The text options `Show prefix in text` and `Show leading zeros in text` were disabled.
The QR code still keeps the full ASN value with prefix and leading zeros; only the visible label text was reduced.

## Paperless-ngx configuration

You can configure these values either via environment variables or directly in the Paperless-ngx UI under Configuration. If the same option is set in the UI, the UI value takes precedence over the environment variable. The examples below are for env-based setups such as Docker, Compose, or Unraid container settings.

### ASN labels

```env
PAPERLESS_CONSUMER_ENABLE_ASN_BARCODE=true
```

Optional if you use a different ASN prefix and for broader barcode handling or more robust detection:

```env
PAPERLESS_CONSUMER_ASN_BARCODE_PREFIX=YOUR_PREFIX
PAPERLESS_CONSUMER_ENABLE_BARCODES=true
PAPERLESS_CONSUMER_BARCODE_SCANNER=ZXING
PAPERLESS_CONSUMER_BARCODE_DPI=600
PAPERLESS_CONSUMER_BARCODE_UPSCALE=1.5
```

### Separator sheets

```env
PAPERLESS_CONSUMER_ENABLE_BARCODES=true
```

Optional if you use a different separator string or want more robust barcode detection:

```env
PAPERLESS_CONSUMER_BARCODE_STRING=YOUR_SEPARATOR
PAPERLESS_CONSUMER_BARCODE_SCANNER=ZXING
PAPERLESS_CONSUMER_BARCODE_DPI=600
PAPERLESS_CONSUMER_BARCODE_UPSCALE=1.5
```

## Public container image

Plasn is also available as a public container image for self-hosted and offline-friendly deployments:

```bash
docker pull ghcr.io/peterthepeter/plasn-public:latest
docker run --rm -p 8080:80 ghcr.io/peterthepeter/plasn-public:latest
```

After the container starts, open `http://localhost:8080`.

The `plasn-public` image is intended as the generic public build:

- it serves the app as a small static web container
- it bundles the UI and print fonts locally inside the image
- it does not require external runtime requests for fonts or analytics
- it avoids site-specific search engine metadata so it can be reused in company and on-prem environments

## Feedback

If you run into a bug or have an idea for an improvement, please open a GitHub issue.

Useful bug reports usually include:

- what you wanted to generate
- which preset or mode you used
- what happened instead
- browser and device details
- screenshots or sample output if helpful

## License

Plasn is licensed under the GNU Affero General Public License v3.0 only (`AGPL-3.0-only`).

Built with the help of OpenAI Codex.

plasn

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README