NOMAD QR Codes

Generate branded QR codes (PNG or SVG) with rounded dots, styled finder eyelets, and an embedded center logo:

The package installs a CLI command:

• nomad-qr-codes

Installation

Install from PyPI:

pip install nomad-qr-codes

If you prefer uv:

uv pip install nomad-qr-codes

For editable local development:

pip install -e .

Quick Start

Generate a QR code using the default preset and transparent background:

uv run nomad-qr-codes "https://nomad-lab.eu"

This creates:

• generated-nomad-qr.png

CLI Usage

nomad-qr-codes DATA [OPTIONS]

Required argument

• DATA: URL or text to encode.

Example:

nomad-qr-codes "https://nomad-lab.eu"

Options

• --preset {default,dark,oasis,dtu}
  • Selects preset colors and bundled logo.
  • Default: default
• --output PATH
  • Output file path.
  • Default: generated-nomad-qr.png
• --logo PATH
  • Use a custom center logo SVG instead of bundled logos.
• --color HEX
  • Override QR foreground color (example: #192E87).
• --eyelet-color HEX
  • Override finder eyelet color.
• --format {png,svg}
  • Output format.
  • If omitted, inferred from output file extension.
• --white-background
  • Enables white page background and white logo backing.
  • Without this flag, background is transparent.

Examples

Generate transparent PNG with default preset:

uv run nomad-qr-codes "https://nomad-lab.eu"

Generate white-background PNG:

uv run nomad-qr-codes "https://nomad-lab.eu" --white-background

Generate SVG output:

uv run nomad-qr-codes "https://nomad-lab.eu" --format svg --output nomad-qr.svg

Use oasis preset:

uv run nomad-qr-codes "https://nomad-lab.eu" --preset oasis

Use custom colors:

uv run nomad-qr-codes "https://nomad-lab.eu" --color "#0B1E4D" --eyelet-color "#22A06B"

Use a custom logo:

uv run nomad-qr-codes "https://nomad-lab.eu" --logo ./my-logo.svg

Presets

• default: NOMAD default palette
• dark: NOMAD dark palette
• oasis: Oasis palette
• dtu: DTU red palette

Bundled logos are packaged with the Python package under src/nomad_qr_codes/assets/logos.

Notes

• For best scanning reliability, keep high contrast between foreground and background.
• Very large center logos can hurt scan performance.
• SVG output is ideal when you need scalable print assets.