Documentazione MacroStream

Guida completa per utilizzare MacroStream al massimo delle sue potenzialità

Cos'è MacroStream?

MacroStream è un'applicazione completa che ti permette di controllare i tuoi canali di streaming preferiti attraverso un'interfaccia intuitiva con 12 tile personalizzabili. Include:

  • App Desktop (Electron) - Finestra principale con drag & drop
  • Backend Server (Node.js) - Sincronizzazione dati in tempo reale
  • App Mobile Web (Vue.js) - Telecomando da smartphone
Nota: MacroStream funziona completamente sulla tua rete locale. Non sono richiesti account o connessioni esterne.

Installazione

Requisiti di Sistema

  • Sistema Operativo: Windows 10/11, macOS 10.14+, Linux (Ubuntu 18.04+)
  • RAM: Minimo 4GB (consigliati 8GB)
  • Spazio Disco: 200MB liberi
  • Node.js: Versione 16 o superiore

Installazione da Sorgenti

# 1. Clona il repository git clone https://github.com/macrostream/macrostream.git cd macrostream # 2. Installa le dipendenze npm install # 3. Avvia tutti i servizi npm run dev

Installazione da Pacchetto Precompilato

  1. Scarica il pacchetto per il tuo sistema operativo dalla pagina Download
  2. Esegui il programma di installazione
  3. Segui la procedura guidata
  4. Avvia MacroStream dal menu applicazioni
Successo! Se vedi la finestra principale con i 12 riquadri, l'installazione è completata.

Utilizzo dell'App Desktop

Interfaccia Principale

L'app desktop mostra 12 tile personalizzabili in una griglia 4x3. Ogni tile può contenere:

  • Nome del canale personalizzato
  • Icona selezionabile da una vasta libreria
  • Pulsanti di azione (Modifica, Elimina)

Aggiungere un Canale

  1. Clicca su un riquadro vuoto (con il simbolo +)
  2. Inserisci il nome del canale (es. "YouTube Gaming")
  3. Clicca su "Scegli Icona" e seleziona un'icona dalla libreria
  4. Clicca "Salva" per confermare
// Esempio di configurazione canale { "id": "tile-1", "name": "YouTube Gaming", "icon": "youtube.png", "position": 0 }

Riordinare i Tile

MacroStream supporta il drag & drop completo:

  1. Clicca e mantieni premuto su un tile
  2. Trascina il tile nella nuova posizione
  3. Rilascia per scambiare le posizioni

Modificare un Canale

  • Clicca il pulsante ✏️ (matita) sul tile
  • Modifica nome e/o icona
  • Clicca "Salva" per applicare le modifiche

Eliminare un Canale

  • Clicca il pulsante 🗑️ (cestino) sul tile
  • Conferma l'eliminazione
Attenzione: L'eliminazione di un canale è permanente e non può essere annullata.

App Mobile Web

Connessione dall'App Mobile

  1. Assicurati che il backend server sia avviato (npm run dev)
  2. Trova l'indirizzo IP del tuo PC sulla rete locale
  3. Sul tuo smartphone, apri il browser e vai a: http://[IP-DEL-PC]:5173
  4. Vedrai gli stessi tile del desktop

Trovare l'Indirizzo IP

Windows:
ipconfig # Cerca "Indirizzo IPv4" nella sezione della tua scheda di rete
macOS/Linux:
ifconfig # oppure ip addr show

Funzionalità Mobile

  • Visualizzazione responsive dei tile
  • Sincronizzazione in tempo reale con il desktop
  • Touch gestures per navigazione rapida
  • Possibilità di modificare canali dal mobile
Suggerimento: Aggiungi l'app alla home screen del tuo smartphone per un accesso rapido come se fosse un'app nativa!

Sincronizzazione Dati

Come Funziona

MacroStream utilizza Socket.io per la sincronizzazione in tempo reale tra tutti i dispositivi connessi. Quando modifichi un canale su un dispositivo, tutti gli altri si aggiornano istantaneamente.

Server Backend

Il server backend gira sulla porta 3001 e gestisce:

  • Salvataggio persistente dei dati in data/channels.json
  • Broadcast degli aggiornamenti a tutti i client connessi
  • API REST per operazioni CRUD sui canali

Endpoints API

GET /api/channels # Ottieni tutti i canali POST /api/channels # Crea nuovo canale PUT /api/channels/:id # Aggiorna canale DELETE /api/channels/:id # Elimina canale

Pulsante Sincronizza

Clicca il pulsante "Sincronizza" nell'app desktop per:

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

Configurazione Avanzata

Modificare le Porte

Puoi cambiare le porte predefinite modificando i file di configurazione:

Backend Server (porta 3001):
// src/backend/server.js const PORT = process.env.PORT || 3001;
Mobile App (porta 5173):
// vite.config.js export default { server: { port: 5173 } }

Backup e Ripristino

Tutti i dati sono salvati in data/channels.json. Per fare un backup:

  1. Copia il file data/channels.json
  2. Salvalo in un luogo sicuro
  3. Per ripristinare, sostituisci il file con il backup
  4. Riavvia l'applicazione

Aggiungere Icone Personalizzate

  1. Aggiungi le tue icone in formato PNG nella cartella src/electron/assets/icons/
  2. Le icone saranno automaticamente disponibili nel selettore
  3. Dimensioni consigliate: 256x256px
Pro Tip: MacroStream include oltre 1000 icone da pacchetti IKON preinstallati!

Risoluzione Problemi

L'app non si avvia

  • Verifica che Node.js sia installato: node --version
  • Assicurati di aver eseguito npm install
  • Controlla che le porte 3001 e 5173 non siano già in uso

La sincronizzazione non funziona

  • Verifica che il server backend sia in esecuzione
  • Controlla che PC e smartphone siano sulla stessa rete
  • Verifica il firewall non blocchi le porte 3001 e 5173
  • Prova a cliccare il pulsante "Sincronizza"

Non riesco a connettere il mobile

  1. Verifica l'indirizzo IP del PC: ipconfig (Windows) o ifconfig (Mac/Linux)
  2. Assicurati di usare la porta corretta: :5173
  3. Controlla che non ci siano VPN attive che isolano le reti
  4. Prova a disabilitare temporaneamente il firewall

I tile non si salvano

  • Verifica i permessi di scrittura nella cartella data/
  • Controlla che il file channels.json non sia corrotto
  • Guarda i log del server per eventuali errori

Ottenere Supporto

Se i problemi persistono: