AxonByteDev/paperless-asn-label-generator
1
0
Fork 0
mirror of https://github.com/AxonByteDev/paperless-asn-label-generator.git synced 2026-08-06 08:42:03 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
paperless-asn-label-generator/README.md
MrLetsPlay4Fun 904384227b Add screenshot to README
2026-02-03 17:59:31 +01:00

4.7 KiB
Raw Blame History

paperless-ngx ASN Label Generator (GUI) – Avery L4731 / L4731REV

Kleines Desktop-GUI-Tool (Tkinter), das ASN-Labels als PDF erzeugt – wahlweise QR oder Code128 – speziell für A4-Etikettenbögen (z.B. Avery Zweckform L4731 / L4731REV, 7×27).

✅ Ideal, um in paperless-ngx sauber mit ASN-Barcodes zu arbeiten
✅ Mit Kalibrierung (Offset X/Y + Pitch-Drift) für exakte Druckausrichtung
✅ Persistente Einstellungen: Drucker-Kalibrierwerte werden automatisch gespeichert
✅ Reset-Button: “Config löschen” setzt alles auf Standardwerte zurück

Hinweis: Inoffizielles Tool, nicht affiliated mit paperless-ngx.

Screenshot der Anwendung

Voraussetzungen

  • Python 3.10+
  • Optional: Git (nur wenn Installation direkt von GitHub erfolgt)
  • Linux: python3-tk (Tkinter GUI Paket)

Installation & Start

Wichtig (Linux): Viele Distributionen blockieren systemweite pip3 install ... Installationen (PEP 668).
Nutze dort am besten pipx oder eine virtuelle Umgebung.

Windows

Empfohlen: pipx (sauber, isoliert)

  1. Python installieren (bei python.org) und „Add Python to PATH“ aktivieren.
  2. pipx installieren:
python -m pip install --upgrade pip
python -m pip install pipx
python -m pipx ensurepath

Terminal neu öffnen.

  1. Installieren & starten:
pipx install git+https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git
paperless-asn-labels

Alternative: Virtualenv

python -m venv .venv
.venv\Scripts\activate
pip install git+https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git
paperless-asn-labels

macOS

Empfohlen: pipx

  1. (Optional) Python via Homebrew:
brew install python
  1. pipx installieren:
python3 -m pip install --upgrade pip
python3 -m pip install pipx
python3 -m pipx ensurepath

Terminal neu öffnen.

  1. Installieren & starten:
pipx install git+https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git
paperless-asn-labels

Linux (Debian/Ubuntu/Pop!_OS)

1) Tkinter installieren (GUI)

sudo apt update
sudo apt install -y python3-tk

2) Empfohlen: pipx installieren

sudo apt install -y pipx
pipx ensurepath

Terminal neu öffnen.

3) Installieren & starten (GitHub)

pipx install git+https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git
paperless-asn-labels

Alternative: Virtuelle Umgebung (wenn du pipx nicht willst)

python3 -m venv ~/.venvs/paperless-asn
source ~/.venvs/paperless-asn/bin/activate
pip install --upgrade pip
pip install git+https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git
paperless-asn-labels

Update

Wenn mit pipx installiert

pipx upgrade paperless-asn-labels

Falls das Paket unter pipx anders heißt:

pipx upgrade-all

Wenn in einer venv installiert

pip install -U --force-reinstall git+https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git

Nutzung

  • Start-Nummer wählen (z.B. 1 oder 190)
  • Prefix setzen (muss zu paperless-ngx passen)
  • Führende Nullen einstellen (z.B. 7 → ASN0000001)
  • Menge als Labels oder A4-Blätter
  • Code-Typ: QR oder CODE128
  • Optional: Rahmen aktivieren (hilft beim Kalibrieren)
  • „PDF erzeugen…“ → Datei speichern

Gespeicherte Einstellungen (Config)

Deine Kalibrierwerte & UI-Einstellungen werden automatisch gespeichert (persistente Config).
Der Speicherort ist:

  • Linux: ~/.config/paperless-ngx-asn-labels/config.json (oder $XDG_CONFIG_HOME/...)
  • macOS: ~/Library/Application Support/paperless-ngx-asn-labels/config.json
  • Windows: %APPDATA%\paperless-ngx-asn-labels\config.json

Im Programm gibt es außerdem den Button „Config löschen“, der die Datei entfernt und auf Standardwerte zurücksetzt.

Prefix in paperless-ngx

Der Prefix muss zu deiner paperless-ngx Einstellung passen:

  • PAPERLESS_CONSUMER_ASN_BARCODE_PREFIX

Beispiel: Wenn du in paperless-ngx ASN nutzt, dann hier auch ASN.

Druck-Hinweis (sehr wichtig)

Bitte im PDF-Viewer/Printer 100% drucken:

  • kein „An Seite anpassen“
  • kein „Skalieren“
  • kein „Fit to Page“

Wenn die Position nicht exakt passt:

  • Rahmen aktivieren
  • Offset X/Y und Pitch-Δ anpassen

Entwicklung (Repo klonen & lokal starten)

git clone https://github.com/MrLetsPlay4Fun/paperless-asn-label-generator.git
cd paperless-asn-label-generator

python3 -m venv .venv
source .venv/bin/activate

pip install -e .
paperless-asn-labels

Lizenz

GNU AGPLv3 (siehe LICENSE)