Is a fork of libreqr - PHP Web interface for generating QR codes.

Find a file

Miraty b4ae9acb4f Use POST instead of GET		2021-07-11 14:00:35 +02:00
less.php	Use less.php instead of lesserphp	2021-02-15 21:29:38 +01:00
locales	Use POST instead of GET	2021-07-11 14:00:35 +02:00
temp	backend en anglais + vérification améliorée des params	2020-03-06 21:34:31 +01:00
themes	Add textarea-specific text color settings	2021-04-27 00:24:20 +02:00
.gitignore	Allow upgrading opensearch plugin from LibreQR 1.1.0 + use standardised opensearch parameters	2020-03-17 14:02:31 +01:00
CHANGELOG.md	Add prefers-color-scheme to the Changelog	2021-03-07 23:11:41 +01:00
config.inc.php	Change default qr codes expiration delay from 7 days to 2 days	2021-03-07 23:07:16 +01:00
config.yaml.php	Add config.yaml.php and translate some strings of code in english	2020-10-25 18:02:57 +01:00
help.svg.php	Add config.yaml.php and translate some strings of code in english	2020-10-25 18:02:57 +01:00
inc.php	Use POST instead of GET	2021-07-11 14:00:35 +02:00
index.php	Use POST instead of GET	2021-07-11 14:00:35 +02:00
LICENSE	D	2019-08-13 21:17:08 +02:00
LICENSE.html	Fix theme	2020-03-15 21:16:06 +01:00
LICENSE.md	D	2019-08-13 21:17:08 +02:00
manifest.php	Use POST instead of GET	2021-07-11 14:00:35 +02:00
opensearch.php	Use POST instead of GET	2021-07-11 14:00:35 +02:00
phpqrcode.php	Remove depreciation warning in phpqrcode for PHP 8	2021-04-13 00:43:05 +02:00
README.md	Use POST instead of GET	2021-07-11 14:00:35 +02:00
README_fr.md	Use POST instead of GET	2021-07-11 14:00:35 +02:00
style.less	Fix "Only apply transition to border's color"	2021-05-03 15:54:55 +02:00

README.md

LibreQR

Lire ceci en français

A PHP Web interface for generating QR codes.

Demo

A LibreQR instance is available at https://qr.antopie.org.

How it works

LibreQR includes an OpenSearch plugin, which allows to add it as a search engine in Firefox and to save settings. You can thus generate a QR code directly from your search bar with the LibreQR's settings used at the time of adding as search engine.

A WebManifest is also included, which allows better system integration using Fennec (Firefox Android) ou Chromium.

QR codes generated are located in the temp/ directory, named with the number of random characters set in config.inc.php (32 by default), and then deleted after the time set in config.inc.php (2 days by default).

See config.inc.php for more settings.

Installation

Generic

Just place this source code in a Web server with PHP.

wget https://code.antopie.org/miraty/libreqr/archive/1.3.0.zip

GD extension is required.

apt install php7.3-gd

LibreQR need writing rights on the temp/ directory.

chown -R www-data:www-data /var/www/libreqr/temp
chmod -R 600 /var/www/libreqr/temp

YunoHost

There is a package for YunoHost.

For historical reasons, LibreQR is technically named qr in YunoHost.

You can install it from the WebAdmin or with this command :

sudo yunohost app install qr

Themes

Change theme

In config.inc.php, set $theme to the wanted theme.

By default, 3 themes are offered:

dark, the default dark theme. Used here: https://qr.antopie.org
light, the light theme.
parinux, a blue theme, made for Bastet, the Parinux's CHATON. Used here: https://codeqr.parinux.org

Make a theme

Copy themes/dark to themes/[new theme's name]
Fill theme.php according to CSS colors you want
Change the source.png image according to your theme
To automatically generate favicons with the rights sizes, use php themes/resize.php [theme's name]

This last step will need ImageMagick and pngquant to be installed.

apt install imagemagick pngquant

Contribute

If you want to report a bug, you can open an issue at https://code.antopie.org/miraty/libreqr/issues after creating an account (prefered method) or contact me in another way.

Contact

If you want to contact me, for instance to report a bug or ask me a question about installing or using LibreQR, you can get my contact details on https://miraty.antopie.org.

Libraries

This source code includes:

phpqrcode to generate QR codes
less.php to compile Less

License

AGPLv3+

LibreQR is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

LibreQR is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.