Installer Mini QR Code Generator avec Docker

zarev 10 oct. 2024 5 min de lecture

Table des matières

Cette idée m'a été suggérée par Beulu, membre sur Discord. Merci à toi! 👍

Il y a QR Code et QR Code! Certains sont tout ce qu'il y a de plus banal et puis certains sont stylés et attirent l'attention:

Aujourd'hui nous allons parler de Mini QR Code Generator! Une application qui permet de générer d'une part, un QR Code, et d'une autre, d'ajouter un style unique. Les possibilités sont vraiment nombreuses!

Cela peut s'avérer pratique si vous avez une société et que vous voulez ajouter votre logo dans un QR Code travaillé qui attire l’œil, que vous organisez un évènement ou tout simplement car vous aimez un beau QR Code. Après tout.

⚡Caractéristiques

✅ Accessible : au minimum conforme aux normes WCAG A.
🎨 Couleurs et styles personnalisables.
🖼️ Exportation vers SVG et PNG.
📋 Copier dans le presse-papiers.
🌓 Mode clair/foncé basé sur les paramètres du système.
🎲 Bouton de randomisation du style.
🌐 Disponible en plus de 29 langues.
💾 Sauvegarde et chargement de la configuration du code QR.
🖼️ Télécharger une image personnalisée pour le logo.
🎭 Presets : Styles de code QR préconçus.
🛡️ Niveau de correction des erreurs : affecte la taille du code QR et du logo qu'il contient. Utilisez des niveaux de correction inférieurs pour les données plus volumineuses afin de garantir qu'elles puissent être lues.
📦 Exportation de données par lots : Importez un fichier CSV contenant plusieurs chaînes de données et exportez des codes QR pour chacune d'entre elles en une seule fois.

💾 L'installation

Créez votre compose.yml dans le dossier ou vous comptez installer Mini QR Code Generator:

nano compose.yml

Collez ça dedans en prenant soin d'adapter les ports et les volumes suivant votre configuration:

version: "3.8"
services:
  mini-qr:
    image: ghcr.io/lyqht/mini-qr:latest
    container_name: mini-qr
    ports:
      - 6469:8080
    restart: unless-stopped

On installe l'application:

docker-compose up -d

ou avec docker-compose V2:

docker compose up -d

Rendez-vous sur l'ip:port, suivant l'IP de votre serveur local et du port choisi, 6469 par défaut:

http://ip:6469/

ou votre domaine:

https://mondomaine.com

⚙️ Générer un QR Code

Lorsque vous lancez l'application, vous arrivez... Sur votre application! Si ça ce n'est pas de la performance! 😋

Détaillons ensemble l'interface.

Sauver et restaurer des réglages

Imaginons que vous ayez trouvé un style sur lequel vous vouliez revenir plus tard, ces deux options serviront à sauver et restaurer vos réglages.

Exporter votre QR Code

Quand vous avez enfin trouvé un style qui vous plaît, vous pouvez télécharger votre QR Code soit en PNG ou en SVG.

Preset

Si vous ne voulez pas trop vous prendre la tête, il y a quelques présélections qui vont avoir pour effet de générer un QR Code avec un style bien défini:

Vous avez également le "lancé de dé", en complément, qui va s'occuper de random les couleurs et les formes dans le QR Code.

Données à encoder

C'est dans cette zone que vous devrez inscrire les données que doivent contenir le QR Code. Un lien vers un site Web, un message,...

Niveau de correction des erreurs

Le niveau de correction d'erreur d'un code QR détermine l'ampleur des dommages que le code peut subir tout en restant lisible. Chaque code QR possède l'un des quatre niveaux de correction d'erreur.

Le niveau de correction recommandé est de 30%.

URL de l'image du logo

Cette option va vous permettre d'ajouter votre propre logo dans le QR Code, deux façons d'y arriver, soit le lien direct de l'image ou envoyer l'image en cliquant sur Télécharger l'image. C'est très simple.

En arrière-plan

C'est ici que vous pourrez personnaliser les couleurs de l'arrière plan, des points, des carrés et des autres points. Vous pouvez également désactiver l'arrière-plan en décochant l'arrière-plan.

Largeur (px)

Ces options pourront servir à définir:

La largeur du QR Code en sortie.
La hauteur du QR Code et sortie.
La marge. Elle sert a définir l'espace entre le contenu du QR Code et le bord du QR Code.

Sans marge:

Avec une (grosse) marge:

La propriété du margin.
Le rayon de la bordure. Vous pourrez ainsi lui donner une forme de rond à carrée.

Le rayon à 100%:

Le rayon à 0%:

Type de points

Quelques paramètres pour définir les formes dans le QR Code et les points.

La langue

En haut à droite, vous avez un choix énorme de langues:

❗ Mon QR Code ne fonctionne pas!

Lorsque j'ai testé l'application j'ai remarqué une chose, sous certaines conditions mon QR Code ne fonctionnait pas. Et puis j'ai compris ceci. N'hésitez pas à utiliser la fonction Marge.

Parfois, si les informations importantes du QR Code sont proches du bord, cela peut fausser la lecture du code.