Metadata-Version: 2.1
Name: pibooth-qrcode
Version: 1.0.2
Summary: Pibooth plugin to display a QR Code on the screen during idle time.
Home-page: https://github.com/pibooth/pibooth-qrcode
Author: Vincent Verdeil, Antoine Rousseaux
License: GPLv3
Download-URL: https://github.com/pibooth/pibooth-qrcode/archive/1.0.2.tar.gz
Keywords: Raspberry Pi,camera,photobooth,pygame
Platform: unix
Platform: linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Natural Language :: English
Classifier: Topic :: Multimedia :: Graphics :: Capture :: Digital Camera
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
License-File: LICENSE


==============
pibooth-qrcode
==============

|PythonVersions| |PypiPackage| |Downloads|

``pibooth-qrcode`` is a plugin for the `pibooth`_ application.

It adds the display of a custom qrcode at the print and wait state

Install
-------

::

    $ pip3 install pibooth-qrcode

Configuration
-------------

Here below the new configuration options available in the `pibooth`_ configuration.
**The keys and their default values are automatically added to your configuration after first** `pibooth`_ **restart.**

.. code-block:: ini

    [QRCODE]
    # URL which may be composed of variables: {picture}, {count}
    prefix_url = https://github.com/pibooth/pibooth

    # Foreground color
    foreground = (255, 255, 255)

    # Background color
    background = (0, 0, 0)

    # Optional text displayed close to the QR code
    side_text =

    # Offset (x, y) from location
    offset = (20, 40)

    # Location on 'wait' state: topleft, topright, bottomleft, bottomright, midtop-left, midtop-right, midbottom-left, midbottom-right
    wait_location = bottomleft

    # Location on 'print' state: topleft, topright, bottomleft, bottomright, midtop-left, midtop-right, midbottom-left, midbottom-right
    print_location = bottomright

.. note:: Edit the configuration by running the command ``pibooth --config``.

QR code URL
-----------

The URL linked to the QR code can be define dynamically using some state variables or configuration
options. Available variables to forge the URL are:

- **picture** : current picture filename
- **count** : current counters. You can access to values using ``{count.xxx}`` (see counters
  in configuration menu)
- **url** : URL defined in the ``app.previous_picture_url`` attribute. This attribute can be
  defined by another plugin.

For instance, ``https://photos.google.com/share/AxFF4t56kiJiu89m/{picture}`` will generate::

    https://photos.google.com/share/AxFF4t56kiJiu89m/2021-06-11-10-14-08_pibooth.jpg

QR code locations
-----------------

Here is the possible QR code location at screen:

.. image:: https://raw.githubusercontent.com/pibooth/pibooth-qrcode/master/docs/images/locations.png
   :align: center
   :alt: Locations

Example
-------

Here is an example of the rendering you can get with this plugin on the wait screen:

.. image:: https://raw.githubusercontent.com/pibooth/pibooth-qrcode/master/docs/images/screenshot.png
   :align: center
   :alt: Example screenshot

.. --- Links ------------------------------------------------------------------

.. _`pibooth`: https://pypi.org/project/pibooth

.. |PythonVersions| image:: https://img.shields.io/badge/python-3.6+-red.svg
   :target: https://www.python.org/downloads
   :alt: Python 3.6+

.. |PypiPackage| image:: https://badge.fury.io/py/pibooth-qrcode.svg
   :target: https://pypi.org/project/pibooth-qrcode
   :alt: PyPi package

.. |Downloads| image:: https://img.shields.io/pypi/dm/pibooth-qrcode?color=purple
   :target: https://pypi.org/project/pibooth-qrcode
   :alt: PyPi downloads


