81 lines
2.6 KiB
Markdown
Executable File
81 lines
2.6 KiB
Markdown
Executable File
#  LibreQR
|
|
|
|
[Lire ceci en français](README_fr.md)
|
|
|
|
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](https://code.antopie.org/miraty/qr_ynh/) for [YunoHost](https://yunohost.org/).
|
|
|
|
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:
|
|
|
|
* [CodeItNow Barcode & QrCode Generator](https://github.com/codeitnowin/barcode-generator) to generate QR codes
|
|
* [Less.php](https://github.com/wikimedia/less.php) to compile [Less](http://lesscss.org)
|
|
|
|
## License
|
|
|
|
[AGPLv3+](https://code.antopie.org/miraty/libreqr/src/branch/main/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/>.
|