Probleemoplossing
Als u een probleem ondervindt met OpenShot, zoals vastlopen, crashen of een foutmelding, zijn er verschillende technieken die nuttig kunnen zijn bij het oplossen van het probleem.
Logbestanden gebruiken om een probleem op te lossen
Een logbestand is een tekstbestand dat vastlegt wat OpenShot doet, samen met waarschuwingen en fouten. Deze bestanden kunnen het ondersteuningsteam helpen een probleem te begrijpen, zelfs als je geen foutmelding op het scherm ziet.
OpenShot bewaart twee logbestanden in de map .openshot_qt binnen je thuismap. Op Linux en macOS wordt deze locatie geschreven als ~/.openshot_qt/. De map kan verborgen zijn in je bestandsbeheerder.
Bestand |
Wat het registreert |
|---|---|
|
Activiteit in de editor: OpenShot starten, projecten laden, instellingen wijzigen en de interface gebruiken. Dit is meestal de beste plek om te beginnen bij het onderzoeken van een probleem. |
|
Activiteit in de video- en audio-engine van OpenShot, het deel dat media leest en de beelden en geluiden bouwt die worden gebruikt in previews en geëxporteerde video’s. Gedetailleerde engine-logging kan helpen bij het onderzoeken van afspeel- en exportproblemen. |
Deze bestanden registreren verschillende delen van dezelfde applicatie. Bij het melden van een probleem, voeg beide bestanden toe indien beschikbaar. Je hoeft niet elke regel zelf te begrijpen.
Kies welk deel van OpenShot je wilt loggen
Open Bewerken → Voorkeuren → Geavanceerd om deze twee instellingen te vinden:
Voorkeur |
Overeenkomend argument |
Logbestand |
|---|---|---|
Debuglogging van de gebruikersinterface |
|
|
Debuglogging van de video- en audio-engine |
|
|
Beide voorkeuren zijn standaard uitgeschakeld, wat de normale samenvattingsberichten behoudt. Het inschakelen van één voegt direct details toe aan het bijbehorende logbestand. Het verandert het andere logbestand niet en voegt geen berichten toe aan de terminal. Voorkeuren blijven ingeschakeld tussen sessies totdat je ze uitschakelt.
Debuglogging van de gebruikersinterface is een goed startpunt voor problemen met opstarten, projectladen, instellingen of de interface. Debuglogging van de video- en audio-engine voegt details toe over video- en audioprocessing, wat kan helpen bij het onderzoeken van afspeel- en exportproblemen. Engine-logs kunnen snel groeien en OpenShot vertragen. Schakel deze instelling kort in voordat je het probleem herhaalt en schakel hem daarna weer uit.
De engine-voorkeur heette eerder Debug Mode (Verbose). De opgeslagen aan/uit-instelling wordt overgenomen naar de nieuwe naam.
Gebruik een terminal voor één keer starten
Een terminal is een venster waarin je commando’s typt. De bijbehorende argumenten schakelen dezelfde extra details in als de voorkeuren, en tonen deze ook in de terminal:
openshot-qt --debug-ui
Dit registreert interface-details voor één keer starten. De bekende opties --debug en de kortere -d betekenen precies hetzelfde als --debug-ui. Voor details van de video- en audio-engine, gebruik:
openshot-qt --debug-engine
Om beide soorten details samen te verzamelen:
openshot-qt --debug-ui --debug-engine
Herhaal de stappen die het probleem veroorzaken, sluit vervolgens OpenShot en verzamel de logs. Deze argumenten veranderen je opgeslagen voorkeuren niet. OpenShot normaal starten keert terug naar je gebruikelijke loginstellingen.
openshot-qt.log start een nieuw bestand wanneer het ongeveer 25 MB bereikt en bewaart drie oudere kopieën. libopenshot.log blijft groeien naarmate er berichten worden toegevoegd. Nadat je de benodigde logs hebt opgeslagen, kun je oude logbestanden verwijderen terwijl OpenShot gesloten is.
Andere commandoregelopties
De meeste gebruikers hebben alleen de twee bovenstaande opties nodig. De volgende opties laten je kiezen hoeveel detail in de bestanden wordt opgenomen of in de terminal verschijnt. Hier betekent console de terminaluitvoer.
Optie |
Wat het doet |
|---|---|
|
Schakelt debuglogging van de gebruikersinterface in in het bestand en de terminal. |
|
Schakelt debuglogging van de video- en audio-engine in in het bestand en de terminal. |
|
Voegt editor-details toe aan |
|
Voegt editor-details toe in de terminal zonder bestandsdetails toe te voegen. |
|
Stelt het detailniveau in voor beide logs en hun terminaluitvoer. |
|
Stelt het detailniveau in voor beide logbestanden, zonder de terminalinstellingen te wijzigen. |
|
Stelt het detailniveau in de terminal in voor zowel de editor als de engine, zonder de bestandsinstellingen te wijzigen. |
Vervang LEVEL door debug voor gedetailleerde berichten of info voor de normale samenvatting. warning toont waarschuwingen en fouten; error toont fouten en kritieke storingen; critical toont alleen kritieke storingen. off stopt gewone logberichten, maar bestaande crashdiagnoses kunnen nog steeds worden geschreven. Hoofdletters zoals DEBUG werken ook.
Bijvoorbeeld, om gedetailleerde berichten in beide bestanden te verzamelen terwijl de terminal op het gebruikelijke niveau blijft:
openshot-qt --log-file-level debug
Dit schakelt ook het grote engine-logboek in, dus gebruik het kort. De oudere opties --debug-file en --debug-console werken nog steeds, ook al worden ze niet vermeld in --help.
Omgevingsvariabelen
Een omgevingsvariabele is een benoemde instelling die aan een programma wordt doorgegeven bij het starten. Deze zijn handig bij het starten van OpenShot vanuit een script of wanneer een ondersteuningsmedewerker je vraagt een bepaalde instelling te proberen. Je hoeft ze niet in te stellen voor normaal gebruik.
Variabele |
Wat het regelt |
|---|---|
|
Detail in zowel beide bestanden als de terminal. |
|
Alleen detail in beide bestanden. |
|
Alleen detail in de terminal, voor beide delen van OpenShot. |
|
Detail voor de video- en audio-engine, in het bestand en de terminal. |
|
Alleen detail in |
|
Alleen engine-detail in de terminal. |
Bijvoorbeeld, deze Linux/macOS terminalopdracht vraagt om gedetailleerde engine-logging in het bestand voor één keer opstarten:
LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt
Als instellingen overlappen, hebben opdrachtregelopties voorrang, gevolgd door omgevingsvariabelen, dan Voorkeuren, en daarna de normale standaardwaarden. Elke instelling beïnvloedt alleen de output die het beschrijft: --debug overschrijft de engine-voorkeur niet. Tijdelijke overschrijvingen wijzigen je opgeslagen voorkeuren niet. Beweeg de muis over een van de selectievakjes om te zien of een andere instelling dat logbestand beheert.
Binnen de omgevingsinstellingen hebben LIBOPENSHOT_-waarden voor de engine voorrang boven OPENSHOT_-waarden. Binnen elke groep heeft een alleen-bestand- of alleen-console-niveau voorrang boven het algemene niveau. Opdrachtregelopties volgen dezelfde bestand/console-regel. Tegenstrijdige opdrachtregel-niveaus voor dezelfde output worden afgewezen; ongeldige omgevingsniveaus worden gemeld en genegeerd.
Voor oudere scripts schakelt LIBOPENSHOT_DEBUG nog steeds gedetailleerde engine-berichten in de terminal in wanneer het aanwezig is, zelfs als de waarde 0 is. De nieuwere niveau-instellingen hebben voorrang. LIBOPENSHOT_LOG_FILE is bedoeld voor programma’s die de engine afzonderlijk gebruiken; OpenShot zelf gebruikt de bovenstaande logmap. Het wijzigen van loginstellingen verandert je voorkeur voor foutmeldingen niet.
Windows 11 reageert niet
Als u een vastloper ervaart op Windows 11, is dit een bekend probleem met PyQt5 en Windows 11, gerelateerd aan de toegankelijkheidsfuncties in Qt. Dit wordt veroorzaakt door het indrukken van Ctrl+C in OpenShot (alleen op Windows 11). OpenShot wordt dan niet meer responsief en er is ook een geheugenlek aanwezig (hoe langer OpenShot niet reageert, hoe groter het geheugenlek wordt totdat OpenShot uiteindelijk crasht of de gebruiker het proces beëindigt).
Een eenvoudige oplossing is om Ctrl+C op Windows 11 te vermijden en in plaats daarvan de kopieer-/plakmenu’s via de rechtermuisknop te gebruiken. Een andere oplossing is om de toetscombinatie voor “Kopiëren” van Ctrl+C naar iets anders te wijzigen, bijvoorbeeld Alt+C. U kunt uw toetsenbordindelingen wijzigen in de OpenShot-voorkeuren. Zie Toetsenbord.
Windows-debugging met GDB
Als u een crash of vastloper ervaart met OpenShot op Windows 10/11, helpen de volgende stapsgewijze instructies u de oorzaak van de crash te achterhalen. Deze instructies tonen een stacktrace van de broncode van OpenShot op de locatie van de crash. Deze informatie kan zeer nuttig zijn voor ons ontwikkelingsteam en is ook handig om toe te voegen aan bugrapporten (voor een snellere oplossing).
Installeer de nieuwste dagelijkse build
Download voordat u een debugger koppelt de nieuwste versie van OpenShot: https://www.openshot.org/download#daily. Installeer deze versie van OpenShot op de standaardlocatie: C:\Program Files\OpenShot Video Editor\. Voor gedetailleerde instructies over het debuggen van OpenShot op Windows, zie deze wiki.
Installeer MSYS2
De Windows-versie van OpenShot is gecompileerd met een omgeving genaamd MSYS2. Om de GDB-debugger aan onze uitvoerbare file openshot-qt.exe te koppelen, moet u eerst MSYS2 installeren. Deze stap is slechts één keer nodig.
Download en installeer MSYS2: http://www.msys2.org/
Start de opdrachtprompt
MSYS2 MinGW x64(bijvoorbeeld:C:\msys64\msys2_shell.cmd -mingw64)Werk alle pakketten bij (Kopieer/plak het volgende commando):
pacman -SyuInstalleer de GDB-debugger (Kopieer/plak het volgende commando):
pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
Start OpenShot met de GDB-debugger
Start de opdrachtprompt MSYS2 MinGW x64 (bijvoorbeeld: C:\msys64\msys2_shell.cmd -mingw64)
Werk het PATH bij (Kopieer/plak de volgende commando’s):
export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"
Laad OpenShot in de GDB-debugger (Kopieer/plak de volgende commando’s):
cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe
Start OpenShot vanuit de GDB-prompt (Kopieer/plak het volgende commando):
run --debug
Print debug-informatie
Zodra OpenShot succesvol is gestart met GDB gekoppeld, hoeft u alleen maar een crash of vastloper in OpenShot te veroorzaken. Wanneer er een crash optreedt, schakelt u terug naar de MSYS2 MinGW64-terminal en voert u een van de volgende commando’s uit (door het te typen en op ENTER te drukken). Meestal is het eerste commando bt, wat staat voor backtrace. Meer commando’s staan hieronder vermeld.
(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)
Hoge DPI / 4K Monitoren
OpenShot Video Editor biedt robuuste ondersteuning voor High DPI (Dots Per Inch) monitoren, waardoor de interface scherp oogt en gemakkelijk leesbaar is op schermen met verschillende DPI-instellingen. Deze ondersteuning is vooral nuttig op 4K-monitoren en andere schermen met hoge resolutie.
Per Monitor DPI-bewustzijn
OpenShot is DPI-bewust per monitor, wat betekent dat het de schaal dynamisch kan aanpassen afhankelijk van de DPI-instellingen van elke aangesloten monitor. Dit helpt een consistente ervaring te bieden op verschillende schermen.
DPI-schaalverdeling op Windows
Op Windows rondt OpenShot de schaalfactor af naar de dichtstbijzijnde gehele waarde om de visuele integriteit te behouden. Dit helpt visuele artefacten in de gebruikersinterface te voorkomen en houdt interface-elementen scherp en goed uitgelijnd. Door deze afronding kunnen sommige schaalopties leiden tot grotere lettertypen en UI-elementen dan verwacht.
125% schaalverdeling wordt afgerond naar 100%
150% schaalverdeling wordt afgerond naar 200%
Oplossingen voor fijnmazige aanpassing
Hoewel afronding helpt om een schone interface te behouden, zijn er oplossingen voor gebruikers die meer precieze controle over de schaalverdeling nodig hebben. Deze methoden worden niet aanbevolen vanwege mogelijke visuele artefacten:
QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
Het instellen van deze omgevingsvariabele kan afronding uitschakelen en een nauwkeurigere schaalverdeling mogelijk maken.
Opmerking: Dit kan visuele artefacten veroorzaken, vooral in de tijdlijn, en wordt niet aanbevolen.
QT_SCALE_FACTOR=1.25 (of een vergelijkbare waarde)
Het handmatig instellen van de schaalfactor kan fijnere aanpassingen aan het lettertype en de UI-schaalverdeling bieden.
Dit kan ook worden ingesteld via Voorkeuren (Schaal van de gebruikersinterface), maar verwacht rand-/lijnproblemen op Windows bij fractionele schalen.
Opmerking: Deze methode kan ook leiden tot visuele artefacten en OpenShot moeilijker in gebruik maken.
Voor meer informatie over het aanpassen van deze omgevingsvariabelen, bezoek https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.