2.9 KiB
Executable file
LibreQR
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
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:
- CodeItNow Barcode & QrCode Generator to generate QR codes
- Less.php to compile Less
License
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/.