Language:DeutschEnglishFrançais Italiano Last updated: 2026-08-18

QR code upload¶

With the QR code upload, files can be uploaded directly from a smartphone to an archival object – without having to log in on the mobile device.

Use cases¶

On site in the archive: quickly take photographs of documents or objects and assign them directly to the right object
Teamwork: share the QR code so that colleagues can upload files to an object
External staff: temporary upload access without an Anton account

Setting up the QR code upload¶

The upload-qr-lods setting contains the levels of description for which the QR upload button is displayed, for example files and items [5,6]. To deactivate the QR upload, an empty array [] is saved, or the content of the field is deleted.

Activating the upload¶

1. Open the object¶

Navigate to the desired unit of description (a file or an item, for example).

2. Generate the QR code¶

Click the QR Upload button (📱 icon) in the toolbar
A modal opens with:
a QR code to scan
an upload URL to copy or share
a token (validity configurable, default: 1 hour)

3. Choose processing options (optional)¶

Image processing options can be activated in the modal:

Option	Description	Tool on the server
HEIC → JPEG	Convert iPhone images (HEIC/HEIF) to JPEG automatically	`heif-convert` (libheif)
Images → PDF	Combine several uploaded images losslessly into one PDF	`img2pdf`
OCR	Perform text recognition (makes PDFs searchable)	`ocrmypdf` + Tesseract (deu+eng)

These settings are saved and apply to all uploads.

Pipeline details (for admins)¶

The pipeline runs in this order:

1. BEFORE IMPORT (synchronous)
   HEIC → heif-convert → JPG
   JPGs → img2pdf      → PDF
   PDF  → ocrmypdf     → PDF with OCR text layer (master)

2. IMPORT
   addAntonMedium() → event MediumAdded

3. AFTER IMPORT (async, queue)
   MediumIdentifyAndConvert
   ├─ PRONOM identification
   ├─ cloud sync (if configured)
   ├─ thumbnail generation
   └─ RefreshFulltext
      └─ pdftotext → media_texts (full-text index)

The pipeline is controlled centrally via the image-upload-processing setting (array). Possible values: heic2jpg, images2pdf, ocr.

Example with all three steps activated:

Setting::setValue('image-upload-processing', ['heic2jpg', 'images2pdf', 'ocr']);

Prerequisites on the server:

heif-convert (package libheif/libheif-tools)
img2pdf (Python tool)
ocrmypdf with tesseract-ocr-deu and tesseract-ocr-eng
pdftotext (package poppler-utils) — also needed for full-text extraction

Anton does not fail silently if a tool is missing — the pipeline stage concerned is skipped and documented in the log.