Risoluzione dei problemi

Questa guida raccoglie i problemi più comuni che si possono incontrare con FloSync e come risolverli. Se il 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, ricostruire cosa è accaduto 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 garantisce uno storico sufficiente per la diagnosi senza occupare eccessivo 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 pianificata
• 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 — apri la cartella della data e seleziona il file di log dell'ora corrispondente
4. Cerca gli errori — filtra le voci contrassegnate con "ERROR" o "WARN"
5. Esamina il contesto — leggi le voci precedenti e successive all'errore per ricostruire la sequenza degli eventi

Quando si contatta il supporto, allegare i file di log pertinenti accelera notevolmente 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

   • Accertati di avere accesso in lettura al file
   • Se il file si trova su una condivisione di rete, prova a copiarlo su un'unità locale

3. Limitazioni SVG

   • Alcune funzionalità SVG complesse potrebbero non essere renderizzate correttamente
   • Se l'SVG non viene visualizzato correttamente, prova a convertirlo in PNG

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)
   • Verifica che l'URL inizi con https://

2. Connettività di rete

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

3. Il sito blocca l'incorporamento

   • Alcuni siti impediscono di essere incorporati in una WebView
   • Prova con un sito diverso oppure 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 più avanti
   • 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 il file in un formato standard come MP4

3. Permessi sul file

   • Accertati di avere accesso in lettura al file video
   • Se il file si trova su una condivisione di rete, prova a copiarlo su un'unità locale

Il video va a scatti o perde fotogrammi #

Sintomi: la riproduzione non è fluida.

Soluzioni:

1. Controlla l'utilizzo di CPU/GPU — se è al massimo, l'hardware potrebbe non reggere la risoluzione del video
2. Usa un SSD — i dischi meccanici potrebbero non avere throughput sufficiente per video ad alto bitrate
3. Riduci la risoluzione video — ricodifica a una risoluzione inferiore se l'hardware è in difficoltà
4. Chiudi le altre applicazioni — libera risorse di sistema
5. Verifica 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 sistema operativo

2. Controlla i cavi

   • Prova cavi diversi
   • Prova porte diverse sul computer

3. Riavvia FloSync dopo aver collegato i 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 sistema operativo

   • 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 diretta, il contatore delle correzioni di sincronizzazione indica quante ne sono state effettuate:
   • Conteggi bassi sono normali nelle sessioni prolungate
   • Conteggi ripetuti o in rapida crescita 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 riprendi

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

   • Il client deve avere lo stesso video caricato
   • Se le durate differiscono, la sincronizzazione non funzionerà

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 può 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 sfasato di 50–100 ms e non si corregge 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 in tempo reale. Il fenomeno riguarda tutti i sistemi di sincronizzazione basati sull'orologio, non solo FloSync.

Soluzione: riavvia entrambi i computer. Per le installazioni non presidiate, pianifica un riavvio giornaliero nelle ore di inattività — vedi Pianificare 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. Analizza il log di sincronizzazione per individuare pattern ricorrenti

Problemi di Go Live #

Le finestre a schermo intero non compaiono #

Sintomi: fare clic su Go Live non crea finestre a schermo intero sugli schermi.

Soluzioni:

1. Controlla il rilevamento degli schermi

   • Accertati che gli schermi siano rilevati (devono comparire nell'area di disposizione)
   • 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 avviare il Go Live
   • Verifica la presenza di indicatori di video mancante

3. Controlla i permessi

   • Su macOS, verifica 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 diretta.

Soluzioni:

1. Accertati che la finestra abbia il focus — fai clic sulla finestra a schermo intero prima di premere ESC
2. Usa il pulsante Ferma la diretta — torna al pannello di controllo e fai clic su "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

   • Fai clic con il tasto destro su FloSync e seleziona "Apri"
   • Oppure: Impostazioni di Sistema > Privacy e sicurezza > Consenti 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 la versione più recente 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 è in difficoltà
3. Riduci il numero di video simultanei — in modalità Indipendente
4. Chiudi il pannello del log di sincronizzazione — il logging consuma alcune risorse
5. Controlla i processi anomali — riavvia FloSync se il consumo di risorse non scende anche 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 correttamente su tutto l'hardware
• La modalità schermo non può essere cambiata durante la diretta — è necessario uscire prima dal live
• Le pagine web non possono essere estese su più schermi (vengono visualizzate in modalità Specchiato anche in 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)

Consigli 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 eventi importanti
• Con la pianificazione attiva, testa le transizioni usando scene di breve durata