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.

Structs

UiFlags 🔒

Cross-thread UI requests: the tray task sets them and a GTK timer consumes them. Arc<Mutex<bool>> is Send + Sync, so the flags can cross into the tray’s Tokio task while the application handle itself stays on the GTK thread.

Statics

APP_CONTEXT 🔒

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

Functions

api_key_missing 🔒

True until an API key is configured (or before the app context exists).

apply_runtime_preferences 🔒

build_api_client 🔒

API client for the enabled server URLs; warns when a URL is set without an API key.

build_queue_manager 🔒

Upload queue using the configured concurrency and pause policy (metered, battery, quiet hours).

command_line_context 🔒

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.

forward_tray_signal 🔒

Raise flag when the tray signal fired; false once the tray channel is closed.

handle_command_line 🔒

Handle command line from both the primary and secondary instances.

handle_local_deletion 🔒

Trash the remote copy of a locally deleted file, unless Mimick deleted it itself.

handle_ui_flags 🔒

Act on pending tray requests; returns Break after quitting to stop the timer.

init_logging 🔒

Mirror logs to stdout and to a rotating cache file for easier support/debugging.

install_termination_handler 🔒

Quit gracefully on SIGINT/SIGTERM, polling the signal flag from the GTK loop.

log_config 🔒

main 🔒

media_file_arguments 🔒

Collect file path arguments (positional args that are not flags) that Mimick can upload.

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.

persist_on_shutdown 🔒

Persist final state and any pending retries on graceful shutdown.

poll_ui_flags 🔒

GTK-side: poll the flags every 250ms on the main thread. The application handle stays on the GTK thread and never enters Tokio tasks.

prepare_gtk 🔒

Desktop styling, global CSS, and the hold that keeps the app running without windows.

queue_ready_file 🔒

Queue a stable file for upload unless Mimick wrote it itself or it is already synced.

refresh_connection_status 🔒

Record the initial server route and any connection error for the status page.

restored_app_state 🔒

Load persisted state, resetting volatile fields that shouldn’t survive a restart.

run_catchup_scan 🔒

Queue anything in the watch folders that isn’t synced yet.

run_file_event_loop 🔒

Queue new files and mirror local deletions reported by the folder monitor.

run_manual_sync_listener 🔒

Run a catch-up scan for each “Sync Now” request.

run_tray 🔒

Tokio-side: build the tray and forward its signals into the UI flags.

spawn_background_tasks 🔒

Start the file-event loop, catch-up scan, album reconciler, status check, and manual sync listener.

spawn_cache_prune 🔒

One-shot startup prune across every cache directory, delayed so it does not contend with window setup or initial sync work.

spawn_sync_index_flusher 🔒

Flush the sync index every 10s so a crash loses at most that much progress.

start_monitor 🔒

Keep the watcher service alive, but optionally disable active folder watches.

start_primary_instance 🔒

Set up config, API client, queue, monitor, tray, and background tasks. Runs only in the primary instance, from connect_startup.

upload_plan 🔒

(reassociate_only, checksum) for the queue, or None if the file is up to date.

wait_for_termination_signal 🔒

Wait for SIGINT or SIGTERM; false if a handler couldn’t be installed.

watch_target_for 🔒

Album target, watch root, rules, and library-only flag of the folder containing path.