Skip to content

Installation

mrrizkin edited this page Oct 15, 2026 · 2 revisions

Installation

Ambil berkas dari halaman Releases. Setiap rilis menyertakan SHA256SUMS; memeriksanya tidak memakan waktu:

sha256sum -c SHA256SUMS

Debian 13 / Ubuntu 26.04 ke atas — .deb

sudo apt install ./kin-galeri_2026.42.0_amd64.deb

Paket ini dikaitkan dengan pustaka Qt distro (libmpvqt1, libmpv2), ONNX Runtime distro (libonnxruntime1.21), driver libqt6sql6-sqlite, plugin SVG, dan modul QML. Semua itu nama eksplisit, karena Qt memuatnya lewat dlopen sehingga dpkg-shlibdeps tidak bisa menebaknya — penjelasannya di Packaging.

Paket dibangun di Debian 13. Distribusi yang lebih tua (Ubuntu 24.04) masih memakai Qt 6.4.2, di bawah minimum proyek (6.5), jadi paket ini bukan untuk mereka.

Arch / Artix

# dari berkas rilis
sudo pacman -U kin-galeri-git-2026.42.0-1-x86_64.pkg.tar.zst

# atau bangun sendiri dari repositori
cd packaging/arch && makepkg -si

Paket kin-galeri-git belum diterbitkan ke AUR — dan untuk sekarang memang belum bisa: registrasi akun AUR sedang ditutup sementara (pihak AUR membatasi pendaftaran karena banjir akun otomatis). Jadi dua cara di atas yang tersedia, dan tidak ada yang perlu kamu lakukan berbeda saat pendaftaran dibuka kembali.

Paket ini memakai mpvqt dan mpv dari repositori resmi, plus ONNX Runtime yang dibundel (Arch tidak punya paketnya).

AppImage (distribusi apa pun, x86_64)

chmod +x Kin_Galeri-x86_64.AppImage
./Kin_Galeri-x86_64.AppImage

AppImage membawa Qt, QML, mpvqt, dan ONNX Runtime — tapi tidak membawa libc, X11, OpenGL, font, maupun stack audio, karena itu memang kontraknya dan harus cocok dengan mesin host. Desktop Ubuntu/Fedora normal sudah punya semuanya.

Kalau muncul error while loading shared libraries: libasound.so.2, mesinnya belum punya ALSA:

# Debian/Ubuntu
sudo apt install libasound2t64
# Fedora
sudo dnf install alsa-lib

Flatpak

Bundle-nya mereferensi runtime KDE, tidak membenamkannya, jadi pasang runtime dulu sekali:

flatpak install flathub org.kde.Platform//6.8
flatpak install ./KinGaleri.flatpak
flatpak run io.github.mrrizkin.KinGaleri

Flatpak memakai Qt Multimedia untuk video (runtime KDE 6.8 tidak punya libmpv/mpvqt, dan Flatpak memang tidak boleh memakai pustaka milik host). Sisanya sama. Untuk membuka folder foto di luar direktori home aplikasi, beri izin filesystem sesuai kebutuhan, misalnya:

flatpak override --user --filesystem=host io.github.mrrizkin.KinGaleri

Lokasi data

Isi Lokasi
Database pustaka ~/.local/share/kin-galeri/library.db
Cache thumbnail ~/.cache/kin-galeri/thumbs (aman dihapus)
Preferensi ~/.config/kin/Kin Galeri.conf
Model wajah (kalau diunduh) ~/.local/share/kin-galeri/models/

Database sengaja dipisah dari folder media, supaya pustaka bisa dipindah atau di-backup tanpa merusak indeks. Semuanya mengikuti XDG_CONFIG_HOME, XDG_DATA_HOME, dan XDG_CACHE_HOME, dan bisa ditimpa dengan --db/--cache atau KG_DB_FILE/KG_CACHE_DIR.

Menjalankan pertama kali

Saat dibuka pada pustaka kosong, aplikasi otomatis memakai folder home sebagai root dan mengindeksnya (rekursif, hanya berkas media; direktori tersembunyi dan sampah teknis dilewati). Root itu bisa dihapus seperti root biasa, dan tidak akan ditambahkan lagi kalau pustaka sudah punya root. Matikan dengan --no-home-scan atau KG_NO_HOME_SCAN=1, lalu tambahkan folder sendiri dari Settings → Library.

Mencopot

sudo apt remove kin-galeri          # .deb
sudo pacman -R kin-galeri-git       # Arch
flatpak uninstall io.github.mrrizkin.KinGaleri

Menghapus paket tidak menyentuh fotomu. Database dan cache dihapus manual kalau memang mau dibuang.

Clone this wiki locally