# Plotter Hub

> Plotta in rete.

Plotter Hub trasforma un Raspberry Pi in un server di plottaggio in rete per il tuo plotter a penna compatibile con AxiDraw. Invia gli SVG dal tuo computer e lascia che il Pi gestisca il plot in locale, dall’inizio alla fine.

Plotter Hub è un server di plottaggio self-hosted per i plotter a penna della classe AxiDraw, in esecuzione su un Raspberry Pi. Trascina e rilascia un SVG nel browser e il Pi pilota il plotter in locale tramite l’API Python ufficiale di AxiDraw — con plottaggio livello per livello, pause per il cambio penna, preset dei formati carta, ottimizzazione opzionale dei percorsi con vpype, un cursore di posizione della penna in tempo reale e il supporto al pulsante di pausa fisico. Gratuito e open source con licenza MIT.

- **Developer:** Synendo
- **Website:** https://www.synendo.com/it/plotterhub/
- **Requirements:** Richiede Raspberry Pi OS
- **Vedi su GitHub:** https://github.com/Synendo/PlotterHub

## Un piccolo server per il tuo plotter a penna

Plotter Hub è pensato per i plotter della classe [AxiDraw](https://wiki.evilmadscientist.com/AxiDraw), che non dovrebbero richiedere un computer collegato per ogni lavoro. Collega il plotter a un Raspberry Pi una volta sola, poi invia i plot da qualsiasi dispositivo sulla tua rete locale. Trascina dentro un SVG con i livelli di Inkscape e Plotter Hub lo plotta livello per livello — oppure invia il lavoro tramite la sua API HTTP. È proprio così che [GD Studio](https://www.synendo.com/it/gdstudio/), l’app di disegno generativo di Synendo per Mac, plotta direttamente dalla tela al tuo plotter a penna.

## Funzionalità

Plotter Hub ti dà i controlli che ti servono per il plottaggio quotidiano degli SVG senza trasformare la pagina in un pannello di controllo.

- Caricamento SVG con trascina e rilascia
- Selezione dei livelli di Inkscape
- Pausa tra i livelli per il cambio penna
- Preset carta, orientamento, margini e adattamento alla pagina
- Controlli di velocità con penna sollevata e penna abbassata
- Ottimizzazione opzionale con [vpype](https://vpype.readthedocs.io/en/latest/)
- Avanzamento in tempo reale, stima dei tempi e anteprima della posizione della penna
- Pausa, ripresa, annullamento e supporto al pulsante di pausa fisico
- Gira come servizio in background — si avvia all’accensione
- Aggiornamenti in-app con un solo clic
- API HTTP per app companion e script

**Grazie a Evil Mad Scientist.** Plotter Hub si basa sulla loro splendida [AxiDraw Python API](https://axidraw.com/doc/py_api/) open source (GPL-2.0), che gestisce il plotter dietro le quinte. Plotter Hub stesso è software libero e open source con licenza MIT.

## Requisiti

Ti serve:

- Raspberry Pi Zero 2 W, 3B+ o più recente
- Raspberry Pi OS Bookworm o Trixie — consigliata la versione Lite (senza ambiente desktop)
- Un plotter USB della classe AxiDraw
- Una rete locale affidabile

Un Raspberry Pi Zero 2 W funziona bene come server di plottaggio sempre attivo. Un Raspberry Pi 3B+ rende le anteprime e la configurazione più scattanti. Un Pi 4 o 5 di solito è superfluo se Plotter Hub è l’unica cosa in esecuzione. Un’installazione pulita è più semplice con [Raspberry Pi Imager](https://www.raspberrypi.com/software/).

## Come funziona

1. **Installa sul tuo Pi** — Collegati in SSH al tuo Raspberry Pi, clona il repo ed esegui ./install.sh. Crea un ambiente virtuale, installa l’API di AxiDraw e vpype, registra Plotter Hub come servizio systemd e stampa l’URL da aprire quando ha finito.

   Collegati in SSH al tuo Raspberry Pi

   ```
   % ssh plotter@plotterhub.local
   ```

   Aggiorna l’indice dei pacchetti e installa git

   ```
   plotter@plotterhub:~ sudo apt update && sudo apt install -y git
   ```

   Clona il repo di Plotter Hub

   ```
   plotter@plotterhub:~ git clone https://github.com/Synendo/PlotterHub.git ~/PlotterHub
   ```

   Entra nella cartella di installazione

   ```
   plotter@plotterhub:~ cd ~/PlotterHub
   ```

   Avvia l’installazione

   ```
   plotter@plotterhub:~/PlotterHub $ ./install.sh
   ```
2. **Apri l’interfaccia web** — Vai a http://plotterhub.local, o all’hostname del tuo Pi, da qualsiasi dispositivo sulla tua rete. Non c’è login né app desktop da installare — funziona come la pagina web di una stampante di rete.
3. **Trascina dentro un SVG e configuralo** — Trascina e rilascia il tuo SVG, seleziona quali livelli di Inkscape plottare, scegli un preset carta e i margini e attiva opzionalmente l’ottimizzazione con vpype. Prima di plottare, Plotter Hub stima tempo, distanza di disegno, distanza di spostamento e sollevamenti della penna.
4. **Segui e controlla il plot** — Segui il plot in tempo reale nell’interfaccia web — il cursore della penna e la barra di avanzamento si aggiornano mentre disegna — e mettilo in pausa, riprendilo o annullalo da lì. Una volta inviato il lavoro, il tuo computer non ha più bisogno di restare collegato. E se il tuo plotter ha un pulsante di pausa fisico, puoi usare anche quello, ad esempio per riprendere dopo un cambio di livello.

## App companion: Progetta con GD Studio

Plotter Hub porta la tua arte sulla carta. GD Studio è dove la crei — l’app macOS di Synendo per l’arte generativa con plotter a penna. Scegli tra 50 pattern distribuiti su 8 famiglie, modellale con controlli in tempo reale e aggiungi livelli di testo e SVG importati. Ogni disegno è costruito da tratti continui, così la tela mostra esattamente ciò che la penna disegnerà. E la cosa migliore: GD Studio invia il tuo lavoro direttamente a Plotter Hub tramite la tua rete — nessuna esportazione, nessun file da spostare.

[Scopri GD Studio](https://www.synendo.com/it/gdstudio/)

## FAQ di Plotter Hub

**Il mio computer deve restare collegato durante il plottaggio?**

No. Una volta inviato l’SVG, il Raspberry Pi gestisce il plot in locale.

**Funziona con il mio plotter?**

Plotter Hub è realizzato per i plotter a penna della classe AxiDraw: macchine che possono essere controllate tramite l’API Python di AxiDraw o un flusso di comandi compatibile in stile AxiDraw. Esempi:
- Plotter AxiDraw — per esempio l’AxiDraw V3/A4, V3/A3, SE/A4 o MiniKit.
- Plotter iDraw compatibili con AxiDraw — per esempio l’iDraw H SE A3.
- Plotter della classe NextDraw — per esempio il NextDraw 8511 o 1117, dove supportati tramite il flusso compatibile in stile NextDraw/AxiDraw.
- Plotter XY personalizzati basati su EBB — per utenti esperti, se la macchina è configurata per comportarsi come un plotter della classe AxiDraw.
Se il tuo plotter supporta l’API Python di AxiDraw o un flusso di comandi compatibile in stile AxiDraw, dovrebbe funzionare con Plotter Hub.

**Mi serve Inkscape, e quali SVG funzionano?**

Funziona qualsiasi SVG plottabile — disegni a linee e tratti che un plotter a penna può fisicamente tracciare. Nemmeno Inkscape è necessario: conta solo per la separazione dei livelli. Se il tuo file ha i livelli di Inkscape, Plotter Hub li rileva così puoi scegliere quali plottare e fare una pausa tra l’uno e l’altro per cambiare penna. Senza livelli, plotta semplicemente l’intero disegno.

**Posso cambiare penna tra un livello e l’altro?**

Sì. Plotter Hub può fare una pausa tra i livelli, così puoi cambiare penna e continuare il plot.

**Posso mettere in pausa un plot fisicamente?**

Sì, sui plotter supportati. Il pulsante di pausa fisico può mettere in pausa e riprendere un plot, e proseguire al livello successivo durante una pausa per il cambio penna.

**Posso usarlo da un altro computer?**

Sì. Qualsiasi dispositivo sulla stessa rete locale può aprire l’interfaccia web di Plotter Hub e inviare SVG.

**Plotter Hub ha un login?**

No. Plotter Hub è progettato per una rete locale affidabile, come la pagina web di una stampante di rete. Non esporlo direttamente a internet. Per l’accesso remoto, usa una VPN come Tailscale o WireGuard.

**Come aggiorno Plotter Hub?**

Quando viene pubblicata una versione più recente, un banner propone un aggiornamento con un solo clic direttamente nell’interfaccia web — Plotter Hub scarica l’ultima versione, riesegue l’installer e torna online da solo. Puoi anche aggiornare via SSH con un git pull e rieseguendo ./install.sh. Gli aggiornamenti sono bloccati mentre un plot è in corso, e le tue impostazioni, la coda dei lavori e i caricamenti vengono sempre conservati.

**Un plot sopravvive a un riavvio o a un reset?**

Sì. Plotter Hub gira come servizio e si riavvia all’accensione, e la coda dei lavori viene salvata su disco — così un plot in pausa viene ripristinato come lavoro riprendibile dopo un riavvio. Arrestare il servizio durante un plot solleva prima la penna.

**C’è un’API?**

Sì. Plotter Hub include un’API HTTP per app companion e script, protetta da una chiave API generata automaticamente. Consulta la [documentazione dell’API](https://github.com/Synendo/PlotterHub/blob/main/API.md) per il riferimento degli endpoint.

**È gratuito?**

Sì. Plotter Hub è gratuito e open source (licenza MIT).

---

## Legal & support

- Vedi su GitHub: https://github.com/Synendo/PlotterHub

## Altro da Synendo

- [VisionTagger](https://www.synendo.com/it/visiontagger/) — Mai più taggare foto a mano.
- [GD Studio](https://www.synendo.com/it/gdstudio/) — Arte generativa, fatta per essere plottata.

## Other languages

- en: https://www.synendo.com/plotterhub/
- nl: https://www.synendo.com/nl/plotterhub/
- de: https://www.synendo.com/de/plotterhub/
- ja: https://www.synendo.com/ja/plotterhub/
- fr: https://www.synendo.com/fr/plotterhub/
- zh-Hans: https://www.synendo.com/zh-Hans/plotterhub/
- es: https://www.synendo.com/es/plotterhub/
- pt: https://www.synendo.com/pt/plotterhub/
- ko: https://www.synendo.com/ko/plotterhub/
