Skip to content

Troubleshooting

mrrizkin edited this page Oct 15, 2026 · 1 revision

Troubleshooting

Video tidak mau diputar, hanya poster

Cek backend yang benar-benar dikompilasi:

kin-galeri --version
# Kin Galeri 2026.42.0 (Qt 6.8.2, video: mpv, ml: on)
  • video: qtmultimedia — jalur ini memerlukan plugin FFmpeg milik Qt. Di Arch: sudo pacman -S qt6-multimedia-ffmpeg. Di Debian: libqt6multimedia6 dan qml6-module-qtmultimedia. Aplikasi memaksa QT_MEDIA_BACKEND=ffmpeg saat startup.
  • video: mpv — libmpv dan mpvqt harus ada saat runtime: libmpvqt1 + libmpv2 (Debian), mpv + mpvqt (Arch).
  • Paket Flatpak sengaja memakai Qt Multimedia; runtime KDE 6.8 tidak membawa libmpv maupun mpvqt. Bundle Flatpak yang memasang pustaka host tidak akan diterima Flathub, dan memaksanya rapuh antar-distribusi.

Kalau kamu membangun sendiri dan ingin memastikan permintaanmu tidak diabaikan: -DKG_VIDEO_BACKEND=mpv tanpa mpvqt sekarang menggagalkan configure dengan pesan yang jelas, bukan diam-diam beralih ke Qt Multimedia.

Thumbnail kosong / placeholder (WebP, TIFF, ICNS)

Qt perlu plugin format gambar tambahan.

sudo pacman -S qt6-imageformats           # Arch/Artix
sudo apt install qt6-image-formats-plugins # Debian/Ubuntu

Berkasnya tetap terindeks tanpa plugin itu — hanya thumbnail dan viewer yang gagal.

Ikon terlihat seperti teks, atau hilang

Plugin SVG belum ada:

sudo apt install qt6-svg-plugins    # Debian/Ubuntu
sudo pacman -S qt6-svg              # Arch

AppImage sudah membawa plugin SVG dan icon engine-nya.

HEIC/HEIF tidak terbaca

Butuh libheif. Kalau tidak ada, aplikasi mencoba heif-convert eksternal yang kamu pasang sendiri. Kalau dua-duanya tidak ada, berkasnya terindeks tanpa thumbnail.

AppImage menolak start

AppImage tidak membawa libc, X11, OpenGL, font, dbus, dan stack audio. Pesan umumnya menyebut pustaka yang kurang; pesan yang sering muncul:

Pesan Pasang
libasound.so.2 libasound2t64 (Debian/Ubuntu), alsa-lib (Fedora)
libGLX.so.0 / libOpenGL.so.0 libglx0, libopengl0 (mesa di Fedora)
libfontconfig.so.1 fontconfig
libjack.so.0, libpipewire-0.3.so.0 libjack-jackd2-0, libpipewire-0.3-0

Ini memang kontraknya: AppImage memakai audio stack host supaya cocok dengan sound server yang sedang berjalan, bukan membawa salinannya sendiri.

Pustaka besar terasa kehilangan sebagian foto

Bukan hilang — ada batas jumlah item yang dimuat ke grid. Lihat Settings → Interface → "Items loaded in the grid" (0 = semua). Pada 100.000 item, batas inilah yang menjaga frame pertama tetap di bawah 1,5 detik; item di luar batas tetap ada di pustaka dan muncul begitu batasnya dinaikkan.

Foto hilang setelah dihapus

Penghapusan bersifat soft delete: masuk ke Recycle bin di sidebar dan masih bisa dikembalikan, atau dibatalkan dengan Ctrl+Z. "Kosongkan tong sampah" baru menghapus berkasnya dari disk.

Halaman People kosong, atau "Face model: not downloaded"

Dua sebab berbeda:

  1. Binernya dibangun tanpa ML. kin-galeri --version akan mencetak ml: off. Build ulang dengan -DKG_ENABLE_ML=ON -DKG_ORT_ROOT=....
  2. Modelnya belum diunduh. Buka Settings → Smart, tekan unduh (~37 MB). Tidak ada unduhan otomatis dan tidak ada trafik jaringan sebelum kamu menekannya.

Klaster wajah besar bisa memuat beberapa identitas yang mirip; penggabungan dan pemisahan klaster secara manual belum ada (rencana M5).

Pencarian tidak menemukan apa pun

Indeks pencarian penuh (FTS) bisa dibangun ulang tanpa menyentuh fotomu:

kin-galeri --rebuild-search-index

Peta memori / GPU lemah / Wayland bermasalah

Paksa renderer software untuk memastikan apakah masalahnya di GPU:

kin-galeri --software-render
# atau
QT_QUICK_BACKEND=software kin-galeri

Peringatan setHighDpiScaleFactorRoundingPolicy di terminal

Muncul di Qt 6.8 dan bukan berasal dari aplikasi ini (tidak ada pemanggilan itu di src/). Nilai yang diminta proyek — QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough — dipasang sebelum QGuiApplication, jadi penskalaan pecahan tetap berfungsi. Aman diabaikan.

Hanya berjalan sebagai GUI padahal di-SSH

Mode tanpa UI tidak membangun jendela, jadi:

QT_QPA_PLATFORM=offscreen kin-galeri --no-ui --index ~/Pictures

Tanpa QT_QPA_PLATFORM di mesin tanpa display, Qt memilih xcb dan gagal — termasuk untuk --no-ui. --version dan --help tetap bekerja tanpa display.

Masalah saat membangun sendiri

Gejala Sebab
qmllint berperilaku aneh Yang ada di /usr/bin adalah qmllint Qt 5. Pakai ./scripts/qml-lint.sh.
KG_ENABLE_ML=ON gagal configure ONNX Runtime tidak ketemu — berikan -DKG_ORT_ROOT, atau pakai libonnxruntime-dev distro.
KG_VIDEO_BACKEND=mpv gagal configure mpvqt tidak ketemu. Pasang libmpvqt-dev + libmpv-dev, atau pakai auto.
Ikon/WebP hilang setelah build sendiri Paket plugin di atas belum terpasang.

Masih bermasalah?

Buka issue dan sertakan keluaran kin-galeri --version, distribusi/paket yang dipakai, dan pesan error lengkapnya.