Repository navigation
Building from source
- Qt 6.5 LTS atau lebih baru: Quick, QuickControls2, Sql, Concurrent
- CMake ≥ 3.21, compiler C++20, Ninja, SQLite3
| Paket | Untuk apa | Kalau tidak ada |
|---|---|---|
qt6-imageformats |
WebP, TIFF, TGA, WBMP, ICNS | Berkasnya tetap terindeks, thumbnail & viewer tampil placeholder |
qt6-svg-plugins |
ikon SVG dari tema desktop | Ikon jatuh ke glif teks |
mpv + mpvqt
|
pemutaran video via libmpv | Build memakai Qt Multimedia (FFmpeg) |
ffmpeg (libavformat/libavcodec/libswscale) |
poster frame video | Tanpa poster, tapi tetap bisa diputar |
| ONNX Runtime | grouping wajah (People) | Halaman People hanya menjelaskan backend tidak ada |
Di Arch/Artix:
sudo pacman -S --needed qt6-base qt6-declarative qt6-multimedia qt6-imageformats \
cmake ninja gcc sqlite ffmpeg mpv mpvqtCatatan: libmpv disediakan oleh paket mpv — tidak ada paket terpisah bernama
libmpv di Arch. Di Debian, mpvqt dipaketkan sebagai libmpvqt-dev +
libmpv-dev.
Build:
cmake -S . -B build -G Ninja
cmake --build build
./build/kin-galeri| Opsi | Default | Efek |
|---|---|---|
KG_VIDEO_BACKEND |
auto |
auto / mpv / qtmultimedia. auto memilih mpv bila tersedia, lalu Qt Multimedia. |
KG_ENABLE_MPV |
ON |
Pemutaran video via libmpv (butuh mpvqt). |
KG_ENABLE_VIDEO_THUMBS |
ON |
Poster frame video via FFmpeg. Otomatis nonaktif bila dev lib FFmpeg tidak ada. |
KG_ENABLE_MULTIMEDIA |
ON |
Pemutaran video via Qt Multimedia. |
KG_ENABLE_ML |
OFF |
Backend wajah (People) via ONNX Runtime. Butuh KG_ORT_ROOT atau ONNX Runtime terpasang. |
KG_ORT_ROOT |
– | Path ke distribusi ONNX Runtime x64 yang sudah diekstrak (CPU build, ~17 MB). |
KG_BUILD_TESTS |
OFF |
Build unit test (tests/, Qt Test + CTest). |
Dua permintaan yang eksplisit sekarang menggagalkan configure kalau tidak bisa
dipenuhi, bukan diam-diam jatuh ke alternatif: KG_ENABLE_ML=ON tanpa ONNX
Runtime, dan KG_VIDEO_BACKEND=mpv tanpa mpvqt. Alasannya ada di
Architecture.
Contoh: memaksa Qt Multimedia.
cmake -S . -B build -G Ninja -DKG_VIDEO_BACKEND=qtmultimediaContoh: mengaktifkan grouping wajah.
curl -L -o ort.tgz \
https://github.com/microsoft/onnxruntime/releases/download/v1.20.1/onnxruntime-linux-x64-1.20.1.tgz
tar xzf ort.tgz
cmake -S . -B build -G Ninja \
-DKG_ENABLE_ML=ON -DKG_ORT_ROOT="$PWD/onnxruntime-linux-x64-1.20.1"
cmake --build buildModel wajahnya tidak ikut dibundel: diunduh dari Settings → Smart atas
permintaanmu (~37 MB), lalu disimpan di <data dir>/models/.
Test memakai QTemporaryDir dan tidak menyentuh pustaka pengguna.
cmake -S . -B build-tests -G Ninja -DKG_BUILD_TESTS=ON
cmake --build build-tests
ctest --test-dir build-tests --output-on-failure./scripts/qml-lint.sh # exit 0 == nol peringatan qmllint
python3 scripts/i18n-audit.py # tiap qsTr() punya entri katalog
ctest --test-dir build-testsscripts/qml-lint.sh sengaja bukan pemanggilan qmllint langsung: banyak distro
memasang qmllint Qt 5 di /usr/bin yang membayangi Qt 6, dan script itu memilih
biner Qt 6 serta menambahkan -W 0. Detailnya di
CONTRIBUTING.md.
Skemanya v<tahun>.<minggu ISO>.<patch>, dengan patch direset setiap minggu.
Versi di CMakeLists.txt yang menentukan --version, versi paket CPack, dan
pkgver AUR — jadi itu satu-satunya tempat yang perlu diubah.
scripts/next-version.sh mencetak tag berikutnya, dan rilis ditandai manual.