Torna alla Home

Tutorial Passo-Passo

Guide pratiche per iniziare con MacroStream

Setup Iniziale

Installa e configura MacroStream per la prima volta in pochi semplici passi.

5 minuti Principiante

Crea il Tuo Primo Tile

Impara ad aggiungere, personalizzare e gestire i tile per i tuoi canali.

3 minuti Principiante

Connetti App Mobile

Configura il tuo smartphone come telecomando wireless per MacroStream.

4 minuti Intermedio

Riordina con Drag & Drop

Organizza i tuoi tile nella disposizione perfetta con la funzione drag & drop.

2 minuti Principiante

Sincronizzazione Multi-Device

Mantieni tutti i tuoi dispositivi sincronizzati in tempo reale.

3 minuti Intermedio

Icone Personalizzate

Aggiungi le tue icone personalizzate per rendere unico il tuo setup.

5 minuti Avanzato

Setup Iniziale di MacroStream

1

Scarica MacroStream

Vai alla pagina Download e scarica il pacchetto per il tuo sistema operativo (Windows, macOS o Linux).

Screenshot: Pagina Download

2

Installa l'Applicazione

Esegui il file scaricato e segui la procedura guidata:

  • Accetta i termini di licenza
  • Scegli la cartella di installazione
  • Clicca "Installa" e attendi il completamento
3

Primo Avvio

Avvia MacroStream dal menu applicazioni o dall'icona sul desktop. Vedrai la finestra principale con 12 riquadri vuoti pronti per essere personalizzati.

Suggerimento: Al primo avvio, il backend server si avvierà automaticamente in background.
4

Verifica l'Installazione

Per verificare che tutto funzioni correttamente:

# Controlla che i servizi siano attivi # Backend server: http://localhost:3001 # App mobile: http://localhost:5173

Crea il Tuo Primo Tile

1

Seleziona un Riquadro Vuoto

Clicca su uno dei 12 riquadri vuoti contrassegnati dal simbolo "+". Si aprirà il pannello di configurazione.

2

Inserisci il Nome del Canale

Digita il nome del tuo canale preferito nel campo di testo. Ad esempio:

  • "YouTube Gaming"
  • "Twitch"
  • "Discord Server"
  • "OBS Studio"
3

Scegli un'Icona

Clicca su "Scegli Icona" per aprire la libreria di icone. MacroStream include oltre 1000 icone organizzate in categorie:

  • Apps and Web Services
  • Games
  • Multimedia
  • Social Media
  • E molte altre...
Suggerimento: Usa la barra di ricerca per trovare rapidamente l'icona che cerchi!
4

Salva il Tile

Clicca il pulsante "Salva" per confermare. Il tile apparirà immediatamente nella griglia con il nome e l'icona che hai scelto!

Connetti l'App Mobile

1

Avvia i Servizi

Assicurati che MacroStream sia in esecuzione sul tuo PC. Se hai installato da sorgenti, esegui:

npm run dev

Questo avvierà contemporaneamente l'app desktop, il backend server e l'app mobile.

2

Trova l'Indirizzo IP del Tuo PC

Su Windows:

ipconfig

Cerca "Indirizzo IPv4" (es. 192.168.1.100)

Su macOS/Linux:

ifconfig

oppure

ip addr show
3

Connetti lo Smartphone

Sul tuo smartphone:

  1. Assicurati di essere sulla stessa rete Wi-Fi del PC
  2. Apri il browser (Chrome, Safari, Firefox...)
  3. Digita nella barra degli indirizzi: http://[IP-DEL-PC]:5173
  4. Esempio: http://192.168.1.100:5173
4

Aggiungi alla Home Screen (Opzionale)

Per un accesso rapido come un'app nativa:

iPhone/iPad: Safari > Condividi > Aggiungi a Home

Android: Chrome > Menu > Aggiungi a schermata Home

Riordina con Drag & Drop

1

Seleziona un Tile

Clicca e mantieni premuto il mouse (o il dito su touchscreen) su un tile che vuoi spostare.

2

Trascina nella Nuova Posizione

Mentre tieni premuto, trascina il tile verso la posizione desiderata. Vedrai un'anteprima della nuova disposizione.

3

Rilascia per Scambiare

Rilascia il mouse/dito sopra un altro tile per scambiare le loro posizioni. Lo scambio avviene istantaneamente!

Suggerimento: Puoi scambiare un tile pieno con uno vuoto per riorganizzare completamente il layout.
4

Sincronizzazione Automatica

Le modifiche vengono salvate automaticamente e sincronizzate su tutti i dispositivi connessi in tempo reale!

Sincronizzazione Multi-Device

1

Come Funziona la Sincronizzazione

MacroStream utilizza Socket.io per sincronizzare i dati in tempo reale tra tutti i dispositivi connessi alla stessa rete locale.

Quando modifichi un tile su un dispositivo, tutti gli altri si aggiornano istantaneamente!

2

Pulsante Sincronizza

Nell'app desktop, trovi il pulsante "Sincronizza" nell'angolo in alto a destra. Usalo per:

  • Forzare un refresh manuale dei dati
  • Risolvere eventuali discrepanze tra dispositivi
  • Verificare lo stato della connessione al server
3

Verificare la Connessione

Per verificare che il server di sincronizzazione sia attivo:

# Apri il browser e visita: http://localhost:3001/api/channels # Dovresti vedere la lista dei tuoi canali in formato JSON
4

Risoluzione Problemi

Se la sincronizzazione non funziona:

  • Verifica che tutti i dispositivi siano sulla stessa rete
  • Controlla che il firewall non blocchi la porta 3001
  • Riavvia il backend server
  • Clicca il pulsante "Sincronizza"

Aggiungi Icone Personalizzate

1

Prepara le Tue Icone

Crea o scarica le icone che vuoi usare. Requisiti:

  • Formato: PNG (con trasparenza preferibile)
  • Dimensioni consigliate: 256x256 pixel
  • Nome file descrittivo (es. "my-custom-channel.png")
2

Trova la Cartella Icons

Naviga nella cartella di installazione di MacroStream:

# Percorso cartella icone: MacroStream/src/electron/assets/icons/
3

Aggiungi le Tue Icone

Copia i file PNG delle tue icone personalizzate nella cartella icons/. Puoi anche creare sottocartelle per organizzarle meglio.

Suggerimento: Crea una cartella "custom" per tenere separate le tue icone da quelle predefinite.
4

Usa le Icone Personalizzate

Riavvia MacroStream. Le tue icone saranno automaticamente disponibili nel selettore quando crei o modifichi un tile!

5

Creare Icone di Qualità

Consigli per icone belle e coerenti:

  • Mantieni uno stile visivo coerente
  • Usa colori che si abbinano al tema dell'app
  • Assicurati che siano ben visibili anche a dimensioni ridotte
  • Usa sfondi trasparenti quando possibile