Vai al contenuto
Menu della documentazione

Prynt Desktop

L'app opzionale per Windows e il Download Center: stampa locale di PDF e ZPL, installazione, aggiornamenti e modello di sicurezza.

Prynt è un'applicazione web: progetti, pubblichi e generi nel browser su app.prynt.it, senza installare nulla. Prynt Desktop è un'app facoltativa per Windows che mostra la stessa applicazione in una finestra propria e aggiunge ciò che un browser non può fare: stampare sulle stampanti del tuo computer e inviare etichette ZPL alle stampanti di etichette della tua rete locale.

Cosa aggiunge

  • Stampanti di Windows: i documenti vanno direttamente alle stampanti installate sul computer (stampanti d'ufficio, print server, stampanti di etichette), con il numero di copie che scegli, con o senza il dialogo di stampa di Windows.
  • Etichette ZPL: le etichette vanno come ZPL raw a una Zebra con una coda di Windows (USB o condivisa) o a una stampante di etichette di rete della tua LAN su una porta di stampa raw. Il cloud non deve mai raggiungere la tua rete: invia i dati l'app, che gira al suo interno.
  • Una finestra dedicata nella barra delle applicazioni, notifiche di Windows e link prynt:// che aprono una pagina dell'applicazione.
  • Aggiornamenti automatici, scaricati in background.

Tutto il resto funziona esattamente come nel browser, con lo stesso account. Non ti serve Prynt Desktop per generare documenti tramite API: i tuoi sistemi ricevono il PDF o lo ZPL e lo stampano da soli.

Il Download Center

Tutto ciò che Prynt offre da installare è in una pagina dell'applicazione, il Download Center (menu dell'account o menu Aiuto → Download). Ogni file è servito dalla piattaforma stessa, con la sua dimensione e il suo SHA-256:

  • Prynt Desktop per Windows: l'installer per l'architettura del tuo computer (x64 o ARM64), quello dell'altra architettura e i due file ZIP portable.
  • Prynt Gateway: i pacchetti per Windows, Linux e Docker, per raggiungere i database di una rete privata (vedi Gateway). Per installarlo serve sempre il token di un gateway che aggiungi in un workspace.
  • Strumenti per sviluppatori: il documento OpenAPI 3.1 dell'API pubblica, il riferimento e l'explorer dell'API e gli SDK.

La pagina Prynt Desktop dell'applicazione presenta l'app e propone il download giusto per il tuo computer. Se gli installer non sono ancora pubblicati sul server, entrambe le pagine lo dicono invece di proporre un download.

Installazione

Windows10 (1809+) / 11
x64 o ARM64. macOS e Linux non sono supportati: lì continua a usare Prynt nel browser.
Dirittiper utente
L'installer installa per il tuo utente di Windows, senza diritti di amministratore.
WebView2Evergreen
Il runtime Microsoft Edge WebView2, già presente in Windows 11 e nella maggior parte dei computer con Windows 10; l'installer lo aggiunge se manca.
  • Installer (PryntDesktop-win-x64-Setup.exe o -win-arm64-): installa per il tuo utente, si aggiorna da solo e registra i link prynt://.
  • Portable (ZIP): estrai ed esegui, per i computer dove non è consentito installare. Niente aggiornamenti automatici, niente link prynt://.
  • Dopo l'installazione apri l'app e accedi con lo stesso account: la sessione del browser non passa all'app.

Per verificare un download, confronta il suo hash con lo SHA-256 mostrato nel Download Center:

PowerShell
(Get-FileHash .\PryntDesktop-win-x64-Setup.exe).Hash

Windows ha protetto il PC?

Finché l'installer non è firmato con un certificato di firma del codice, Windows SmartScreen può mostrare un avviso. Scegli Ulteriori informazioni, poi Esegui comunque. I criteri della tua azienda possono richiedere che sia l'IT a consentirlo.

La disinstallazione (Impostazioni di Windows → App) rimuove l'app e il protocollo prynt://. Il tuo profilo locale in %LOCALAPPDATA%\Prynt\Desktop (sessione, impostazioni, log) resta.

Stampare da Prynt

I controlli di stampa esistono solo dentro Prynt Desktop; in un browser normale sono nascosti. Dentro l'app compare un pulsante Stampa:

  • nell'anteprima PDF del Designer e nella prova di stampa: scegli una stampante di Windows, le copie (1–99) e, se vuoi, Stampa senza il dialogo di Windows;
  • accanto a Scarica nel dettaglio di un'esecuzione con un documento conservato, PDF o ZPL;
  • nella stampa di prova di un'etichetta ZPL, dove Questo computer si affianca a Stampante di prova del server: l'etichetta va a una coda di Windows, a una stampante di rete configurata nell'app o a un indirizzo della tua LAN.

Prynt ricorda l'ultima stampante scelta per il PDF e per lo ZPL. Le pagine PDF vengono disegnate da Windows a 300 dpi e inviate alla coda di stampa; un PDF può avere fino a 1.000 pagine e 50 MB. Lo ZPL viene inviato una volta sola e mai ritentato in automatico, così un'etichetta non viene mai stampata due volte per errore.

ZPL tramite una coda di Windows

Le etichette vanno a una coda di Windows come dati raw. Usa il driver Zebra ZDesigner o una coda "Generic / Text Only": un driver v4 o XPS che rifiuta i dati raw fallisce con PRINT_FAILED.

Stampanti di etichette di rete

Un'etichetta può andare direttamente a una stampante di rete tramite indirizzo (per esempio 192.168.1.50 o 192.168.1.50:9100). Perché una pagina web non possa mai usare l'app per esplorare la tua rete o raggiungere Internet, un indirizzo scritto in Prynt è accettato solo quando:

  • la porta è una porta di stampa raw, 9100–9109 (predefinita 9100);
  • tutti gli indirizzi a cui l'host si risolve sono privati: 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16, fc00::/7, fe80::/10. Indirizzi pubblici, CGNAT, multicast e loopback sono rifiutati con TARGET_NOT_ALLOWED.

Le stampanti configurate sul computer sono sempre ammesse, a qualunque indirizzo e porta, e compaiono per nome nell'elenco delle stampanti. Configurale nel file di impostazioni facoltativo dell'app (riavvia l'app dopo una modifica):

settings.json
{  // %LOCALAPPDATA%\Prynt\Desktop\settings.json (facoltativo)  "zplPrinters": [    { "name": "ZEBRA-MAGAZZINO", "host": "192.168.10.50", "port": 9100, "description": "ZT230 203 dpi" }  ],  "zplAllowedPorts": [],  "autoUpdate": true}
zplPrintersarray
Stampanti di etichette di rete di questo computer: nome, host, porta (predefinita 9100) e una descrizione facoltativa.
zplAllowedPortsnumber[]
Porte di stampa raw ammesse per gli indirizzi scritti a mano, oltre a 9100–9109.
autoUpdateboolean
Aggiornamenti automatici (predefinito true).

Aggiornamenti

L'app installata cerca una nuova versione 20 secondi dopo l'avvio e poi ogni 4 ore, la scarica in background e propone di riavviare subito o più tardi; nel secondo caso l'aggiornamento si applica all'avvio successivo. Le copie portable non si aggiornano da sole: scarica un nuovo ZIP dal Download Center.

Modello di sicurezza

  • La finestra mostra solo l'applicazione Prynt. Gli altri link si aprono nel browser predefinito; file:, javascript: e gli altri schemi sono bloccati, e gli errori di certificato non vengono mai scavalcati.
  • Solo le pagine dell'applicazione possono usare le funzioni di stampa, e solo un insieme fisso di operazioni tipizzate: elencare le stampanti, stampare un PDF, inviare ZPL, salvare un file, mostrare una notifica. Nessuna operazione avvia programmi o accetta percorsi di file.
  • La stampa di rete raggiunge solo stampanti della tua rete locale (vedi sopra).
  • Gira con il tuo utente di Windows, senza diritti di amministratore. Il suo log (%LOCALAPPDATA%\Prynt\Desktop\logs) non contiene mai il contenuto dei tuoi documenti.

Problemi frequenti

PRINTER_UNAVAILABLEerrore
La stampante non è raggiungibile. Non è stato inviato nulla: controlla che sia accesa e collegata, poi riprova.
PRINTER_SEND_FAILEDerrore
La connessione si è interrotta durante l'invio: alcune etichette potrebbero essere uscite. Controlla la stampante prima di riprovare.
TARGET_NOT_ALLOWEDerrore
L'indirizzo non è un indirizzo privato sulla porta 9100–9109. Usa un indirizzo della LAN, oppure configura la stampante in zplPrinters.
PRINT_FAILEDerrore
Windows ha rifiutato il lavoro. Per lo ZPL usa un driver che accetta dati raw (ZDesigner o "Generic / Text Only").
PRINTER_NOT_FOUNDerrore
La stampante di Windows non esiste più. Scegline un'altra.
PAYLOAD_TOO_LARGEerrore
Il documento supera i limiti (PDF: 50 MB, 1.000 pagine). Scaricalo e stampalo da un altro programma.
DOWNLOAD_FAILEDerrore
Non è stato possibile scaricare un documento conservato: la sessione o il documento potrebbero essere scaduti.

Le etichette e le loro impostazioni di stampa sono trattate in Etichette ZPL.