Need help with segno?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

heuer
137 Stars 7 Forks BSD 3-Clause "New" or "Revised" License 1.3K Commits 5 Opened issues

Description

Python QR Code and Micro QR Code encoder

Services available

!
?

Need anything else?

Contributors list

# 282,167
Python
Shell
pure-py...
qr-gene...
1138 commits
# 167,035
C++
Python
qr-code
qr-gene...
3 commits
# 28,270
TypeScr...
Flask
alembic
TeX
2 commits
# 346,975
Python
Shell
qr-code
qr-gene...
1 commit
# 138,804
jupyter
JavaScr...
Jekyll
HTML
1 commit
# 252,491
Python
JavaScr...
gsuite
google-...
1 commit

.. image:: https://travis-ci.com/heuer/segno.svg?branch=master :target: https://travis-ci.com/heuer/segno

QR Code encoder and Micro QR Code encoder

Pure Python QR Code generator with no dependencies.

This package implements ISO/IEC 18004:2015(E) "QR Code bar code symbology specification" and produces QR Codes and Micro QR Codes with nearly no effort. It supports the

Structured Append mode 
_ which splits a message across several QR codes.

Segno (Italian for "sign" / "symbol") provides several serialization formats like Scalable Vector Graphics (SVG), Encapsulated PostScript (EPS), Portable Network Graphics (PNG), Portable Document Format (PDF), Netpbm (PAM, PBM, PPM), LaTeX (PGF/TikZ), X PixMap (XBM), and X Bitmap (XPM) etc. None of these serializers require an external lib. Further, it provides several high level functions to create QR Codes which encode

contact data (vCard, MeCard) 
,
EPC QR Codes 
, or
WIFI QR Codes 
_.

The project provides more than 1500 test cases (coverage >= 98%) to verify a standard conform QR Code and Micro QR Code generation acc. to ISO/IEC 18004:2015(E).

Unique features

  • Pure Python QR Code generator (supports 2.7, 3.5+, PyPy2 and PyPy3)
  • No dependencies
  • A lot of
    serialization formats 
    _ (SVG, PNG, EPS, PDF, ...)
  • Fastest (pure Python) QR Code encoder 
    _
  • Micro QR Codes
  • Structured Append mode 
    _
  • Hanzi mode 
    _
  • Command line interface 
    _
  • Simple, user-friendly API 
    _

.. code-block:: python

import segno
qr = segno.make('Yellow Submarine')
qr.save('yellow-submarine.png')
  • Colorful QR codes 
    _

.. image:: https://github.com/heuer/segno/raw/master/docs/_static/yellow-submarine.png :alt: Colorful 3-H QR code encoding "Yellow Submarine"

... works also with Micro QR codes

.. image:: https://github.com/heuer/segno/raw/master/docs/static/colorful/rain.png :alt: Colorful M4-Q Micro QR code encoding "Rain" *

Artistic QR Codes 
(requires the

qrcode-artistic 
_ plug-in)

.. image:: https://github.com/heuer/segno/raw/master/docs/_static/artistic/letitbe.jpg :alt: Animated 3-H QR code encoding "The Beatles -- Let It Be"

... animated QR codes are supported as well

.. image:: https://github.com/heuer/segno/raw/master/docs/_static/artistic/abbey-road.webp :alt: Animated 4-H QR code encoding "The Beatles -- Abbey Road"

Installation

Use

pip
to install segno from PyPI::
$ pip install segno

MacPorts ^^^^^^^^

Segno is also available at

MacPorts 
_ (
project page 
_)::
$ sudo port install py-segno

conda-forge ^^^^^^^^^^^

The library is also available at

conda-forge 
_ (
project page 
_)::
$ conda install -c conda-forge segno

Debian 10 / Buster (backports) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

::

$ apt-get -t buster-backports install python3-segno

Debian 11 / Bullseye (testing) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

::

$ apt-get install python3-segno

Usage

Command line ^^^^^^^^^^^^

The command line script prints a QR code to the terminal::

$ segno "Comfortably Numb"

To serialize a QR code, use the "output" argument::

$ segno -o=raincoat.svg "Famous Blue Raincoat"
$ segno --scale 10 --dark darkblue --border 0 --output=fire.svg "Who by Fire"
$ segno --scale 10 --light transparent --output=miracle.png "Waiting for the Miracle"

Library ^^^^^^^

.. code-block:: python

>>> import segno
>>> # Let Segno choose the minimal version and an optimal (maximal) error
>>> # level without changing the minimal version
>>> qr = segno.make('Up Jumped the Devil')
>>> qr.designator  # Returns the QR code version and the error correction level
'2-Q'
>>> qr.save('up-jumped-the-devil.png')  # Save as PNG
>>> qr.save('up-jumped-the-devil-2.png', scale=10)  # Scaling factor 10
>>> qr.save('up-jumped-the-devil-3.png', light=None)  # Transparent light modules
>>> qr.save('up-jumped-the-devil.pdf', scale=10)  # Save as PDF
>>> # SVG drawing the dark modules in "dark blue"
>>> qr.save('up-jumped-the-devil.svg', scale=10, dark='darkblue')

If the content to encode is small enough, a Micro QR code is generated:

.. code-block:: python

>>> import segno
>>> qr = segno.make('RAIN')
>>> qr.is_micro
True
>>> qr.designator
'M2-M'

If this behaviour is not desired, the user may set

micro
to
False

.. code-block:: python

>>> import segno
>>> qr = segno.make('RAIN', micro=False)
>>> qr.is_micro
False
>>> qr.designator
'1-H'

Or use the factory functions

segno.make_qr()
which generates always QR codes (never Micro QR codes) or
segno.make_micro()
which returns always Micro QR codes (or raises an error if the content is too large for a Micro QR code).

.. code-block:: python

>>> import segno
>>> mqr = segno.make_micro('THE BEATLES')
>>> mqr.designator
'M3-M'
>>> qr = segno.make_qr('THE BEATLES')  # Same content but enforce a QR Code
>>> qr.designator
'1-Q'
>>> # This won't work since the data does not fit into a Micro QR Code M1 - M4
>>> mqr = segno.make_micro('Nick Cave and the Bad Seeds')
Traceback (most recent call last):
    ...
DataOverflowError: Data too large. No Micro QR Code can handle the provided data

All factory functions use the same parameters to specify the desired error level, version, data mask etc., see

Segno's documentation
_ for details.

Documentation

Read the online documentation at https://segno.readthedocs.io/

Trademark

"QR Code" and "Micro QR Code" are registered trademarks of DENSO WAVE INCORPORATED.

.. _Segno's documentation: https://segno.readthedocs.io/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.