Sign inSign up

geertmeersman/qr-generator

By geertmeersman

•Updated about 9 hours ago

A self-hosted Flask web app to generate QR codes for URLs, SEPA payments, WiFi, vCards and free text

Image
0

1.3K

geertmeersman/qr-generator repository overview

screenshot

Flask-based QR code generator with multi-language support (nl, en, fr, de).

⁠Screenshots

URLSEPAWiFi
URLSEPAWiFi
vCardTextAdmin
vCardTextAdmin

⁠Current versions

ComponentVersion
Python3.13.18-slim

⁠Supported QR types

TypeFields
URLURL
SEPARecipient name, IBAN, Amount, BIC, Message
WiFiSSID, Password, Security, Hidden
vCardName, Company, Job title, Phone, Email, Website, Street, City, Postal code, Country, Photo
TextFree text

⁠Usage

docker run -p 5000:5000 -v qr-data:/app/data geertmeersman/qr-generator:latest

Or with Docker Compose:

services:
  qr-web:
    image: geertmeersman/qr-generator:latest
    container_name: qr-web
    ports:
      - "5000:5000"
    volumes:
      - qr-data:/app/data
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:5000/health"]
      interval: 30s
      timeout: 5s
      retries: 3
    restart: unless-stopped

volumes:
  qr-data:

Open http://localhost:5000 in your browser.

⁠Deep links

You can pre-fill the form via URL parameters:

ParameterTypeDescription
taburl | sepa | wifi | vcard | textOpens the specified tab

URL: ?tab=url&url=https://example.com

SEPA: ?tab=sepa&naam=Jan%20Janssen&iban=BE00000000000000&bedrag=10.00&bic=GEBABEBB&mededeling=Invoice%202026-001

WiFi: ?tab=wifi&ssid=MyNetwork&password=secret&security=WPA&hidden=0

vCard: ?tab=vcard&naam=Jan%20Janssen&bedrijf=Acme&functie=CEO&tel=%2B32499000000&[email protected]&url=https://example.com&straat=Hoofdstraat%201&stad=Brussel&postcode=1000&land=Belgium

Text: ?tab=text&text=Hello%20World

⁠vCard hosting

PathDescription
/vcard/<id>Public vCard page with download button
/vcard/<id>/downloadDirect .vcf download
/adminAdmin dashboard (login required)
/admin/setupFirst-time admin account setup

Mount /app/data to persist vCards and the admin database.

⁠Auto-updates

Rebuilt automatically whenever the upstream python:3.13-slim image is updated.

© 2026 Geert Meersman⁠ — Licensed under the MIT License⁠ — Releases⁠

Tag summary

Content type

Image

Digest

sha256:434d2107b…

Size

73.8 MB

Last updated

about 9 hours ago

docker pull geertmeersman/qr-generator