Segno

1.6.6 · active · verified Sat Apr 11

Segno is a pure Python library for generating QR Codes and Micro QR Codes according to ISO/IEC 18004:2015(E). It provides various serialization formats like Scalable Vector Graphics (SVG), Portable Network Graphics (PNG), Encapsulated PostScript (EPS), Portable Document Format (PDF), and more, without external dependencies for these core functionalities. Currently at version 1.6.6, Segno maintains an active release cadence with several updates per year.

Warnings

breaking Segno dropped support for Python 2.7 starting from version 1.6.0. Python 2.7 reached its End-of-Life on January 1, 2020.
Fix: Migrate your project to Python 3.5+ (ideally 3.10+ to avoid additional dependencies) if using Segno 1.6.0 or newer.
breaking Starting with Segno 1.6.0, the internal dependency on `pkg_resources` was removed and replaced by `importlib.metadata`. For Python versions older than 3.10, this introduces a new explicit dependency on the `importlib-metadata` backport package.
Fix: If running on Python < 3.10 with Segno 1.6.0 or newer, ensure `importlib-metadata` is installed (e.g., `pip install segno 'importlib-metadata<5.0.0'` for Python < 3.8, or simply `pip install segno` for 3.8+ as it's often handled implicitly by modern pip resolving dependencies).
gotcha Segno releases 1.6.4 and 1.6.5 (fixed in 1.6.6) had packaging issues where man pages were placed in the wrong directory or source distributions did not include all relevant files. While fixed, this highlights a potential for minor distribution-related glitches in point releases.
Fix: Always use the latest stable patch release (e.g., 1.6.6) to avoid such packaging issues.
gotcha In versions prior to 1.3.3, the `segno.helpers.make_wifi` and `segno.helpers.make_wifi_data` functions could generate invalid data if input strings contained characters that could be misinterpreted as integers.
Fix: Upgrade to Segno 1.3.3 or newer to ensure correct generation of Wi-Fi QR codes, as this issue was resolved.

Install

pip install segno Install latest version

Imports

make
```
import segno
qrcode = segno.make('Your data')
```
The `make` function is the primary entry point for creating QR codes and Micro QR codes.
helpers
```
from segno import helpers
```
The `helpers` module provides high-level functions for specific data types like vCard or Wi-Fi configurations.

Quickstart

This quickstart generates two QR codes: a basic one and a colorful one, saving them as PNG images. Segno automatically determines the minimal version and optimal error correction level by default.

import segno

# Create a QR code for a URL
qrcode = segno.make('https://example.com/your-data')

# Save the QR code as a PNG file with a scale of 5
qrcode.save('my_qrcode.png', scale=5)

# Or save as SVG
# qrcode.save('my_qrcode.svg', scale=5)

# Create a colorful QR code
colorful_qrcode = segno.make('https://example.com/colorful', dark='darkblue', light='lightblue')
colorful_qrcode.save('my_colorful_qrcode.png', scale=5)

print('QR codes generated successfully: my_qrcode.png and my_colorful_qrcode.png')

view raw JSON →