Skip to content

Plugin labelmaker

Martin Pihrt edited this page Oct 13, 2026 · 1 revision

Label Maker

Generates EAN13 barcodes and configurable QR code images.

At a glance

Item Value
Version 1.0.0
Category Utilities and development examples
Author Martin Pihrt
License GPL-3.0
OSPy 3.0.211 or newer
Python 3.8 or newer
Permissions files, subprocess
Hardware No dedicated hardware requirement declared
Dependencies None
Python/OS packages PIL / Pillow (optional), qrcode (optional)
Interfaces No provider or mobile API declared
Source Open the plug-in directory

What it is for

Generates EAN13 barcodes and configurable QR code images.

How it works and how to configure it

Tested in Python 3+

This extension allows you to generate barcodes or QR codes for your use and subsequent use in the OSPy system (for example, generating flowerbed stickers with a detailed description of what is planted for the variety, the need for soil, water...)

Dependencies

On Raspberry Pi OS Bookworm and newer, install dependencies with the system package manager instead of pip:

  • EAN13: sudo apt install python3-pil
  • QR codes: sudo apt install python3-qrcode
  • QR with logo: sudo apt install python3-pil

EAN-13 barcodes are generated directly by the plug-in and do not require python-barcode.

If a required dependency is missing, the plug-in settings page shows an Install libraries button. The installation output is written to the plug-in status log.

The plug-in includes an OSPy plugin.json manifest and implements the common lifecycle and health() interfaces. Its former one-shot background thread was removed because labels are generated synchronously from the settings page. The real dependency-installation worker is registered with the shared runtime. Diagnostics reports the selected code type, only its required libraries, installation state, generated output file, and the latest generation result.

Plugin setup

  • Select output format: We select the desired code format. We have a selection available: BAR EAN13, QR black and white, QR color, QR with logo.

  • Message: Message embedded in the code.

  • Download filename: File name used when downloading the generated PNG image.

  • QR module size: Size of one QR module in pixels.

  • QR border: Quiet zone around the QR code.

  • QR error correction: QR error correction level. Use higher levels when the QR code contains a logo or may be damaged.

  • QR color and QR background color: Foreground and background colors for color QR codes and QR codes with logo.

  • Status: Status window from the plugin.

In-app help and settings notes

The following notes are generated from the help page shipped with this plug-in. Field names are also explained directly in the OSPy settings page.

This extension allows you to generate barcodes or QR codes for your use and subsequent use in the OSPy system (for example, generating flowerbed stickers with a detailed description of what is planted for the variety, the need for soil, water...)

This extension requires Python packages only for the selected output type. On Raspberry Pi OS Bookworm and newer, install them with apt instead of pip.

  • EAN13

  • QR codes

  • QR with logo

EAN-13 barcodes are generated directly by the plug-in and do not require python-barcode.

If a required package is missing, the settings page shows an Install libraries button and writes the installation progress to the status log.

EAN13 code

Message must have 12 digits and must contain only numbers.

QR black and white

Do not insert messages longer than 500 characters.

QR color

Advanced QR options allow setting module size, border, error correction level, foreground color and background color.

Full credit goes to projects

Related links and diagrams

ean demo

qr bw demo

qr color demo

qr logo demo

Support

Check OSPy → Diagnostics first and remove passwords, tokens, private addresses and other secrets before sharing logs. Report reproducible plug-in problems in the OSPy-plugins issue tracker.

Back to the plug-in catalog

Clone this wiki locally