Risoluzione dei problemi

Questa guida copre i problemi più comuni che potresti incontrare con FloSync e come risolverli. Se il tuo problema non compare qui, consulta le FAQ o contatta il supporto.

Log diagnostici #

FloSync mantiene log dettagliati utili per la diagnosi dei problemi. Sono preziosi per analizzare problemi di sincronizzazione, capire cosa è successo durante una sessione o quando si contatta il supporto.

Accedere ai log #

Dal menu:

• macOS: Aiuto > Apri cartella log
• Windows: Aiuto > Apri cartella log

Posizione manuale:

• macOS: ~/Library/Application Support/FloSync/logs/
• Windows: %APPDATA%/FloSync/logs/

Struttura dei log #

I log sono organizzati per data e ora:

logs/
├── 2026-01-19/
│   ├── 00.log    (mezzanotte — 1:00)
│   ├── 01.log    (1:00 — 2:00)
│   ├── ...
│   └── 23.log    (23:00 — mezzanotte)
├── 2026-01-18/
│   └── ...

Conservazione dei log #

I log vengono conservati per 7 giorni e rimossi automaticamente all'avvio di FloSync. Questo offre uno storico sufficiente per la diagnosi senza occupare troppo spazio su disco.

Contenuto dei log #

I log includono voci con timestamp per:

• Avvio e chiusura dell'app
• Caricamento e riproduzione dei video
• Eventi e correzioni di sincronizzazione
• Connessioni e disconnessioni della sincronizzazione di rete
• Transizioni tra scene durante la riproduzione programmata
• Errori e avvisi

Usare i log per la diagnosi #

1. Riproduci il problema — annota l'orario approssimativo in cui si è verificato
2. Apri la cartella dei log — usa Aiuto > Apri cartella log
3. Trova il file giusto — naviga nella cartella della data e apri il file di log dell'ora corrispondente
4. Cerca gli errori — cerca le voci contrassegnate con "ERROR" o "WARN"
5. Esamina il contesto — leggi le voci prima e dopo l'errore per ricostruire il contesto

Quando contatti il supporto, allega i file di log pertinenti per accelerare la diagnosi.

Problemi di caricamento dei contenuti #

L'immagine non si carica #

Sintomi: trascinare un'immagine su FloSync non produce alcun effetto, oppure compare un errore.

Possibili cause e soluzioni:

1. Formato non supportato

   • Formati supportati: PNG, JPG/JPEG, GIF, BMP, TIFF, WebP, SVG
   • Verifica che il file non sia corrotto aprendolo in un altro visualizzatore di immagini

2. Permessi sul file

   • Assicurati di avere accesso in lettura al file
   • Prova a copiare il file su un'unità locale se si trova su una condivisione di rete

3. Limitazioni SVG

   • Alcune funzionalità SVG complesse potrebbero non renderizzarsi correttamente
   • Prova a convertire in PNG se l'SVG non viene visualizzato bene

La pagina web non si carica #

Sintomi: la pagina web mostra uno schermo vuoto o un errore.

Possibili cause e soluzioni:

1. HTTP vs HTTPS

   • Sono supportati solo gli URL HTTPS (non HTTP)
   • Assicurati che l'URL inizi con https://

2. Connettività di rete

   • Verifica di avere accesso a internet
   • Controlla se il sito web è raggiungibile da un browser normale

3. Il sito web blocca l'incorporamento

   • Alcuni siti impediscono di essere incorporati in WebView
   • Prova un sito diverso o usa un file HTML locale

Problemi di riproduzione video #

Il video non si carica #

Sintomi: trascinare un video su FloSync non produce alcun effetto, oppure compare un errore.

Possibili cause e soluzioni:

1. Formato non supportato

   • Prova a convertire in MP4 (H.264) — vedi Raccomandazioni sui codec video qui sotto
   • Verifica che il file non sia corrotto riproducendolo in un altro lettore video

2. Codec mancanti

   • FloSync include la maggior parte dei codec comuni, ma alcuni formati proprietari potrebbero non funzionare
   • Converti in un formato standard come MP4

3. Permessi sul file

   • Assicurati di avere accesso in lettura al file video
   • Prova a copiare il file su un'unità locale se si trova su una condivisione di rete

Il video va a scatti o perde fotogrammi #

Sintomi: la riproduzione non è fluida.

Soluzioni:

1. Controlla l'utilizzo di CPU/GPU — se sono al massimo, l'hardware potrebbe non reggere la risoluzione del video
2. Usa archiviazione SSD — i dischi rigidi potrebbero non leggere abbastanza velocemente per video ad alto bitrate
3. Riduci la risoluzione video — ricodifica a una risoluzione inferiore se l'hardware fa fatica
4. Chiudi le altre applicazioni — libera risorse di sistema
5. Controlla la tolleranza di sincronizzazione — se usi la sincronizzazione, aumenta la tolleranza per ridurre le correzioni

Problemi degli schermi #

Secondo schermo non rilevato #

Sintomi: FloSync mostra un solo schermo anche se ne sono collegati più di uno.

Soluzioni:

1. Controlla le impostazioni display del sistema operativo

   • macOS: Impostazioni di Sistema > Monitor
   • Windows: Impostazioni > System > Display
   • Verifica che tutti gli schermi siano rilevati dal SO

2. Controlla i cavi

   • Prova cavi diversi
   • Prova porte diverse sul computer

3. Riavvia FloSync dopo aver collegato nuovi schermi

   • FloSync rileva gli schermi all'avvio

La disposizione degli schermi non corrisponde #

Sintomi: in modalità Esteso, le sezioni del video compaiono sugli schermi sbagliati.

Soluzioni:

1. Configura la disposizione degli schermi nel SO

   • macOS: Impostazioni di Sistema > Monitor > Arrange
   • Windows: Impostazioni > System > Display (trascina per riordinare)
   • Fai corrispondere la disposizione virtuale a quella fisica

2. Riavvia FloSync dopo aver modificato la disposizione

Problemi di sincronizzazione #

Schermi non sincronizzati (locale) #

Sintomi: in modalità Specchiato o Esteso, gli schermi mostrano fotogrammi diversi.

Soluzioni:

1. Attendi la correzione automatica — FloSync corregge automaticamente il disallineamento persistente
2. Controlla la barra di stato — durante la modalità live, il contatore delle correzioni di sincronizzazione mostra quante ne sono state effettuate:
   • Conteggi bassi sono normali nelle sessioni prolungate
   • Conteggi ripetuti o in rapido aumento possono indicare un problema di configurazione
3. Stringi la tolleranza di sincronizzazione nelle preferenze
4. Controlla il log di sincronizzazione — cerca avvisi di disallineamento e correzioni
5. Riavvia la riproduzione — metti in pausa, poi riproduci di nuovo

La sincronizzazione di rete non funziona #

Sintomi: il client non trova il server, oppure la sincronizzazione non funziona dopo la connessione.

Soluzioni:

1. Verifica della rete

   • Entrambi i computer devono trovarsi sulla stessa rete locale
   • Verifica con un ping tra le macchine

2. Stesso file video

   • I client devono avere lo stesso video caricato
   • Se le durate dei video differiscono, la sincronizzazione non funziona

3. Verifica del firewall

   • Consenti FloSync attraverso il firewall su entrambe le macchine
   • Consenti la porta UDP 9201

4. Verifica del server

   • Conferma che l'icona del server (torre) sia verde nella barra superiore
   • Verifica che la barra di stato mostri "Server"
   • Prova a cliccare l'icona per fermare e riavviare la modalità server

5. Attendi la stabilizzazione iniziale

   • La sincronizzazione di rete potrebbe impiegare qualche istante a stabilizzarsi dopo la connessione
   • Alcune correzioni iniziali sono normali
   • Una volta stabilizzata, la riproduzione dovrebbe restare allineata in modo stabile

Disallineamento graduale dopo giorni di funzionamento #

Sintomi: la sincronizzazione di rete funzionava perfettamente, ma dopo diversi giorni di funzionamento continuo il client risulta costantemente disallineato di 50-100 ms senza correggersi del tutto.

Causa: l'orologio di sistema di ogni computer deriva a un ritmo leggermente diverso nel tempo, a causa della varianza dell'oscillatore hardware e della temperatura. Dopo giorni di funzionamento ininterrotto, questa deriva accumulata può superare la capacità di compensazione della correzione dell'orologio in tempo reale. Si tratta di un limite di tutti i sistemi di sincronizzazione basati sull'orologio, non solo di FloSync.

Soluzione: riavvia entrambi i computer. Per installazioni non presidiate, programma un riavvio giornaliero durante le ore di inattività — vedi Programmare riavvii regolari nella guida all'ottimizzazione della sincronizzazione.

Le correzioni di sincronizzazione causano scatti #

Sintomi: il video salta o va a scatti frequentemente durante la riproduzione.

Soluzioni:

1. Aumenta la tolleranza di sincronizzazione nelle preferenze
2. Controlla la qualità della rete (per la sincronizzazione di rete)
3. Riduci il carico del sistema — chiudi le applicazioni non necessarie
4. Controlla il log di sincronizzazione per individuare pattern ricorrenti

Problemi di Go Live #

Le finestre a schermo intero non compaiono #

Sintomi: cliccare Go Live non crea finestre a schermo intero sugli schermi.

Soluzioni:

1. Controlla il rilevamento degli schermi

   • Assicurati che gli schermi siano rilevati (dovrebbero comparire nell'area di disposizione degli schermi)
   • Prova a scollegare e ricollegare gli schermi
   • Riavvia FloSync dopo aver collegato nuovi schermi

2. Controlla il caricamento del video

   • Assicurati che almeno un video sia caricato prima di andare in Go Live
   • Verifica la presenza di indicatori "missing video"

3. Controlla i permessi

   • Su macOS, assicurati che FloSync abbia il permesso di controllare il computer (Impostazioni di Sistema > Privacy e sicurezza > Accessibilità)
   • Su Windows, prova a eseguire FloSync come amministratore

Il tasto ESC non esce dalla modalità live #

Sintomi: premere ESC su una finestra a schermo intero non esce dalla modalità live.

Soluzioni:

1. Assicurati che la finestra abbia il focus — clicca prima sulla finestra a schermo intero
2. Prova il pulsante Ferma la diretta — torna al pannello di controllo e clicca "Ferma la diretta"
3. Chiusura forzata se necessario — usa Cmd+Q (macOS) o Alt+F4 (Windows) come ultima risorsa

Problemi dell'applicazione #

FloSync non si avvia #

Soluzioni per macOS:

1. Impostazioni di sicurezza

   • Clic destro su FloSync e seleziona "Open"
   • Oppure: Impostazioni di Sistema > Privacy e sicurezza > Allow FloSync

2. Cancella le preferenze

   • Elimina: ~/Library/Application Support/com.tentekio.flosync/
   • Riavvia FloSync

Soluzioni per Windows:

1. Esegui come amministratore

   • Clic destro su FloSync > Run as administrator

2. Cancella le preferenze

   • Elimina: %APPDATA%\Tentekio\FloSync\
   • Riavvia FloSync

3. Reinstalla Visual C++ Redistributable

   • Scarica l'ultima versione dal sito Microsoft

Utilizzo elevato di CPU/memoria #

Sintomi: FloSync usa risorse di sistema eccessive.

Soluzioni:

1. Comportamento previsto — la riproduzione video richiede risorse significative
2. Riduci la risoluzione video — usa 1080p invece di 4K se il sistema fatica
3. Riduci il numero di video simultanei — in modalità Indipendente
4. Chiudi il pannello del log di sincronizzazione — il logging consuma risorse
5. Controlla i processi anomali — riavvia FloSync se il consumo di risorse non diminuisce a video fermo

Problemi con i codec video #

Se riscontri disallineamento nella sincronizzazione o riproduzione incoerente con la sincronizzazione di rete, il codec video potrebbe essere la causa.

Soluzione rapida: transcodifica il video in H.264 All-Intra per le migliori prestazioni di sincronizzazione su qualsiasi piattaforma. ProRes LT e DNxHD sono valide alternative per flussi di lavoro professionali.

Per indicazioni dettagliate su formati video, codec consigliati, file di esempio per i test e comandi di transcodifica FFmpeg, consulta la guida completa alla Preparazione video.

Problemi noti #

Limitazioni attuali #

• La modalità Esteso potrebbe non allinearsi perfettamente ai bordi delle cornici
• La sincronizzazione di rete via Wi-Fi è meno affidabile di quella via cavo
• Alcuni contenuti protetti da DRM non possono essere riprodotti
• Video ad altissima risoluzione (8K+) potrebbero non funzionare bene su tutto l'hardware
• La modalità schermo non può essere cambiata durante la modalità live (bisogna prima uscire dal live)
• Le pagine web non possono essere estese su più schermi (vengono visualizzate in Specchiato nella modalità Esteso)
• Sono supportati solo gli URL HTTPS per le pagine web (non HTTP)
• La sincronizzazione di rete funziona solo con contenuti video (immagini e pagine web non vengono sincronizzate)

Suggerimenti per le migliori prestazioni #

• Usa connessioni di rete cablate per la sincronizzazione di rete
• Mantieni i file dei contenuti su archiviazione locale (non su unità di rete)
• Usa configurazioni degli schermi coerenti tra le sessioni
• Testa la configurazione prima di presentazioni importanti
• Con la programmazione attiva, testa prima le transizioni con scene di breve durata