Repository navigation
Troubleshooting
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:libqt6multimedia6danqml6-module-qtmultimedia. Aplikasi memaksaQT_MEDIA_BACKEND=ffmpegsaat 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.
Qt perlu plugin format gambar tambahan.
sudo pacman -S qt6-imageformats # Arch/Artix
sudo apt install qt6-image-formats-plugins # Debian/UbuntuBerkasnya tetap terindeks tanpa plugin itu — hanya thumbnail dan viewer yang gagal.
Plugin SVG belum ada:
sudo apt install qt6-svg-plugins # Debian/Ubuntu
sudo pacman -S qt6-svg # ArchAppImage sudah membawa plugin SVG dan icon engine-nya.
Butuh libheif. Kalau tidak ada, aplikasi mencoba heif-convert eksternal yang
kamu pasang sendiri. Kalau dua-duanya tidak ada, berkasnya terindeks tanpa
thumbnail.
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.
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.
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.
Dua sebab berbeda:
- Binernya dibangun tanpa ML.
kin-galeri --versionakan mencetakml: off. Build ulang dengan-DKG_ENABLE_ML=ON -DKG_ORT_ROOT=.... - 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).
Indeks pencarian penuh (FTS) bisa dibangun ulang tanpa menyentuh fotomu:
kin-galeri --rebuild-search-indexPaksa renderer software untuk memastikan apakah masalahnya di GPU:
kin-galeri --software-render
# atau
QT_QUICK_BACKEND=software kin-galeriMuncul 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.
Mode tanpa UI tidak membangun jendela, jadi:
QT_QPA_PLATFORM=offscreen kin-galeri --no-ui --index ~/PicturesTanpa QT_QPA_PLATFORM di mesin tanpa display, Qt memilih xcb dan gagal —
termasuk untuk --no-ui. --version dan --help tetap bekerja tanpa display.
| 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. |
Buka issue dan sertakan keluaran
kin-galeri --version, distribusi/paket yang dipakai, dan pesan error lengkapnya.