Risoluzione dei problemi

Se riscontri un problema con OpenShot, come un blocco, un arresto anomalo o un messaggio di errore, esistono diverse tecniche utili per risolvere il problema.

Utilizzo dei log per risolvere un problema

Un log è un file di testo che registra ciò che OpenShot sta facendo, insieme ad avvisi ed errori. Questi file possono aiutare il team di supporto a comprendere un problema, anche quando non vedi un messaggio di errore sullo schermo.

OpenShot conserva due file di log nella cartella .openshot_qt all’interno della tua cartella home. Su Linux e macOS, questa posizione è indicata come ~/.openshot_qt/. La cartella potrebbe essere nascosta nel tuo gestore di file.

I due file di log
File	Cosa registra
`openshot-qt.log`	Attività nell’editor: avvio di OpenShot, caricamento dei progetti, modifica delle impostazioni e utilizzo dell’interfaccia. Questo è solitamente il punto migliore da cui iniziare quando si indaga su un problema.
`libopenshot.log`	Attività nel motore video e audio di OpenShot, la parte che legge i media e costruisce le immagini e i suoni usati nelle anteprime e nei video esportati. Un logging dettagliato del motore può aiutare a investigare problemi di riproduzione ed esportazione.

Questi file registrano parti diverse della stessa applicazione. Quando segnali un problema, includi entrambi i file se disponibili. Non è necessario comprendere ogni riga personalmente.

Scegli quale parte di OpenShot registrare

Apri Modifica → Preferenze → Avanzate per trovare queste due impostazioni:

Preferenze e opzioni corrispondenti del terminale
Preferenza	Argomento corrispondente	File di log
Registrazione debug dell’interfaccia utente	`--debug-ui`	`openshot-qt.log`
Registrazione debug del motore video e audio	`--debug-engine`	`libopenshot.log`

Entrambe le preferenze sono disattivate per impostazione predefinita, mantenendo i normali messaggi di riepilogo. Attivandone una si aggiungono immediatamente dettagli al relativo file di log. Non modifica l’altro log né aggiunge messaggi al terminale. Le preferenze rimangono attive tra un avvio e l’altro finché non le disattivi.

La registrazione debug dell’interfaccia utente è un buon punto di partenza per problemi con l’avvio, il caricamento dei progetti, le impostazioni o l’interfaccia. La registrazione debug del motore video e audio aggiunge dettagli sul processamento video e audio, che possono aiutare a investigare problemi di riproduzione ed esportazione. I log del motore possono crescere molto rapidamente e rallentare OpenShot. Attiva questa impostazione poco prima di ripetere il problema, quindi disattivala dopo.

La preferenza del motore era precedentemente chiamata Modalità Debug (Verboso). La sua impostazione salvata on/off viene mantenuta con il nuovo nome.

Usa un terminale per un avvio

Un terminale è una finestra dove si digitano comandi. Gli argomenti corrispondenti abilitano gli stessi dettagli extra delle preferenze e li mostrano anche nel terminale:

openshot-qt --debug-ui

Questo registra i dettagli dell’interfaccia per un avvio. Le opzioni familiari --debug e la più breve -d significano esattamente la stessa cosa di --debug-ui. Per i dettagli del motore video e audio, usa:

openshot-qt --debug-engine

Per raccogliere entrambi i tipi di dettaglio insieme:

openshot-qt --debug-ui --debug-engine

Ripeti i passaggi che causano il problema, poi chiudi OpenShot e raccogli i log. Questi argomenti non modificano le preferenze salvate. Avviando OpenShot normalmente si torna alle impostazioni di logging abituali.

openshot-qt.log crea un nuovo file quando raggiunge circa 25 MB e mantiene tre copie più vecchie. libopenshot.log continua a crescere man mano che vengono aggiunti messaggi. Dopo aver salvato i log necessari, puoi rimuovere i vecchi file di log mentre OpenShot è chiuso.

Altre opzioni da riga di comando

La maggior parte degli utenti ha bisogno solo dei due controlli sopra. Le opzioni seguenti ti permettono di scegliere quanta dettagliata informazione va nei file o appare nel terminale. Qui, console significa l’output del terminale.

Opzioni di logging
Opzione	Cosa fa
`--debug-ui`, `--debug` o `-d`	Abilita la registrazione debug dell’interfaccia utente nel suo file e nel terminale.
`--debug-engine`	Abilita la registrazione debug del motore video e audio nel suo file e nel terminale.
`--debug-file`	Aggiunge dettagli dell’editor a `openshot-qt.log` senza aggiungere dettagli nel terminale.
`--debug-console`	Aggiunge dettagli dell’editor nel terminale senza aggiungere dettagli nei file.
`--log-level LEVEL`	Imposta il livello di dettaglio per entrambi i log e il loro output nel terminale.
`--log-file-level LEVEL`	Imposta il livello di dettaglio per entrambi i file di log, lasciando inalterate le impostazioni del terminale.
`--log-console-level LEVEL`	Imposta il livello di dettaglio nel terminale sia per l’editor che per il motore, senza modificare le impostazioni dei file.

Sostituisci LEVEL con debug per messaggi dettagliati o info per il riepilogo normale. warning mostra avvisi ed errori; error mostra errori e guasti critici; critical mostra solo guasti critici. off interrompe i messaggi di log ordinari, ma le diagnostiche di crash esistenti possono ancora essere scritte. Funzionano anche nomi in maiuscolo come DEBUG.

Ad esempio, per raccogliere messaggi dettagliati in entrambi i file mantenendo il terminale al suo livello abituale:

openshot-qt --log-file-level debug

Questo abilita anche il log esteso del motore, quindi usalo per poco tempo. Le vecchie opzioni --debug-file e --debug-console funzionano ancora anche se non sono elencate in --help.

Variabili d’ambiente

Una variabile d’ambiente è un’impostazione nominata passata a un programma all’avvio. Sono utili quando si avvia OpenShot da uno script o quando un tecnico di supporto ti chiede di provare una particolare impostazione. Non è necessario impostarle per l’uso normale.

Impostazioni opzionali dell’ambiente
Variabile	Cosa controlla
`OPENSHOT_LOG_LEVEL`	Dettaglio in entrambi i file e nel terminale.
`OPENSHOT_LOG_FILE_LEVEL`	Dettaglio solo in entrambi i file.
`OPENSHOT_LOG_CONSOLE_LEVEL`	Dettaglio solo nel terminale, per entrambe le parti di OpenShot.
`LIBOPENSHOT_LOG_LEVEL`	Dettaglio per il motore video e audio, nel suo file e nel terminale.
`LIBOPENSHOT_LOG_FILE_LEVEL`	Dettaglio solo in `libopenshot.log`.
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	Dettaglio del motore solo nel terminale.

Ad esempio, questo comando da terminale Linux/macOS richiede il log dettagliato del motore nel suo file per un avvio:

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Se le impostazioni si sovrappongono, le opzioni da linea di comando hanno la priorità, seguite dalle variabili d’ambiente, poi dalle Preferenze, infine dai valori predefiniti normali. Ogni controllo influenza solo l’output che descrive: --debug non sovrascrive la preferenza del motore. Le sovrascritture temporanee non modificano le preferenze salvate. Passa il mouse su una qualsiasi casella di controllo per vedere se un’altra impostazione sta controllando quel file di log.

Nelle impostazioni d’ambiente, i valori LIBOPENSHOT_ hanno priorità sui valori OPENSHOT_ per il motore. All’interno di ciascun gruppo, un livello solo file o solo console ha priorità sul livello generale. Le opzioni da linea di comando seguono la stessa regola file/console. Livelli da linea di comando in conflitto per lo stesso output vengono rifiutati; livelli d’ambiente non validi vengono segnalati e ignorati.

Per script più vecchi, LIBOPENSHOT_DEBUG abilita ancora messaggi dettagliati del motore nel terminale ogni volta che è presente, anche se il suo valore è 0. Le nuove impostazioni di livello hanno priorità su di esso. LIBOPENSHOT_LOG_FILE è destinato a programmi che usano il motore separatamente; OpenShot stesso usa la cartella di log sopra indicata. Cambiare le impostazioni di logging non modifica la tua preferenza di segnalazione errori.

Windows 11 non risponde

Se riscontri un blocco su Windows 11, si tratta di un problema noto con PyQt5 e Windows 11, legato alle funzionalità di accessibilità in Qt. Questo si verifica premendo Ctrl+C in OpenShot (solo su Windows 11). OpenShot diventerà non rispondente e sarà presente anche una perdita di memoria (cioè, più a lungo OpenShot non risponde, maggiore sarà la perdita di memoria fino a quando OpenShot non si bloccherà definitivamente o l’utente terminerà il processo).

Una soluzione semplice è evitare Ctrl+C su Windows 11 e utilizzare invece i menu Copia/Incolla con il tasto destro. Un’altra soluzione è rimappare il comando «Copia» da Ctrl+C a un altro tasto, ad esempio Alt+C. Puoi modificare le mappature della tastiera nelle Preferenze di OpenShot. Vedi Tastiera.

Debug di Windows con GDB

Se riscontri un arresto anomalo o un blocco con OpenShot su Windows 10/11, le seguenti istruzioni passo passo ti aiuteranno a determinare la causa del problema. Queste istruzioni mostreranno una traccia dello stack del codice sorgente di OpenShot, nel punto in cui si è verificato il crash. Queste informazioni possono essere estremamente utili per il nostro team di sviluppo e molto utili da allegare ai report di bug (per una risoluzione più rapida).

Installa l’ultima versione Daily Build

Prima di collegare un debugger, scarica la versione più recente di OpenShot: https://www.openshot.org/download#daily. Installa questa versione di OpenShot nella posizione predefinita: C:\Program Files\OpenShot Video Editor\. Per istruzioni dettagliate sul debug di OpenShot su Windows, consulta questa wiki.

Installa MSYS2

La versione Windows di OpenShot è compilata usando un ambiente chiamato MSYS2. Per collegare il debugger GDB al nostro eseguibile, openshot-qt.exe, devi prima installare MSYS2. Questo passaggio è richiesto una sola volta.

Scarica e installa MSYS2: http://www.msys2.org/
Esegui il prompt dei comandi MSYS2 MinGW x64 (per esempio: C:\msys64\msys2_shell.cmd -mingw64)
Aggiorna tutti i pacchetti (Copia/Incolla il seguente comando):
```
pacman -Syu
```

Installa il debugger GDB (Copia/Incolla il seguente comando):

pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain

Avvia OpenShot con il debugger GDB

Esegui il prompt dei comandi MSYS2 MinGW x64 (per esempio: C:\msys64\msys2_shell.cmd -mingw64)

Aggiorna il PATH (Copia/Incolla i seguenti comandi):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

Carica OpenShot nel debugger GDB (Copia/Incolla i seguenti comandi):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

Avvia OpenShot dal prompt GDB (Copia/Incolla il seguente comando):

run --debug

Stampa informazioni di debug

Una volta che OpenShot è stato avviato con successo con GDB collegato, devi solo provocare un crash o un blocco in OpenShot. Quando si verifica un crash, torna al terminale MSYS2 MinGW64 ed esegui uno dei seguenti comandi (digitandolo e premendo INVIO). Di solito, il primo comando da inserire è bt, che sta per backtrace. Altri comandi sono elencati di seguito.

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

Monitor ad alta DPI / 4K

OpenShot Video Editor offre un supporto solido per i monitor ad alta DPI (punti per pollice), garantendo che l’interfaccia appaia nitida e facilmente leggibile su schermi con diverse impostazioni DPI. Questo supporto è particolarmente utile su monitor 4K e altri display ad alta risoluzione.

Consapevolezza DPI per monitor

OpenShot riconosce il DPI per ogni singolo monitor, il che significa che può regolare dinamicamente la scala in base alle impostazioni DPI di ciascun monitor collegato. Questo aiuta a fornire un’esperienza coerente su diversi schermi.

Scala DPI su Windows

Su Windows, OpenShot arrotonda il fattore di scala al valore intero più vicino per mantenere l’integrità visiva. Questo aiuta a evitare artefatti visivi nell’interfaccia e mantiene gli elementi dell’interfaccia nitidi e ben allineati. A causa di questo arrotondamento, alcune opzioni di scala possono portare a caratteri e elementi dell’interfaccia più grandi del previsto.

La scala al 125% viene arrotondata a 100%
La scala al 150% viene arrotondata a 200%

Soluzioni alternative per regolazioni più precise

Sebbene l’arrotondamento aiuti a mantenere un’interfaccia pulita, esistono soluzioni alternative per gli utenti che necessitano di un controllo più preciso sulla scala. Questi metodi non sono raccomandati a causa di potenziali artefatti visivi:

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Impostare questa variabile d’ambiente può disabilitare l’arrotondamento e consentire una scala più precisa.
- Nota: Questo può causare artefatti visivi, in particolare nella timeline, e non è raccomandato.
QT_SCALE_FACTOR=1.25 (o valore simile)
- Impostare manualmente il fattore di scala può fornire regolazioni più precise per la scala dei caratteri e dell’interfaccia.
- Questo può anche essere impostato tramite Preferenze (Scala interfaccia utente), ma aspettati problemi di bordi/linee su Windows con scale frazionarie.
- Nota: Questo metodo può anche causare artefatti visivi e rendere OpenShot più difficile da usare.

Per maggiori informazioni sulla regolazione di queste variabili d’ambiente, visita https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.