Chapter 12: System Configuration


12.1 Accessing Settings

Navigation Path: Sidebar menu → Settings (Preferences)

The settings page is divided into 6 tabs: Scan Settings, Index Settings, Editor (visible in desktop version), System Settings, Data Rebuild, AI Configuration.


12.2 Scan Settings

Image Format Selection

Divided into three independent format groups, each can be toggled separately:

  • WEB Formats: JPEG, PNG, BMP, GIF, WebP, AVIF, TIFF, ICO
  • HEIF Formats: HEIC, HEIF
  • RAW Formats: CR2, CR3, NEF, ARW, DNG, ORF, etc.

Minimum Image Size

Set the minimum pixel threshold; images smaller than this size will be ignored.

  • Default: 96 px
  • Can be used to filter out thumbnails, icons, and other small images

Ignore Rules

Add rules to exclude specific folders or files:

Rule Types:

TypeMatching MethodExample
ContainsPath contains specified textcache
GlobWildcard pattern*.thumb
RegexRegular expression^temp

12.3 Index Settings

SettingDescription
Auto-refresh indexAutomatically update index on file changes
Auto-delete missingAutomatically clean up records of non-existent files
Auto-resume indexResume incomplete index tasks on startup

Cluster thresholds (similarity classification threshold, duplicate image threshold, face grouping threshold) can be configured via the config button in this tab.


12.4 AI Configuration

Inference Engine Settings

SettingOptionsDescription
Inference DeviceAuto / CPU / GPUSelect AI compute device
Processing ModeAuto / Sequential / ParallelPhoto processing method
Inference CapabilitiesBasic / Face / Text / Semantic / AllEnabled AI features

In model configuration, you can choose between the base model and the large model. The large model offers better understanding capabilities but requires an additional ~1.5 GB download. The index must be rebuilt after switching models.

Face Settings

SettingDescription
Face box scalingControls face cropping range
Crop to squareWhether to crop faces as squares

12.5 Editor Configuration

In the desktop version, external programs can be specified in settings as the image viewer and editor:

  • Image viewer path
  • Image editor path
  • Use the file selection button to specify the program location

12.6 System Settings

FeatureDescription
FFmpeg Download/InstallFor HEIC/HEIF support and video processing
Open Log FileView application runtime logs
Open Data DirectoryOpen the data directory in file manager
Optimize DatabaseCompact database, improve query performance
Reset DatabaseClear all data (use with caution)
Check for UpdatesManually check for new software versions

12.7 Data Rebuild

When data is abnormal or search results are inaccurate, use the data rebuild feature:

OperationDescription
Rebuild IndexFull rebuild: reset index and re-execute the complete indexing process
Rebuild GroupsSupports three sub-options: Faces / Locations / Images, or click All for one-click rebuild
AI Data RebuildChoose one from OCR / Blur Quality / Semantic Features to rebuild
Rebuild EXIFRe-extract EXIF metadata for all photos

Rebuild operations may take a long time; it is recommended to perform them during idle time.


Next Step: Read Chapter 13 to learn about software activation.