No description
- Rust 100%
| src | ||
| .env.example | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
brother-bot
Bot Telegram che stampa sticker e immagini su una stampante di etichette Brother QL
(testato con QL-500 e rotolo continuo da 62 mm), usando la libreria
ql-label (fork con supporto QL-500), con dithering Floyd–Steinberg.
Cosa fa
- Accetta foto, sticker statici (WebP) e immagini inviate come file. Gli sticker animati/video vengono rifiutati.
- Rende bianco lo sfondo trasparente, ritaglia i bordi vuoti e scala l'immagine sulla
larghezza del nastro (696 punti, ~59 mm), senza superare
MAX_LENGTH_MMin lunghezza (default 100 mm, margini inclusi). - Alle foto applica anche un aumento di contrasto (auto-levels) prima del dithering.
- Schiarisce i toni medi (default 50%) per compensare l'ingrossamento dei punti della stampa termica, lasciando invariati il nero e il bianco pieni.
- Con il comando
/anteprima(attivabile/disattivabile per ogni utente) mostra prima l'etichetta esattamente come verrà stampata, con i pulsanti 🖨️ Stampa e 🗑️ Scarta, più ☀️ Più chiaro / 🌑 Più scuro per regolare lo schiarimento a passi del 10% aggiornando l'anteprima. Solo chi ha mandato l'immagine può premerli; le anteprime non confermate scadono dopo un'ora o al riavvio del bot. Chi ha l'anteprima attiva viene salvato in un piccolo database (redb), quindi la scelta resta anche dopo un riavvio. - L'anteprima simula la stampa termica: ogni punto viene disegnato come un dischetto
più grande del passo della testina (300 dpi, 300×600 in alta risoluzione), così si
vede quanto i punti si allargano e scuriscono l'etichetta. La dimensione si regola
con
DOT_GAIN. - Stampa un lavoro alla volta: se la stampante è occupata, avvisa che si è in coda.
- A stampa finita conferma il successo e, se la stampante non ha la taglierina (es. QL-500), ricorda di tagliare l'adesivo con la levetta.
Configurazione
Copia .env.example in .env e compila:
| Variabile | Descrizione |
|---|---|
TELOXIDE_TOKEN |
Token del bot, da @BotFather |
PRINTER_MODEL |
QL-500, QL-720NW, QL-800, QL-820NWB |
PRINTER_SERIAL |
Numero di serie USB (lsusb -v -d 04f9: | grep iSerial) |
MAX_LENGTH_MM |
Lunghezza massima dell'etichetta in mm (default 100) |
LIGHTEN_PERCENT |
Schiarimento dei toni medi prima del dithering (default 50, 0 = off) |
HIGH_RESOLUTION |
Modalità 300×600 dpi, più fine lungo il nastro (default false; non supportata dalla QL-500, non testata) |
DOT_GAIN |
Diametro del punto stampato rispetto al passo di 300 dpi, per la simulazione dell'anteprima (default 1.5) |
DATABASE_PATH |
File del database delle impostazioni (default brother-bot.redb) |
ALLOWED_USERS |
ID utente Telegram autorizzati, separati da virgola. Vuoto = tutti |
Per scoprire il proprio ID basta scrivere al bot con ALLOWED_USERS impostato a un
valore qualsiasi: il messaggio di rifiuto lo riporta.
Uso
cargo run --release # avvia il bot
cargo run --release -- render foto.jpg out.png --levels # anteprima simulata, senza stampare
cargo run --release -- render foto.jpg out.png --dots # i punti esatti inviati alla stampante
cargo run --release -- print sticker.webp # stampa un file locale
L'anteprima di render è la stessa simulazione mostrata dal bot; con --dots salva
invece esattamente il bitmap (con dithering) che verrebbe inviato alla stampante.
L'utente che esegue il bot deve poter accedere al dispositivo USB (ad esempio essere nel
gruppo lp).