====== Imprimante thermique Brother QL-570 ======
Achat 26 fév. 2025 sur leboncoin, 50e
{{:materiel:imprimante_thermique_brother_ql-570:ql570.jpg?direct&400|}}
**Documentation : [[https://lesporteslogiques.net/materiel/imprimante_brother_QL-570/|Brother QL-570]]**
C'est une imprimante thermique, donc les seuls consommables sont les rouleaux d'étiquettes imprimables (ni encore, ni toner). Ces rouleaux existent en différentes dimensions.
**Caractéristiques**
* Largeur maximale d'impression : 59mm / largeur maximale des rouleaux : 62mm
* Longueur minimale d'impression : 12.7mm (pas de maximum, il existe des rouleaux continus) \\
* Résolution : 300 dpi
Pour l'instant on a un rouleau de largeur 38mm x 90mm (DK-11208). Pour se rendre compte des divers types de rouleaux : https://www.brother.fr/consommables/ql-570
====== Utiliser l'application Stickeuse-QL570 ======
Cette page raconte **comment imprimer une étiquette** avec l'imprimante Brother QL-570 du FabLab, à l'aide de l'application //Stickeuse-QL570//.
Elle ne remplace pas le dépôt du projet, qui reste la **source de vérité technique** : [[https://github.com/lesporteslogiques/stickeuse|github.com/lesporteslogiques/stickeuse]]. On ne trouvera donc **pas d'instructions d'installation ici** — l'installation est faite une seule fois par machine par le ou la responsable du FabLab.
----
===== Ce que fait (et ne fait pas) l'application =====
L'application **imprime** une étiquette sur la QL-570, à partir d'une **image PNG** (Portable Network Graphics) que vous avez préparée vous-même.
Elle **ne crée pas** l'image : on la fabrique avant, dans GIMP (GNU Image Manipulation Program). L'application reçoit un fichier déjà prêt et l'envoie à l'imprimante.
----
===== 1. Préparer l'image (dans GIMP) =====
L'étiquette chargée est une **DK-11208** (38 × 90 mm), prédécoupée. L'imprimante n'accepte qu'**une seule taille d'image**, au pixel près :
* **413 × 991 px** (portrait), ou **991 × 413 px** (paysage — l'application la fait pivoter toute seule) ;
* en **noir pur sur blanc** (l'imprimante est thermique, monochrome) ;
* enregistrée en **PNG**.
Toute autre taille sera **refusée** : ce n'est pas un réglage, c'est une contrainte de l'étiquette prédécoupée.
> Pas à pas pour fabriquer l'image dans GIMP (nouvelle image, trait au Crayon, texte, aplatissement, export PNG) : voir le guide **« Prise en main de GIMP »** du dépôt [[https://github.com/lesporteslogiques/stickeuse/blob/main/docs/prise-en-main-gimp.md]].
----
===== 2. Vérifier l'imprimante =====
Avant de lancer l'impression, assurez-vous que :
* la QL-570 est **branchée sur le secteur** ;
* elle est **allumée** (voyant vert) ;
* le rouleau **DK-11208** est chargé ;
* il reste **assez d'étiquettes** pour votre projet.
Au moment où vous branchez l'imprimante, une petite notification **« QL-570 détectée — prête à imprimer »** peut apparaître. C'est normal : un agent tourne en fond et signale la présence de l'imprimante. Il **signale seulement**, il n'imprime rien.
**[Capture à ajouter : la notification de bureau « QL-570 détectée — prête à imprimer ».]**
----
===== 3. Lancer l'application =====
Sur le **bureau**, double-cliquez sur l'icône **Stickeuse QL-570**.
**[Capture à ajouter : l'icône « Stickeuse QL-570 » sur le bureau.]**
Au **tout premier lancement**, votre système peut demander d'**autoriser** l'icône (par exemple, un clic droit puis //« Autoriser le lancement »//). C'est normal, à faire **une seule fois**.
Si l'icône est absente, prévenez le ou la **responsable** : l'application a peut-être besoin d'être (ré)installée sur ce poste.
----
===== 4. Écran d'accueil : la checklist =====
Au lancement, une fenêtre **« Bienvenue ! »** affiche la checklist du point 2.
**[Capture à ajouter : la fenêtre « Bienvenue ! » avec ses quatre cases et le bouton OK.]**
- Cochez les **quatre cases** (ce sont les choses que l'application ne peut pas vérifier toute seule).
- Cliquez sur **OK**.
À ce moment, l'application **cherche l'imprimante**. Si elle la trouve, la fenêtre principale s'ouvre. Sinon, un message d'erreur explique quoi faire (voir « Si ça coince »).
----
===== 5. Fenêtre principale : imprimer =====
**[Capture à ajouter : la fenêtre principale (bouton Parcourir, nombre d'exemplaires, bouton Imprimer vert).]**
- **Parcourir…** — choisissez votre fichier PNG. L'application le **vérifie aussitôt** (est-ce bien un PNG ? les bonnes dimensions ?). S'il convient, son nom s'affiche ; sinon, un message explique le refus.
- **Nombre d'exemplaires** — laissez **1**, ou choisissez-en plus.
- **Imprimer** (bouton vert) — actif uniquement quand un fichier valide est choisi. Un clic lance l'impression du nombre d'exemplaires demandé.
- Un message confirme : //« étiquette(s) imprimée(s) »//.
----
===== Si ça coince =====
L'application affiche des messages clairs. Les plus courants :
* **« Image peut-être floue / trop de gris »** — //avertissement seulement// : vous pouvez imprimer quand même. Pour un rendu plus net, refaites l'image au **Crayon** dans GIMP (bords nets, sans gris).
* **« Mauvaises dimensions »** — votre image n'est pas en 413 × 991 px. Refaites-la dans GIMP à la bonne taille.
* **« Fichier refusé / pas un PNG »** — fournissez un vrai fichier ''.png''.
* **« Aucune imprimante trouvée »** — vérifiez qu'elle est branchée et allumée, débranchez/rebranchez ; si rien n'y fait, prévenez le ou la **responsable** (câble ou port en cause).
* **« Pas le droit d'imprimer »** — c'est une action d'administration, faite une fois par machine : prévenez le ou la **responsable**.
**[Capture à ajouter : un exemple de dialogue d'erreur, p. ex. « Mauvaises dimensions ».]**
Dans tous les cas, l'application tient un **journal** (un fichier de trace) dans ''~/.ql570/''. Inutile d'y toucher : il sert au ou à la responsable pour diagnostiquer un problème sans avoir à le reproduire devant vous.
----
===== Pour aller plus loin =====
Le code, la documentation technique et l'installation vivent dans le dépôt, qui fait foi :
**[[https://github.com/lesporteslogiques/stickeuse|github.com/lesporteslogiques/stickeuse]]**
Cette page-ci **raconte l'usage** ; le dépôt **dit le comment technique**.
==== Consommables ====
Les fichies imprimables sont en noir et blanc 1-bit, format PNG
^ Référence ^ Dimensions ^ Nbre d'étiquettes ^ définition conseillée ^ Prix ^ Prix à l'étiquette ^
| DK-11208 | 38 x 90 mm | 400 | 440 x 996 | 17,30e | 0,043e | ([[https://store.brother.fr/catalogs/brotherfrance/consommables/imprimantes-d-etiquettes/etiquettes/dk/dk11208|details]])
| DK-11202 | 62 x 100 mm | 300 | ne fonctionne pas pour le moment | 20e | 0,067e | ([[https://store.brother.fr/catalogs/brotherfrance/consommables/imprimantes-d-etiquettes/etiquettes/dk/dk11202|details]])
Ce doc donne une idée des consommables utilisables : https://www.farnell.com/datasheets/1500565.pdf
Les différents rouleaux sont reconnus par des trous sur le socle et des picots sur la machine
{{:materiel:imprimante_thermique_brother_ql-570:ql570_rouleaux_details.jpg?direct&600|}}
==== Autres machines ====
QL-800 : impression en 2 couleurs (noir et rouge) avec rouleau continu DK-22251 cf. [[https://www.brother.eu/-/media/pdf/bbe/products/brochures/brochure-ql-800-fr.pdf|spec]] \\
QL-1050 : impression jusqu'à 102mm de large + DK-11241 (102mm x 152mm) cf. [[https://www.brother.eu/-/media/product-downloads/devices/nordics/eu_en/labelling-machines/ql-1050_1060_english-pdf.pdf|spec]] \\
===== Utilisation sur Debian 12 =====
Au premier branchement, lsusb renvoie ''Bus 002 Device 002: ID 04f9:2028 Brother Industries, Ltd QL-570 Label Printer''
J'essaie différents programmes qui permettent d'imprimer directement sur la machine, sans passer par un driver d'impression (ce qui permet d'utiliser ces imprimantes sur raspberry pi par exemple)
==== QL570 ====
J'essaie d'installer https://github.com/sudomesh/ql570
git clone https://github.com/sudomesh/ql570.git
cd ql570/
sudo apt install build-essential libpng12-0 libpng12-dev pkg-config
make
sudo make install # n'a pas fonctionné
./ql570 # ok
sudo ./ql570 /dev/usb/lp1 38x90 test.png # nécessaire pour accéder au port
Ça fonctionne mais l'image est mal cadrée... L'image fait 440 x 1083 \\
Sur un rouleau 38x90, ça **fonctionne bien en 996 x 440, 1-bit, PNG**, testé aussi en 1000 x 448, ça fonctionne bien aussi
8 juillet 2025 : premier essai en 62x100, ça ne fonctionne pas. Il y a une erreur dans le code source (ligne 425) quand les paramètes de la ligne de commande sont interprétés, après modification et re-compilation, ça ne fonctionne toujours pas (TODO)
==== brother_ql_web ====
https://github.com/pklaus/brother_ql_web
git clone https://github.com/pklaus/brother_ql_web.git
cd ./brother_ql_web/
pip install -r requirements.txt # marche pas
pipx install brother_ql
pipx install bottle
pipx install jinja2 # -> erreur
sudo apt install python3-jinja2
./brother_ql_web.py
Mais ça ne marche pas, grrrrr, ''/usr/bin/env: « python »: Aucun fichier ou dossier de ce type'', je ne comprends pas comment fonctionne l'envirronnement python, pix et tout ça, ça vient probablement de là...
Ça fonctionne en installant un environnement virtuel python
sudo apt install virtualenv
cd /home/emoc/___LOGICIELS/2025/
git clone https://github.com/pklaus/brother_ql_web.git
python3 -m venv brother_ql_web
source brother_ql_web
source brother_ql_web/bin/activate
cd brother_ql_web
pip install -r requirements.txt
./brother_ql_web.py
deactivate
==== installation du driver officiel sur Debian 12 ====
**Attention, une fois installé, on ne peut plus utiliser le programme d'impression direct... L'imprimante n'apparaît plus dans /dev/usb (TODO)**
La procédure est indiquée ici : https://www.brother.co.uk/support/ql570/faqs/easy-tasks/faqp00100414_000
Télécharger les fichiers depuis https://support.brother.com/g/b/branch/downloadlist.aspx?c=gb&lang=en&prod=lpql570euk&os=130
* LPR printer driver
* CUPSwrapper printer driver
Se rendre dans le répertoire où les fichiers ont été téléchargés
sudo dpkg -i --force-all ./ql570lpr-1.0.1-0.i386.deb
sudo dpkg -i --force-all ./ql570cupswrapper-1.0.1-0.i386.deb
Puis se rendre dans CUPS : http://localhost:631/printers/QL-570 \\
Et choisir « administration/définir les options de l'imprimante » pour définir la taille du rouleau dans l'imprimante et d'autres options
Test d'impression avec Gimp : ça fonctionne mais il y a beaucoup de marges blanches et l'image est tramée (TODO)
==== brother-ql ====
* https://pypi.org/project/brother-ql/
* https://github.com/pklaus/brother_ql
==== aussi ====
Conseils de Demoniox
* https://framagit.org/stickoeur/diagnostickoeur
* https://github.com/hackstub/stickers.local
* https://md.globenet.org/auto-stickers#