libreqr/README.md

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

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

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

Security hardening

Your HTTP server can reply the following headers:

Content-Security-Policy: default-src 'none'; img-src 'self' data:; style-src 'self'; frame-ancestors 'none'; form-action 'self';
Referrer-Policy: no-referrer

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

Themes are located in themes/*, the default theme is in themes/libreqr/.

You can customize your LibreQR instance look by changing the colors in theme.php, the logo in logo.less or the icons in icons/<size>.png (then list the sizes in theme.php).

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