Crate mimick 

Handles application bootstrap, single-instance wiring, and daemon startup flow.

Initialises GTK/Libadwaita, registers the D-Bus application name for single-instance enforcement, and decides whether to present the library window or settings window based on user configuration. Background sync, tray icon, and filesystem monitor are wired up before entering the main event loop.

Modules

api_client 🔒

Integrates with the Immich API, handles connectivity failover, and provides album/cache helpers.

app_context 🔒

Consolidated application context passed through the UI and background services.

autostart 🔒

Handles autostart integration for both native installations and sandboxed Flatpak builds.

cache_manager 🔒

Unified prune + clear over every on-disk cache subdirectory.

config 🔒

Handles persistent configuration loading and provides desktop keyring access helpers.

diagnostics 🔒

Exports a support-friendly diagnostics bundle with sensitive local data redacted for privacy.

library 🔒

Library view module – browse, search, and download assets from an Immich server.

logging 🔒

media_kinds 🔒

Central registry of supported media extensions, MIME types, and asset kinds.

monitor 🔒

Provides live filesystem monitoring, file-settling checks, and checksum generation.

notifications 🔒

Provides desktop notification helpers using the GIO notification portal.

profile 🔒

Per-profile state isolation driven by the MIMICK_PROFILE env var.

queue_manager 🔒

Manages upload queue orchestration, retry persistence, and sync-index updates.

remote_sync 🔒

Periodic remote-album reconciler.

runtime_env 🔒

Provides best-effort checks of system conditions to determine when uploads should be deferred.

sanitize 🔒

Input sanitisation for file paths and URLs.

settings_window 🔒

Implements the GTK4/Libadwaita settings window and status dashboard.

sidecar 🔒

XMP sidecar file discovery.

startup_scan 🔒

Performs a startup catch-up scan for files that were missed while Mimick was not running.

state_manager 🔒

Stores persistent status snapshots to restore basic UI state across application launches.

sync_index 🔒

Maintains a persistent index of files that have been previously synced.

tray_icon 🔒

Integrates StatusNotifier tray functionality and provides GTK-facing control signals.

util 🔒

Shared filesystem and I/O utilities.

watch_path_display 🔒

Provides user-friendly display names for watch paths.

Statics

APP_CONTEXT 🔒

Shared application context reused by UI entry points and the shutdown path.

Functions

consume_flag 🔒

Atomically check and clear a cross-thread boolean flag. Returns true if the flag was set, clearing it in the process.

find_window 🔒

Helper to look up active GTK window instances by widget name.

main 🔒

open_default_window 🔒

Open whichever window the user prefers, presenting an existing instance if available.

open_library_window_now 🔒

Open Library window, falling back to Settings if disabled.

open_settings_window_now 🔒

Open Settings window or present existing settings instance.