Code source du service
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3.7 KiB


Lire ceci en français

A PHP Web interface for generating QR codes.


A LibreQR instance is available at

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 (32 by default), and then deleted after the time set in (7 days by default).

See for more settings.



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


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


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


Change theme

In, 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


If you want to report a bug, you can open an issue at after creating an account (prefered method) or contact me in another way.


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


This source code includes:



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