Skip to content

Home

Jump to bottom
Nick edited this page Jun 13, 2026 · 12 revisions

Mimick Wiki

Welcome to the Mimick project wiki.

Mimick is a Linux background app that watches selected folders and syncs photos and videos to an Immich server. It supports native Linux installs and Flatpak, uses a GTK4/Libadwaita settings window, and keeps syncing reliable with retries, startup catch-up scans, and duplicate-aware uploads.

Mimick Library View

Start Here

Installation Configuration Library View Sync Behavior Performance Screenshots Flatpak Troubleshooting

Developers and Contributors

Architecture Development Testing Release Ops Repo Automation API Docs

Project Notes

  • Mimick is a one-way sync tool. It uploads local media to Immich and does not modify local files.
  • The app stores API keys in the desktop keyring and keeps operational state in ~/.cache/mimick/.
  • Startup rescans use a local sync index so already-synced unchanged files are skipped quickly.

Current App Highlights

  • Two-page Settings / Status settings window
  • Optional in-app library viewer with albums, Explore, and search
  • Queue inspector with retry actions
  • Per-folder rules for hidden paths, size limits, and extension filters
  • Diagnostics bundle export for support and bug reports
  • Metered-network and battery-aware upload deferral

Home

Using Mimick

Building Mimick

Maintainer

Clone this wiki locally