Pemecahan Masalah
Jika Anda mengalami masalah dengan OpenShot, seperti pembekuan, crash, atau pesan kesalahan, ada banyak teknik yang dapat berguna untuk memecahkan masalah tersebut.
Menggunakan Log untuk Memecahkan Masalah
Log adalah file teks yang merekam apa yang dilakukan OpenShot, beserta peringatan dan kesalahan. File-file ini dapat membantu tim dukungan memahami masalah, bahkan ketika Anda tidak melihat pesan kesalahan di layar.
OpenShot menyimpan dua file log di folder .openshot_qt di dalam folder home Anda. Pada Linux dan macOS, lokasi ini ditulis sebagai ~/.openshot_qt/. Folder ini mungkin tersembunyi di pengelola file Anda.
File |
Apa yang direkam |
|---|---|
|
Aktivitas di editor: memulai OpenShot, memuat proyek, mengubah pengaturan, dan menggunakan antarmuka. Ini biasanya tempat terbaik untuk memulai saat menyelidiki masalah. |
|
Aktivitas di mesin video dan audio OpenShot, bagian yang membaca media dan membangun gambar serta suara yang digunakan dalam pratinjau dan video yang diekspor. Logging mesin yang rinci dapat membantu menyelidiki masalah pemutaran dan ekspor. |
File-file ini merekam bagian yang berbeda dari aplikasi yang sama. Saat melaporkan masalah, sertakan kedua file jika tersedia. Anda tidak perlu memahami setiap baris sendiri.
Pilih bagian OpenShot mana yang akan dicatat
Buka Edit → Preferences → Advanced untuk menemukan dua pengaturan ini:
Preferensi |
Argumen yang sesuai |
File log |
|---|---|---|
Logging Debug Antarmuka Pengguna |
|
|
Logging Debug Mesin Video & Audio |
|
|
Kedua preferensi ini mati secara default, yang menjaga pesan ringkasan normal. Mengaktifkan salah satunya langsung menambahkan detail ke file lognya. Ini tidak mengubah log lain atau menambahkan pesan ke terminal. Preferensi tetap aktif antar peluncuran sampai Anda mematikannya.
Logging Debug Antarmuka Pengguna adalah titik awal yang baik untuk masalah dengan startup, pemuatan proyek, pengaturan, atau antarmuka. Logging Debug Mesin Video & Audio menambahkan detail tentang pemrosesan video dan audio, yang dapat membantu menyelidiki masalah pemutaran dan ekspor. Log mesin dapat tumbuh sangat cepat dan mungkin memperlambat OpenShot. Aktifkan pengaturan ini sesaat sebelum mengulangi masalah, lalu matikan setelahnya.
Preferensi mesin sebelumnya disebut Debug Mode (Verbose). Pengaturan nyala/mati yang disimpan dibawa ke nama baru.
Gunakan terminal untuk satu peluncuran
Terminal adalah jendela tempat Anda mengetik perintah. Argumen yang sesuai mengaktifkan detail tambahan yang sama seperti preferensi, dan juga menampilkannya di terminal:
openshot-qt --debug-ui
Ini merekam detail antarmuka untuk satu peluncuran. Opsi --debug yang dikenal dan versi pendek -d berarti persis sama dengan --debug-ui. Untuk detail mesin video dan audio, gunakan:
openshot-qt --debug-engine
Untuk mengumpulkan kedua jenis detail bersama-sama:
openshot-qt --debug-ui --debug-engine
Ulangi langkah-langkah yang menyebabkan masalah, lalu tutup OpenShot dan kumpulkan lognya. Argumen ini tidak mengubah preferensi yang Anda simpan. Memulai OpenShot secara normal akan kembali ke pengaturan logging biasa Anda.
openshot-qt.log memulai file baru ketika mencapai sekitar 25 MB dan menyimpan tiga salinan lama. libopenshot.log terus bertambah saat pesan ditambahkan. Setelah menyimpan log yang Anda butuhkan, Anda dapat menghapus file log lama saat OpenShot ditutup.
Opsi baris perintah lainnya
Sebagian besar pengguna hanya membutuhkan dua kontrol di atas. Opsi berikut memungkinkan Anda memilih seberapa banyak detail yang masuk ke file atau muncul di terminal. Di sini, console berarti keluaran terminal.
Opsi |
Fungsinya |
|---|---|
|
Mengaktifkan Logging Debug Antarmuka Pengguna di file dan terminalnya. |
|
Mengaktifkan Logging Debug Mesin Video & Audio di file dan terminalnya. |
|
Menambahkan detail editor ke |
|
Menambahkan detail editor di terminal tanpa menambahkan detail file. |
|
Mengatur tingkat detail untuk kedua log dan keluaran terminalnya. |
|
Mengatur tingkat detail untuk kedua file log, tanpa mengubah pengaturan terminal. |
|
Mengatur detail di terminal untuk editor dan engine, tanpa mengubah pengaturan file. |
Ganti LEVEL dengan debug untuk pesan rinci atau info untuk ringkasan normal. warning menampilkan peringatan dan kesalahan; error menampilkan kesalahan dan kegagalan kritis; critical hanya menampilkan kegagalan kritis. off menghentikan pesan log biasa, tetapi diagnostik crash yang ada mungkin masih ditulis. Nama huruf besar seperti DEBUG juga berlaku.
Misalnya, untuk mengumpulkan pesan rinci di kedua file sambil menjaga terminal pada tingkat biasanya:
openshot-qt --log-file-level debug
Ini juga mengaktifkan log engine besar, jadi gunakan sebentar saja. Opsi lama --debug-file dan --debug-console masih berfungsi meskipun tidak tercantum di --help.
Variabel lingkungan
Variabel lingkungan adalah pengaturan bernama yang diteruskan ke program saat dimulai. Ini berguna saat memulai OpenShot dari skrip atau ketika petugas dukungan meminta Anda mencoba pengaturan tertentu. Anda tidak perlu mengaturnya untuk penggunaan normal.
Variabel |
Apa yang dikontrolnya |
|---|---|
|
Detail di kedua file dan terminal. |
|
Detail hanya di kedua file. |
|
Detail hanya di terminal, untuk kedua bagian OpenShot. |
|
Detail untuk engine video dan audio, di file dan terminalnya. |
|
Detail hanya di |
|
Detail engine hanya di terminal. |
Misalnya, perintah terminal Linux/macOS ini meminta pencatatan engine rinci di file-nya untuk satu peluncuran:
LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt
Jika pengaturan tumpang tindih, opsi baris perintah memiliki prioritas, diikuti oleh variabel lingkungan, kemudian Preferensi, lalu default normal. Setiap kontrol hanya memengaruhi output yang dijelaskannya: --debug tidak menggantikan preferensi engine. Penggantian sementara tidak mengubah preferensi yang disimpan. Arahkan kursor ke salah satu kotak centang untuk melihat apakah pengaturan lain mengontrol file log tersebut.
Dalam pengaturan lingkungan, nilai LIBOPENSHOT_ memiliki prioritas atas nilai OPENSHOT_ untuk engine. Dalam setiap grup, tingkat hanya file atau hanya konsol memiliki prioritas atas tingkat umum. Opsi baris perintah mengikuti aturan file/konsol yang sama. Tingkat baris perintah yang bertentangan untuk output yang sama ditolak; tingkat lingkungan yang tidak valid dilaporkan dan diabaikan.
Untuk skrip lama, LIBOPENSHOT_DEBUG masih mengaktifkan pesan engine rinci di terminal kapan pun ada, bahkan jika nilainya 0. Pengaturan tingkat yang lebih baru memiliki prioritas atasnya. LIBOPENSHOT_LOG_FILE ditujukan untuk program yang menggunakan engine secara terpisah; OpenShot sendiri menggunakan folder log di atas. Mengubah pengaturan pencatatan tidak mengubah preferensi pelaporan kesalahan Anda.
Windows 11 Tidak Merespons
Jika Anda mengalami pembekuan di Windows 11, ini adalah masalah yang diketahui dengan PyQt5 dan Windows 11, terkait dengan fitur aksesibilitas di Qt. Ini dipicu dengan menekan Ctrl+C di OpenShot (hanya di Windows 11). OpenShot akan menjadi tidak responsif dan kebocoran memori juga terjadi (yaitu semakin lama OpenShot tidak responsif, semakin besar kebocoran memori hingga OpenShot akhirnya crash atau pengguna menghentikan proses).
Solusi sederhana adalah menghindari Ctrl+C di Windows 11, dan sebaliknya gunakan menu Salin/Tempel klik kanan. Solusi lain adalah memetakan ulang "Salin" dari Ctrl+C ke tombol lain, misalnya Alt+C. Anda dapat mengubah pemetaan keyboard di Preferensi OpenShot. Lihat Keyboard.
Debugging Windows dengan GDB
Jika Anda mengalami crash atau pembekuan dengan OpenShot di Windows 10/11, petunjuk langkah demi langkah berikut akan membantu Anda menentukan penyebab crash. Petunjuk ini akan menampilkan jejak tumpukan kode sumber OpenShot, di lokasi crash. Informasi ini sangat berguna untuk tim pengembangan kami, dan sangat berguna untuk dilampirkan pada laporan bug (untuk penyelesaian yang lebih cepat).
Pasang Versi Harian Terbaru
Sebelum melampirkan debugger, silakan unduh versi terbaru OpenShot: https://www.openshot.org/download#daily. Pasang versi OpenShot ini ke lokasi default: C:\Program Files\OpenShot Video Editor\. Untuk instruksi detail tentang debugging OpenShot di Windows, silakan lihat wiki ini.
Pasang MSYS2
Versi Windows dari OpenShot dikompilasi menggunakan lingkungan bernama MSYS2. Untuk melampirkan debugger GDB ke executable kami, openshot-qt.exe, Anda harus memasang MSYS2 terlebih dahulu. Langkah ini hanya diperlukan sekali.
Unduh & Pasang MSYS2: http://www.msys2.org/
Jalankan command prompt
MSYS2 MinGW x64(misalnya:C:\msys64\msys2_shell.cmd -mingw64)Perbarui semua paket (Salin/Tempel perintah berikut):
pacman -SyuPasang debugger GDB (Salin/Tempel perintah berikut):
pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain
Jalankan OpenShot dengan Debugger GDB
Jalankan command prompt MSYS2 MinGW x64 (misalnya: C:\msys64\msys2_shell.cmd -mingw64)
Perbarui PATH (Salin/Tempel perintah berikut):
export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"
Muat OpenShot ke debugger GDB (Salin/Tempel perintah berikut):
cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe
Jalankan OpenShot dari prompt GDB (Salin/Tempel perintah berikut):
run --debug
Cetak Info Debugging
Setelah OpenShot berhasil dijalankan dengan GDB terpasang, yang perlu Anda lakukan adalah memicu crash atau pembekuan di OpenShot. Ketika crash terjadi, kembali ke terminal MSYS2 MinGW64 dan jalankan salah satu perintah berikut (dengan mengetiknya dan menekan ENTER). Biasanya, perintah pertama yang dimasukkan adalah bt, yang berarti backtrace. Perintah lainnya tercantum di bawah.
(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)
DPI Tinggi / Monitor 4K
OpenShot Video Editor menyediakan dukungan kuat untuk monitor DPI Tinggi (Dots Per Inch), memastikan antarmuka terlihat tajam dan mudah dibaca pada layar dengan berbagai pengaturan DPI. Dukungan ini sangat berguna pada monitor 4K dan layar resolusi tinggi lainnya.
Kesadaran DPI Per Monitor
OpenShot menyadari DPI berdasarkan setiap monitor, artinya dapat menyesuaikan skala secara dinamis tergantung pada pengaturan DPI dari setiap monitor yang terhubung. Ini membantu memberikan pengalaman yang konsisten di berbagai layar.
Skala DPI di Windows
Di Windows, OpenShot membulatkan faktor skala ke nilai bulat terdekat untuk menjaga integritas visual. Ini membantu menghindari artefak visual pada UI dan menjaga elemen antarmuka tetap tajam dan teratur. Karena pembulatan ini, beberapa opsi skala dapat menyebabkan font dan elemen UI menjadi lebih besar dari yang diharapkan.
Skala 125% dibulatkan menjadi 100%
Skala 150% dibulatkan menjadi 200%
Solusi untuk Penyesuaian Halus
Meskipun pembulatan membantu menjaga antarmuka tetap bersih, ada solusi bagi pengguna yang membutuhkan kontrol lebih tepat atas skala. Metode ini tidak disarankan karena potensi artefak visual:
QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
Mengatur variabel lingkungan ini dapat menonaktifkan pembulatan dan memungkinkan skala yang lebih tepat.
Catatan: Ini dapat menyebabkan artefak visual, terutama di timeline, dan tidak disarankan.
QT_SCALE_FACTOR=1.25 (atau nilai serupa)
Mengatur faktor skala secara manual dapat memberikan penyesuaian lebih halus pada skala font dan UI.
Ini juga dapat diatur melalui Preferensi (Skala Antarmuka Pengguna), tetapi harapkan masalah garis/batas pada Windows dengan skala pecahan.
Catatan: Metode ini juga dapat menyebabkan artefak visual dan membuat OpenShot lebih sulit digunakan.
Untuk informasi lebih lanjut tentang penyesuaian variabel lingkungan ini, silakan kunjungi https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.