libreqr/README.md

3.6 KiB
Executable file

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:

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:

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/.