CHANGELOG.md

Rama main · réplica de lectura del repositorio original.

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [9.15.0] - 2026-11-10

### Added

- **Ctrl+A** now selects every photo in the view, in Photos, albums, and every other grid, instead of only the ones already loaded: Mimick loads the rest first, with a note while it does.
- The selection bar has a **Favorite** button (a filled heart unfavorites when all of them already are), and its **⋯** menu, now shown at every width, adds **Edit Description…**, **Refresh Faces**, **Refresh Metadata**, **Refresh Thumbnails**, and **Refresh Video** for the selected photos you own. Menu items show their icons.
- Added the GNOME style switcher to the top of the main menu: round **Follow System**, **Light**, and **Dark** buttons, and under them a swatch for each palette of the style showing: **Default**, **Warm White**, **Lavender**, or **Mint** when light, and **Default**, **Black** (pure black, for OLED screens), **Midnight**, or **Mocha** when dark. Settings → **Appearance** has the same **Style**, **Light Theme**, and **Dark Theme** choices; with **Follow System**, Mimick switches between your two palettes as the system does.
- **Ctrl+,** opens Settings, and Settings has an **Open Library** button once your API key is saved.
- **About Mimick** is now in the library's main menu too, and shows **What's New** for this version, links to the website, source, documentation, and **Support Questions** (GitHub Discussions), and, under **Troubleshooting**, debug info to paste into a bug report: Mimick, GTK, and libadwaita versions, how it's installed, the desktop, and the graphics renderer.
- Added **Detailed Logs** to Settings → Troubleshooting, and **Export Diagnostics** now includes the end of the log, with the API key, server addresses, and your home folder replaced. New bug-report and feature-request forms on GitHub ask for both.
- The Folders page expands a folder in place to show what's inside, with an **Open** button to step into it. Each folder's menu (right-click, long-press, or Shift+F10) has **Copy Path**; the toolbar copies the open folder's path, and **Enter a path** (**Ctrl+L**) takes a typed or pasted path, suggesting folders as you type, with **Tab** completing.
- Choosing a new profile picture, from Account or a photo's **Set as Profile Picture**, now lets you crop it first: drag the photo in the round frame, and zoom with the slider, a pinch, the scroll wheel, or **+** and **−**.
- Videos flash a play or pause badge in the middle as they start and stop, and **Up** and **Down** turn the volume up and down, showing the level.
- Added **OpenTopoMap** and **Humanitarian** to the map's styles.
- Menus opened from a photo, album, face, stack, or folder show an icon beside each item.
- Each tag on the Tags page has **Rename**, **Change Color**, and **Delete** buttons, and **New Tag** has a label.

- Added **Map Settings** to the Map page's buttons: show only favorites, add your archived photos, partners' photos, or photos in albums shared with you, and limit the map to the past day, week, 30 days, year, three years, or a range of dates you pick. The button is tinted while the map shows something other than your own photos (#319).
- **Set Location** now names the place under the pin, such as "Lisbon, Lisbon, Portugal", before you save (#319).
- Added **Refresh Faces**, **Refresh Metadata**, **Refresh Thumbnails**, and, for videos, **Refresh Video** to the photo menu of your own photos. Immich redoes that work in the background; your API key needs the `job.create` permission (#322).
- **Add to Album** can add to several albums at once: tick the albums, then press **Add to … Albums**. Once one is ticked, tapping another album ticks it too; with none ticked, tapping an album adds right away as before (#318).
- Added **Show on Map** to an album's menu: the Map page shows only that album's photos, and the album's chip in the corner goes back to all of them (#318).
- The Albums page shows how many albums you own, how many are shared, and how many of yours aren't (#318).
- Search filters can now pick several **People**, **Tags**, and **Albums**: a photo has to have all of them. Each opens a list with a filter box; people show their faces (#317).
- The **Camera** and **Location** search filters now list the makes, models, lenses, countries, states, and cities in your library, and typing in the list finds one. Picking a make lists only its models and lenses, and picking a country lists only its states and cities, as in Immich (#317).
- Searching on the People page now also asks Immich, so people past the first 500 it lists show up too (#317).
- Each link on the Shared Links page has a QR code button that shows the link as a code to scan with a phone, and a **⋯** menu, also opened by right-clicking or long-pressing the link, with **QR Code**, **Photos…**, **Edit…**, and **Delete…**. **Photos…** lists the photos in a link made for some photos, and you can take any of them out (#320).
- Added **Add to Share Link…** to the photo menu, and **Add to Existing Link…** to the selection bar's share button, to put photos in a link you made before (#320).
- Added **Account** to the main menu, with three pages: **Profile** shows your picture, name, and email, and changes or removes the picture; **Devices** lists the browsers and apps signed in to your account and signs any of them out; **API Keys** lists your keys, deletes ones you no longer use, and, on Immich 3.2 or newer, gives Mimick's own key a new secret with **Rotate**, which Mimick saves for itself (#321).
- Added **Set as Profile Picture** to the photo menu of your own photos (#321).
- Added a notifications inbox: a bell in the header shows how many of Immich's notifications, such as album invites and failed backups, are unread, and **Notifications** in the main menu opens them. Tap one to mark it read, or an album invite to open the album, and dismiss the ones you're done with. New ones also appear as desktop notifications while Mimick runs (#321).
- Added a **Calendar** to Explore: a card with a square for each day of the past year, darker the more photos you took (or, with **Uploaded**, uploaded) that day, with month names above, weekdays beside, the year's total, and a key from **Less** to **More**. Tap or click a day, or move with the arrow keys, to see its count, then **Show Photos** opens them; the arrows step a year at a time. The squares grow to fill wide windows and scroll sideways on phones, starting at today (#323).
- 360° photos now open in a 360° view in the viewer: drag, pinch, or scroll to look around, or use **Up** and **Down** to tilt, **Shift+Left** and **Shift+Right** to turn, and **+** and **−** to zoom. The **360°** button, or **P**, switches between it and the flat photo (#322).
- A stack's menu has **Keep This, Trash Others**: it moves the stack's other photos to the trash and unstacks the one you keep, as in Immich. Kept photos that weren't the cover take its place in the grid.
- The menu of your own photos has **Upload and Create Stack…**: pick one or more files to upload, and they're stacked under the photo. On a stacked photo it's **Upload and Add to Stack…**, and the stack keeps its cover.
- Phones have a search button in the header, so searching no longer takes a trip through the sidebar.
- Albums, people, tags, Favorites, Archive, and Trash now load like the Photos timeline: the scrollbar knows the full height from the start, so it doesn't grow or jump as you scroll, months load as you reach them, and dragging the scrollbar to the end goes straight there. They show the same date headings, either way round (**Newest** or **Oldest**), without Photos' year scrubber. Missing Location, places from Explore, and the photos of a map cluster get a full-height scrollbar too, loading page by page as you reach them.
- **Large Files** shows each file's size on its tile and the total in the header, and can list only **Photos** or **Videos**, and only files over 10 MB, 50 MB, 100 MB, 500 MB, or 1 GB. Its selection bar keeps to **Download** and **Delete**, saying how much space the selected files take.
- **Missing Location** has an **Add Location** button at the top: with photos selected it sets their place, otherwise it starts selecting. **Dates** limits the list to photos taken between two days. Its selection bar keeps to **Add Location**, and placed photos leave the list. Neither utility offers a slideshow any more.
- **Set Location** for selected photos suggests places under **Taken Nearby**: where your other photos from within 12 hours of them were taken, such as phone photos beside a camera's that have no GPS. Tap one to put the pin there.
- Added **Unusual Dates** under Utilities: photos dated in the future, or before 1990, as when a camera's clock was never set. **Change Date** at the top fixes the selected ones, and fixed photos leave the list.
- Paste photos into the library with **Ctrl+V**, or **Paste from Clipboard** in the **Upload** button's menu: files copied in a file manager, or an image copied in another app such as a screenshot, upload to the open album or to Photos. A photo copied in Mimick is added to the album without uploading it again.
- **Ctrl+C** copies the photo open in the viewer, or the selected photos. Like a file manager, a selection is copied as references rather than pictures, so any number is quick and light: paste them into another album to add them there, or into Files to get the ones on this computer.

### Changed

- Photo views, the Albums page, and Shared Links no longer repeat their name in a large title, since the title bar already shows it, which leaves more room on phones. The counts and details stay, beside a person's face or a tag's colour where there is one.
- An album's **Remote / Local / Unified** switch moved beside its **⋯** menu and shows only once a folder is linked, since **Local** and **Unified** need one.
- **Play Slideshow** moved from the header into the row above the photos, beside **Upload**. That row, and the space under a view's counts, now take no room when they have nothing to show, as in Explore, Large Files, and the People, Tags, and Folders pages.
- The main menu is split into three groups: Refresh and Notifications; Account and Queue Inspector; and Settings, Keyboard Shortcuts, and About Mimick.
- On phones, switching tabs in the bottom bar no longer adds a Back step for each tab: Back from any tab returns to Photos.
- Going to another view leaves selection mode, instead of keeping the checkboxes on with nothing selected.
- **Full RAW Decoding** keeps every colour the camera recorded, in 16-bit Rec. 2020, instead of clipping to sRGB. It uses about twice the memory per photo, and RAWs decoded before are decoded again once.
- With photos selected, **Back** (the header button, a swipe on phones, **Alt+Left**, or the mouse back button) clears the selection first, as on phones, and a second Back goes to the previous view. **Esc** clears the selection even when focus is elsewhere in the window.

- The library view is on by default for new installs. Until a server is set up, Mimick opens Settings on its setup steps, and opens the library once **Save and Connect** succeeds. Before then the Status page says **Not Set Up Yet** with a **Set Up…** button, instead of reporting that the server can't be reached.
- The **Upload** button now has a label, and shows only on Photos and on albums you can add to.
- The transfer progress bar in the header is taller, with slightly rounded corners.
- About Mimick lists the developer under Credits and credits the app icon and map data under **Attribution**; the third-party license text is no longer in the dialog or installed by the packages; it stays in the repository.

- The disk cache now stays under its size limit during long sessions, not only at startup: Mimick trims it every half hour. Thumbnails and originals you keep coming back to count as recently used, so trimming removes the ones you haven't opened in longest instead of the oldest downloads.
- Thumbnails of local HEIC and AVIF photos use the small picture phones store inside the file when there is one, instead of decoding the whole photo. Other formats that need a full decode (JPEG XL, PSD, and HEICs without one) decode at most three at a time and with one copy of the pixels fewer, so scrolling a folder of large photos uses much less memory.
- Thumbnails of local photos are now kept on disk as JPEG instead of PNG (PNG only when they have transparent parts), which takes a fraction of the space and loads faster.
- The selection bar's share button now asks whether to make a new link or add to one you made before; on the Shared Links page, **Delete** moved into each link's **⋯** menu (#320).

### Fixed

- RAW photos opened with **Full RAW Decoding** no longer look washed out: they now look like their thumbnails, taking their contrast, black level, white balance, and colour from Immich's preview, or from the camera's preview in the file for photos only on this computer. With neither, Mimick uses a gentle default curve. The viewer also opens them three to four times faster, developing at half size when that still fills the screen, and the full sensor when you zoom in.
- The Explore calendar no longer cuts off its lower rows, and the Friday label, on wide windows.
- The selection bar's **⋯** menu no longer disappears for good on phone-width windows after selecting two or more of your own photos.
- Mimick's own icons, such as the one at the top of the Status page, now show when Settings opens before the library.
- Closing the library window with **Background Sync** off now quits Mimick, as closing Settings does, instead of leaving it running in the tray.
- The Status page updates after **Save and Connect** instead of keeping the connection result from startup, and says **Can't Reach Immich** rather than **Up to Date** when the server can't be reached.
- In a tag's color picker, tapping the picked color no longer unpicks it, and **Save** waits until a color is chosen instead of doing nothing.
- Albums no longer run off the right edge of a 360 px phone screen: on narrow windows, **Upload** shows only its icon and the album's buttons sit below its name.
- Stacking photos in an album, a search, or another view that shows every photo, as Immich's web app does, no longer seems to do nothing: the confirmation says **Stacked, see the timeline**.
- Debug logs no longer fill with a line per frame while a photo's menu is open, and the grid no longer redraws itself when the pointer moves over the menu.
- Photos with a wide-gamut colour profile no longer look dull: Mimick now reads colour profiles, so iPhone photos, Adobe RGB camera JPEGs, and Immich's previews of them and of RAW files (which Immich makes in Display P3) show their real colours, as in Immich's web app. On wide-gamut screens, colours beyond sRGB show too. Edited copies saved from such photos keep their colours.
- The bottom bar on phones shows its labels in full instead of "Phot…" and "Expl…".
- The header no longer runs off a 360 px screen when notifications are unread during an upload; a long title is shortened with "…" instead.
- The sidebar's server row opens a dialog called **Immich Server** with a server icon, instead of one titled **About** with Mimick's icon that looked like **About Mimick**.
- With photos selected, **Esc** closes an open dialog, menu, or the Folders path field first, instead of clearing the selection and leaving them open.

## [9.13.0] - 2026-11-08

### Added

- Added 11 more map styles from VersaTiles under **More Styles** in the map's style menu: Positrino, Protocol, Protostar, Protozoa, Fnord, Classic, Googol, Freedom, Macbob, Mactaylor, and Bingo.
- Messages that said "file(s)" or "item(s)" now use the right singular or plural, such as "1 file" and "3 files".
- Added a **Satellite** map style with imagery from VersaTiles and place names on top. Sharp aerial photos cover about 35 European countries; elsewhere the imagery is sharp to about town level, and zooming in further enlarges it instead of leaving blank squares.
- Added place search to the Map page: type a place, street, or address and the map flies there and drops a red pin, zoomed to fit what you found. Results come from [Photon](https://photon.komoot.io) (OpenStreetMap data), ranked by how close they are to where the map is looking and named in your system language when Photon has it (English, German, or French). If Photon can't be reached, Immich's own place search answers instead. The **Set Location** dialog uses the same search. **Ctrl+F** jumps to the Map page's search field.
- Added keyboard shortcuts: **Ctrl+K** opens Search, **Ctrl+1** to **Ctrl+9** go to the sidebar pages, **Ctrl+A** selects every loaded photo, and **D**, **M**, and **Y** step Photos to the next day, month, or year (**Shift** for the previous one). On the map, **+** and **−** zoom, **[** and **]** turn it, **N** points north, and **Ctrl+L** shows your location. In the viewer, **1** to **5** rate (**0** clears), **E** opens Edit Info, and **Shift+D** downloads. All are listed under **Keyboard Shortcuts** (**Ctrl+?**).
- Added an **Appearance** choice to the map's style menu: follow the system style, or keep maps light or dark.
- The map's attribution footer now links to its sources, such as OpenStreetMap's copyright page.
- The About dialog now credits OpenStreetMap contributors, VersaTiles, Immich, and the libraries Mimick is built with.
- Added likes and comments on shared albums. When **Comments and likes** is on in **Album Options**, the album's header shows a comment button with the number of likes and comments; it opens the album's activity, where you can like the album, comment, and delete your own likes and comments (album owners can delete anyone's). Photos opened from the album show their own likes and comments in an **Activity** section of the details pane.
- Context menus now open with a long-press on touch screens, so phone users can reach them. In the photo grid, the lightbox, and on album tiles, **Shift+F10** or the **Menu** key opens them too (#293).
- Added keyboard navigation to the photo grid: the arrow keys move between photos (**Home** and **End** jump to the first and last), a ring marks the current one, **Enter** opens it, and **Space** selects it.
- Album tiles in the **Recent** row on the Albums page now have the same context menu as the other album tiles.
- Added an Arch Linux package on the AUR: `mimick` builds the latest release. Its build file is in `packaging/aur/` (#295).
- Mimick can now be translated. Its text, counts, and dates follow your system language, and dates use your locale's month and day names. The app menu entry and software center listing can be translated too. No translations ship yet; see **Translations** in `CONTRIBUTING.md` to add a language (#220).
- Added AppImages for x86_64 and aarch64 to each GitHub release. Each bundles every library it needs, including glibc, so it runs on distributions too old for Mimick's GTK and libadwaita versions. **Run on Startup** points at the AppImage file itself (#295).
- Added live and motion photos: the viewer shows a **Live** button on them that plays the short clip over the photo on a loop (**Space** too). Grid tiles of live photos show a small live icon (#300).
- Added **Memories**: a row of cards above Photos for "On this day" and birthday memories. A card opens the memory's photos as a slideshow that moves at the pace set in your Immich settings, and marks it seen. **Remove from Memory** in the photo menu takes a photo out. The row follows the **Memories** setting in Immich (#301).
- Added **stacks**: bursts and RAW+JPEG pairs that Immich groups show as one tile in Photos, with a count badge. In the viewer, a strip of the stack's photos under the photo lets you look at each one; right-click or long-press a thumbnail to make it the cover or take it out, and the strip's menu also unstacks. Select two or more photos and choose **Stack** to make a stack; **Unstack** is in a stacked tile's menu (#302).
- Added **Edit Photo…** for your own photos, right on the photo in the viewer, with one tool per tab so the photo keeps most of a phone's screen: **Crop** (free, the photo's own shape, square, or nine more from 5:4 to panoramic 3:1), rotate, flip, and **Straighten** on a thumbwheel for fine turns; **Adjust** (exposure, brightness, contrast, highlights, shadows, saturation, warmth, tint, vignette, and sharpness); **Filters** (Vivid, Warm, Cool, Dramatic, Fade, Vintage, Mono, Noir, and Sepia, at any strength); and **Redact**, which hides whatever you drag over in blocks, a blur, a frosted blur, or a solid bar in a colour you pick, or every tagged face or every piece of recognized text at once; boxes can be moved, resized, and restyled after they're drawn. The editor opens on Crop. Crops, turns, and flips are kept in Immich without changing the original, and can be reverted. Immich can't keep the other edits, so **Save Copy** draws them from the full-size original, in any format Mimick opens, and uploads the result as a new photo, stacked over the original if you turn on **Stack with Original** in the editor's **⋯** menu. The copy keeps the original's own EXIF, maker notes included, its XMP and colour profile, and Immich's capture time, place, caption, rating, favorite, and albums. Turn off **Keep Original Details** in the editor's **⋯** menu to save it as a new photo of its own instead. On wide windows the edit button under the photo opens it too (#303).
- Added **Tag People…** for your own photos, also opened by the pen in the viewer's **People** section. It shows the face boxes on the photo in the viewer: tap one to change who it is, remove a wrong face, or use it as that person's cover photo, or drag around a face Immich missed to tag it. You can pick someone, or type a new name or use **Create Person…** to add someone. On phones it closes the details pane so the photo shows. Pointing at a face on your photos outlines it with the person's name and rings them in the **People** section, and pointing at or focusing someone there outlines their face. Right-click or long-press someone in **People** (or press the **Menu** key) to change who it is or **Remove from Photo** (#304).
- Added a **Duplicates** page under **Utilities** in the sidebar. It shows the photos Immich found more than once, one group at a time and side by side as large as the window allows, with resolution, size (the largest file marked), and date; tap a photo to keep or trash it, or mark the group as not duplicates. It appears when duplicate detection is on in Immich (#305).
- Added slideshows: **Play Slideshow** in an album's, search's, or Photos' header, **Slideshow** in the photo menu, or **S** in the viewer. It plays fullscreen with a progress line and controls that hide until you move the pointer or tap; its settings set the seconds per photo, crossfade or slide, shuffle, and repeat. **Space** pauses and **Esc** ends it (#306).
- Added **View Similar Photos** to the photo menu, which uses smart search to find photos that look like it (#307).
- A place's photos opened from the map can fill the window: the grid button next to the **×** in their header hides the map and switches back, and **Open Map Places in a Full Grid** in Settings → Library makes places open that way.
- Added **View in Timeline** to the photo menu outside Photos: it opens Photos at the photo's month and highlights it (#308).
- The viewer's header has a **More** (**⋯**) button that opens a panel from the bottom of the window with every action for the photo as an icon, wrapped into rows on phones so none are out of sight, one tap away on touch screens. Swipe up on the photo or press **F10** to open it too; swipe it down, or press **Esc** or **F10** again, to close it.
- The README shows how far each translation has come; `scripts/i18n.sh progress` updates it.

### Changed

- The video seek bar is now a thick bar filled in your accent color. Its knob appears only when you point at it, drag it, or move to it with the keyboard.
- The viewer's **Fullscreen** button moved into its **⋯** menu (**F11** still works), so the header fits narrow windows with large text or minimize and maximize buttons.
- Recognized text in the viewer can now be selected a few characters at a time: drag across it with the mouse to select just what you sweep over, even across lines, double-click to pick a word, and **Shift**-click to extend. A single click still selects the whole line, and taps on touch screens still pick whole lines.
- The lightbox's zoom percentage now counts the photo's real pixels: 100% shows it pixel for pixel, so a large photo fitted to the window reads, say, 17%. Zoom now reaches 2000% of the real pixels (or 10× the fitted size, if that's further), so high-resolution photos, and any photo on a phone, can be looked at past full detail. Before, zoom stopped at 10× the fitted size, short of the real pixels on large photos.
- Double-clicking or double-tapping a zoomed-in photo in the lightbox now zooms back out, so phones without a zoom-reset button can get back to the whole photo. Before, each double-click zoomed in further.
- **Delete Album…** and **Leave Album…** in an album tile's context menu are now red, like **Move to Trash** in the photo menu.
- The details pane now follows Immich's order: the description, rating, and people come first, then **Details** (date taken, dimensions, size; formerly **Image**), **Camera**, **Location**, **Appears In**, and **Tags**.
- The details pane's summary no longer repeats the date as **Created** when **Details** already shows when the photo was taken.
- Your photos without a description show **Add a description** in the details pane, which opens **Edit Info…**.
- The details pane's **Set Location…** button is now a pen button on the **Coordinates** row. Your photos without a location show **Not set** there, with the same pen.
- A photo's location on the details pane's mini map and in the Set Location dialog is now a round badge with a photo icon, so it no longer looks like the blue "you are here" dot. Each map marker names what it marks when you rest the pointer on it.

### Fixed

- In the viewer, dragging a finger across a photo that has a file on this computer no longer starts dragging the file out to another app, which got in the way of swiping and panning. A mouse or pen still drags it out.
- Dragging a zoomed-in photo in the viewer with a mouse now pans it instead of dragging the file out to another app. Drag-out still works at the fitted size.
- **Space** plays and pauses a video again after you pick a speed, audio track, or volume; it used to reopen that menu.
- Context menus too tall for the screen, such as a photo's menu on a phone, now scroll instead of running off the bottom.
- Fixed switches not toggling when you clicked their knob. A click anywhere on a switch now toggles it.
- Fixed a long tag stretching the details pane. Tags too long for the pane are now shortened with "…"; hover a tag to see its full name.
- Fixed the Colorful, Natural, Muted, Gray, and Toner map styles falling back to OpenStreetMap after VersaTiles changed its hosted styles. The VersaTiles styles now ship with Mimick, so changes on VersaTiles' side can't break them; their tiles still come from VersaTiles.
- A server map style with more than one tile source now shows its main source instead of falling back to OpenStreetMap.
- The Flatpak now ships the full third-party license texts, including those of the bundled libjpeg-turbo, libwebp, and LibRaw.

## [9.12.0] - 2026-11-02

### Added

- Photos is now a timeline like Immich's web app: date headings between photos, a scrubber on the right edge with years and months (a drag handle on phone-width windows), and the whole library's height known up front. Only the months you scroll or jump to are loaded.
- Added a **Date Headings** setting (By Day, By Month, Off) for the Photos timeline.
- Added in-app video playback in the lightbox: play/pause, stop, skip ±10 s, frame stepping, a seek bar, loop, playback speed (0.25×–2×), volume and mute, audio and subtitle track selection, and fullscreen with auto-hiding controls. Server videos stream from Immich; decoding uses VA-API hardware acceleration when available (#80).
- Added an **Open with…** button for videos in the lightbox that lets you choose the app.
- Added fullscreen viewing for photos and videos in the lightbox (header button or **F11**), with an auto-hiding header for leaving fullscreen on touch screens.
- Added a **Keyboard Shortcuts** dialog to the main menu (also **Ctrl+?**) listing every library and lightbox shortcut.
- Added recognized text (OCR) in the lightbox: when Immich has found text in a photo, a text button (or **T**) outlines each piece of text. Drag across text to select it (Shift-click extends, Ctrl-click adds or removes a box, tap on touch screens) and copy the selection or all text with the **Copy All Text** button or **Ctrl+C** (#85).
- Added a **Map** page that shows every photo with a location. Nearby photos merge into bubbles with photo counts that split apart as you zoom in, and single photos show as round thumbnails. Click a bubble, or **Show photos in this area**, to list the photos beside the map (below it on narrow windows) while the sidebar steps aside; the lightbox, selection, and bulk actions work there as in any grid. Buttons over the map zoom, rotate (with a compass to point north again), and show your location through the desktop's location service, which asks for permission first. A style menu offers your Immich server's style, the Colorful, Natural, Muted, Gray, and Toner styles from VersaTiles, or OpenStreetMap; the choice is remembered, and every style except OpenStreetMap switches between light and dark with the system.
- Added a small map with a pin under a photo's coordinates in the lightbox details pane; click it to open the Map page at that spot. A copy button next to the coordinates copies them (#86).
- Added setting the location of one or many photos with **Set Location…** in the details pane, the right-click menu, and the selection bar. Search Immich's places, click the map to drop a pin, or type or paste coordinates (#87). Like Immich, editing info and location is offered only on photos you own.
- Added browsing a partner's photos: click someone under **Sharing With You** on the **Sharing** page to see their photos as a timeline (#236).
- Added a **Show in Photos** switch for each partner who shares with you, which adds their photos to your Photos timeline.
- Added star ratings in the lightbox details pane: click a star to rate a photo or video from 1 to 5, or **Clear** to remove the rating. It appears when **Ratings** is turned on in your Immich account settings, and like Immich, only your own photos can be rated.
- Added a **People** section to the lightbox details pane showing the people recognized in your photos, with their age when the photo was taken if a birth date is set. Click someone to see all their photos.
- Added **Add to Album** for photos in the selection bar, the right-click menu, and the lightbox details pane. Pick one of your albums or one shared with you as an editor, filter by name, or create a new album, and open it from the confirmation (#260).
- Added **Remove from Album** inside an album, from the selection bar and the right-click menu, with **Undo**. Like Immich, editors can remove only their own photos (#261).
- Added **Set as Album Cover** to the right-click menu inside your own albums (#262).
- Added **Delete Album** to your albums' header menu and tile menu. The photos stay in your library. Watch folders that sync with the album would otherwise bring it back, so you choose whether they keep backing up to your library or stop being watched, and subfolders that named the album go to your library instead.
- Added **Leave Album** for albums shared with you, from the album's header menu and its tile on the Albums and Shared Albums pages (#263).
- Added **Album Options** to your albums' header menu: display order (newest or oldest first) and turning comments and likes on or off. The grid's sort menu gains **Oldest**, and albums open in their display order (#264).
- Added downloading a whole album as a zip from its header or its tile; large albums download as numbered parts, as Immich splits them (#265).
- Added an **Appears In** section to the lightbox details pane listing the albums a photo is in; click one to open it (#267).
- Added **Change Date** for selected photos: give them all one date, time, and time zone, or shift each one earlier or later, optionally moving them to another time zone.
- **Edit Info…** now has a **Time zone** row and shows the date in the photo's own time zone.
- Added a **Memory Limit (MB)** setting in Settings → Storage for decoded thumbnails and lightbox pictures: 2 GB by default and never more than half your RAM. The cache used to grow to 20% of your RAM, between 500 MB and 3 GB (#280).
- Added a **Fit Thumbnails to Tiles** setting, on by default: with **Thumbnail Quality** set to Automatic, Preview, or Full Size, grid thumbnails are decoded at their tile's size instead of 1440 or 2560 px, using far less memory and making scrolling smoother (#281).

### Changed

- New app icon: a layered orange lotus that stays clear at small sizes, plus a symbolic version for monochrome icon spots.
- Thumbnails now fade in as they load, in the grid and on album covers, unless animations are turned off in your system settings.
- **Search** now sits at the top of the library sidebar.
- The search field now spans the whole search form, with the mode menu next to **Search** below it, so there's more room to type on narrow windows.
- Reorganized the settings window:
  - **Settings** now reads Server, Watch Folders, Uploads, App, then the library sections (Library, Grid Appearance, RAW Files, Storage, shown only when the library view is on) and Troubleshooting. Labels and descriptions are plainer throughout, and quiet hours show as times ("From 22:00 Until 07:00").
  - **Save and Connect** replaces Save Credentials, and **Test Connection** shows its result in place instead of a dialog.
  - **Status** opens with a headline (Up to Date, Uploading 3 of 40, Paused, Waiting for Immich) with Sync Now, Pause, and Queue, lists each watched folder's state, and only shows failed uploads (with **Retry**) and errors when there are any.
  - The cache limit shows how much is in use, with **Clear Cache** beside it; **Export Diagnostics** moved to Troubleshooting, and **Quit** to the main menu.
  - Folder Rules are grouped into Sync, Deletions, and Files, and each sync method says what it does.
  - New users see three numbered steps; on narrow windows the Status/Settings switcher moves to the bottom.
- Finished downloads, copied share links, "already in sync", and errors from quick actions (rating, favorite, tags, copy, open, playback, album changes) now show as short messages at the bottom of the window instead of dialogs. Downloads offer **Open Folder**, and errors offer **Details** with the full message.
- Search filters now open in a side panel that docks beside the results, or slides in from the right on phones, instead of a short list above them. The **Filters** button shows how many filters are set.
- With grid borders turned on, the border colour now fills the whole grid, including the space below the last photos and behind the date headings, and headings switch to dark or light text so they stay readable.
- The share buttons (album header, selection bar, Shared Links) use a proper share icon instead of a grey square on themes without one.
- On phone-width windows, the selection bar keeps Add to Album, Download, and Move to Trash as buttons and puts the rest in a **More actions** menu.
- The photo grids now load thumbnails only where scrolling stops: placeholders show while you fling, loads for tiles you scrolled past are cancelled, and the nearest tiles load first. Scrolling far no longer loads every photo on the way.
- Grid thumbnails now load 16 at a time (was 8) over connections that stay open between scrolls, and photos opened in the lightbox no longer wait behind grid thumbnails.
- **Explore → Places** now loads with one request instead of scanning the whole library.
- Grid pages, timeline months, and search results no longer ask Immich for every photo's full camera details, so they download and load faster and use less memory.
- The lightbox now loads the previous and next photos in the background, so stepping through photos is faster.
- Mimick wakes up less often while idle in the tray: tray actions and the upload queue no longer check for work several times a second.
- Removed the **Timeline** button; Photos sorted by Newest is the timeline.
- RAW decoding now uses LibRaw 0.21.3 (was 0.20.1), adding support for cameras such as the Sony A7 IV, Canon EOS R3/R7/R10, Fujifilm X-H2S, OM System OM-1, Leica M11, and Nikon Z9 (standard compression).
- Grid thumbnails for RAW files without an embedded preview now use a faster half-size decode.
- Clicking a video in the grid now opens it in the lightbox instead of the system default player.
- Photos edited in Immich (cropped or rotated) now show the edited version in the lightbox, in both preview and full resolution. Download and drag-out still give the original file, and an edited photo that is also on disk falls back to the local copy when the edited version can't be fetched.
- Bumped Rust dependencies (`notify` 8.2.1, `roxmltree` 0.21.2).
- The Flatpak now requests the PulseAudio socket (also used by PipeWire) for video sound.
- The Flatpak now bundles libshumate 1.7.0 and protobuf-c 1.5.2 for the maps; native builds also need libshumate 1.7 or newer.
- Native builds now require GTK 4.24, libadwaita 1.10, and libheif 1.21 or newer (matching the GNOME 51 runtime), plus GStreamer with GstPlay and the GTK 4 video sink plugin (`gst-plugin-gtk4`) for video playback, and libclang for generating the LibRaw bindings.
- Removed the **Archived only** search filter, which Immich v3 ignores; use **Visibility → Archive** instead.
- The **Shared Links** page now shows each link's cover photo, what visitors may do (Upload, Download, Exif, Password), and expired links in red. Click a link to edit it. **Copy link** now confirms with a checkmark on the button instead of a dialog.
- Photos in the lightbox now follow your finger or a two-finger touchpad swipe and spring to the next or previous one. **Left**/**Right** and the header buttons use the same motion, pressing them quickly glides through photos instead of restarting each slide, and the photos on either side are already loaded when you swipe (#282).
- The lightbox opens large photos much faster and steps between them smoothly: local files and originals are decoded at your screen's resolution (JPEGs shrink while decoding), the full resolution loads in the background when you zoom in past it, and the photos before and after the current one on disk are prepared ahead of time (#278).
- **Upload to Album** in the upload window, and after dropping files on the library, now uses the same album picker as **Add to Album**, with album covers, a filter, and **New Album** (#277).

### Fixed

- Closing the library window now stops a playing video instead of leaving its sound running in the background (#273).
- The lightbox no longer keeps its images in memory after it closes, and a photo you zoomed into gives back its full-size image when you move on. Right-click menus no longer stay in memory after they close (#274).
- Reopening the library window now returns to the view you left, instead of an endless spinner with the wrong page selected in the sidebar (#275).

- **Pause on Metered Network** now works in the Flatpak: it follows the system's network portal instead of `nmcli`, which isn't available in the sandbox.
- Turning **Upload XMP Sidecars** on or off now saves straight away, and settings changed while a save was still running are no longer lost.
- **Thumbnail Quality**, **Border Width**, and **Border Color** now apply to an open library window right away, keeping your place in the grid, instead of after reopening it.
- RAW files that LibRaw can't open now still show their embedded JPEG preview instead of "Preview unavailable".
- 16-bit embedded RAW thumbnails no longer display as garbled images.
- The RAW decode cache no longer discards an entry that is being written when the same file is opened again.
- Closing the library window now gives its memory back to the system; before, Mimick could stay at over 1 GB after the window was closed. Its background server checks also stop.
- Long albums, Favorites, and search results no longer get slower as more photos load, and deleting or archiving a photo in them no longer rebuilds the whole grid.
- The library no longer freezes briefly when a batch of uploads finishes, and the sync index is no longer copied every 10 seconds when nothing has changed.
- The Photos timeline now includes months that only have photos from partners shown in Photos.
- Editing a shared link no longer removes the custom URL set for it in Immich.
- Setting an edited shared link to expire **Never** now removes its expiry; before, the old expiry stayed.
- Shared links to individual photos are now titled "Individual share" instead of always "1 item", since Immich lists only one photo per link.
- Searching by file name no longer shows the whole library's photo count in the header, since Immich can't count those searches.

## [9.11.0] - 2026-10-17

### Added

- Added a file-based fallback (base64-encoded, `0600` permissions) for API key storage on desktops where no keyring service is running (#215).
- Added a library-only target for watch folders, allowing direct uploads without creating or associating an album (#210).
- Added moving photos to the Immich trash (right-click menu, lightbox button, or Delete key) and editing their description, date taken, and favorite status from the library (#183).
- Added tag support: tags show in the lightbox details pane, where they can be added, created, or removed, and clicking a tag (or using the new Tag search filter) shows every photo with that tag (#141).
- Added a Trash view to the library sidebar: restore or permanently delete trashed items, or empty the trash (#229).
- Added favorites: a heart button in the lightbox (or **F**), menu and Edit Info toggles, a heart badge on favorited thumbnails, and a Favorites sidebar entry.
- Added a Shared Albums sidebar entry, and a Share dialog for your albums (add people, change Viewer/Editor roles, remove people).
- Added shared links: create a public link from an album, a selection, or the right-click menu (description, expiry, password, download/upload/metadata options), and manage all links from the new Shared Links sidebar entry (copy, edit, delete).
- Added an Archive sidebar entry, plus Archive / Unarchive in the right-click menu, the lightbox (or **A**), and the selection bar (#239).
- Added an expander on the Albums sidebar row that shows your three most recently updated albums; the full album list below is now a collapsible **All Albums** section (#240).
- Added a People sidebar page: search people, show hidden ones, open a person's photos, and rename, hide or unhide, set a birthday, or merge people from each face's menu (#235).
- Added a Tags sidebar page: browse the tag tree, open a tag's photos, and create, rename, recolor, or delete tags. Renaming needs a newer Immich than v3.0.0; older servers show an error (#237).
- Added a Folders sidebar page to browse server photos by their original folder (#238).
- Added a Sharing sidebar page for partner sharing: see who you share your library with and who shares with you, add partners, or stop sharing (#236).
- Added a header to every photo view: albums show their item count, dates, sharing, description, share and folder-link actions; people show their face, photo count, age, and person menu; tags, places, folders, favorites, archive, and searches show their counts and details. The header scrolls away with the photos.
- Added mouse back-button support in the library window.
- Added Forward navigation (**Alt+Right** or the mouse forward button) and swipe right to go back on touch screens.
- Added a bottom navigation bar (Photos, Explore, Albums, People) on narrow windows.
- Added favorite people: a heart on favorited faces, favorites listed first, and favorite toggles in the person menu and header.
- The library now hides pages and options for features that are turned off on the server or in your Immich account settings (Trash, People, Tags, Folders, Shared Links, Search, smart and OCR search, Explore's places and things, and the rating and tag search filters). With the server's trash off, deleting says it's permanent.
- Added renaming albums and editing their descriptions, from the album header or the album tile menu; linked watch folders stay linked.
- Added a server About dialog (server row in the library sidebar) with Immich and component versions, source and build links, and version history.

### Changed

- Archived photos no longer appear in the Photos timeline, matching Immich (#239).
- Back now returns to pages too (Albums, People, Explore, Tags and Folders levels, Search), and people, places, and things opened from Explore, and tags clicked in the lightbox, open as titled views instead of anonymous searches.
- The album linked-folder row and the Trash's Restore All / Empty Trash bar moved into the view header.
- The library controls are now one row on narrow windows, and the Timeline toggle and sort menu only appear where they apply.
- The library sidebar is grouped into Library, Albums & Sharing, and Browse sections.
- The library's top bar now shows the current view's name.
- Faces on the People page are larger.
- The library's bottom transfer bar is replaced by a small upload/download indicator in the top bar, shown only while a transfer is running.
- Bumped Flatpak runtime and CI builder image to GNOME 51.
- Updated GitHub Actions dependencies (`taiki-e/install-action`, `github/codeql-action`).
- Redesigned tags in the details pane as colored pill chips with an inline remove button, a "+" header button, and an empty state.
- "Date taken" in Edit Info is now picked from a calendar with hour, minute, and second fields instead of typed text.
- Server statistics now open from the connection row in the library sidebar; the server row opens About.

### Refactored

- Resolved static-analysis findings by simplifying Rust idioms, moving filesystem work off asynchronous UI paths, and splitting local/startup file traversal into focused helpers.
- Split the library window, controls, page loading, settings window, queue manager, and several dialogs into focused modules, and shared the duplicated API request and sidebar code.

### Fixed

- The library's phone layout (narrow breakpoint) now applies below 600 px; an overlapping breakpoint kept it from ever taking effect.
- Fixed an issue where the app could hang on startup or while saving credentials if the XDG Secret portal was misconfigured by enforcing a 5-second deadline for connecting to the keyring (#218).
- Hardened API-key fallback storage with atomic writes and enforced owner-only (`0600`) permissions on Unix (#215).
- The API-key fallback file now takes precedence over an older keyring entry, and Settings warns when the key is stored in a file instead of the keyring (#215).

## [9.10.0] - 2026-10-01

### Added

- Added support for 360px minimum window width with a new compact masonry tier and reduced CSS minimums.
- Added a Places filter on the Explore page.
- Added configurable masonry grid border width (0-50px) and custom border color with uniform edges (top, bottom, left, right and between tiles), auto-saved on change.

### Changed

- Made the search view persistent in the sidebar instead of a temporary popover.
- Addressed multiple SonarCloud and Clippy warnings for code complexity and quality.
- Bumped Rust dependency tree (`gtk4`, `glib`, `cairo-rs`, `pango`, `reqwest`, `rustls`, `encoding_rs`, `syn`, and many other transitive crates).

### Fixed

- Fixed duplicate back icon displaying in the lightbox view (#199).
- Fixed disabling autostart in Flatpak environments not removing the background portal entry (#201).

## [9.9.0] - 2026-08-08

### Added

- Drag-and-drop file import support for the Library and Staging windows.
- Ability to drag files directly onto Album rows in the sidebar to upload directly to that album.
- Drag-and-drop export support to drag assets out of the masonry grid and lightbox to your system (auto-downloads originals).
- "Recently Added" section on the Explore page showing timestamps as relative dates.
- Expandable "See More" and "Show Less" buttons on Explore page sections.
- Caching of Places data on the Explore page for instant revisits.
- Proper fallback behavior for the lightbox when opened directly from the Explore view.

### Changed

- Bumped Rust toolchain to version 1.97.
- Adjusted order of sections on Explore page: People, Places, Recently Added, Things.
- Filtered `createdAt` attributes from the Things grid.
- Upgraded the Explore view for Immich v3 API compatibility.

## [9.8.0] - 2026-07-08

### Added

- Context menu "Open With Mimick" upload flow. Right-clicking supported media files in a file manager and choosing Mimick opens a dedicated staging window with a masonry grid preview, select-all toggle, and Upload / Album buttons.
- Video thumbnail extraction in the staging grid using ffmpeg, with secure temporary file handling via `tempfile::NamedTempFile`.
- Selection checkboxes on grid tiles in both the staging view and library view. Unchecked tiles show a bordered square outline; checked tiles show an accent-coloured filled square with a checkmark icon.
- Responsive narrow layout for the staging window via a 600sp libadwaita Breakpoint, matching the main library grid behaviour on small screens.
- `.desktop` file now declares supported image and video MIME types so the system file manager offers "Open With Mimick" in its context menu.

### Changed

- **Breaking:** Minimum supported Immich version is now v3.0+. The v1.x API is no longer supported.
- Upload requests no longer send `deviceAssetId` or `deviceId` multipart fields, which were removed from the Immich v3 `AssetMediaCreateDto`. Deduplication continues to work via the existing SHA-1 checksum-based `bulk-upload-check`.
- Album ownership is now derived from the Immich v3 `albumUsers` array (role-based) instead of the removed top-level `ownerId` field. The Owned/Shared album sections in the Library view continue to work as before.
- Asset `width`/`height` fields are now deserialized as integers (`u32`) to match the Immich v3 schema change from `number` to `integer`.
- Library view enable/disable toggle in Settings now auto-saves immediately on toggle, matching the behaviour of all other settings toggles. Previously it required clicking "Save Credentials".
- Bumped `taiki-e/install-action` from v2.82.3 to v2.82.7 in CI.
- Bumped `release-drafter/release-drafter` from v7.4.0 to v7.5.1 in CI.
- Suppressed `RUSTSEC-2026-0192` (`ttf-parser` unmaintained) in `cargo audit`. This is a transitive dependency via `resvg` with no upstream fix available yet.

### Refactored

- Split `paint_checkbox` into `paint_checked_box` and `paint_unchecked_box` helpers.
- Split `build_staging_window` into `build_staging_ui`, `build_staging_header`, `setup_narrow_breakpoint`, `connect_select_all`, `connect_selection_tracking`, and `connect_upload_buttons`.
- Split `present_album_list` into `present_album_list`, `handle_album_upload`, and `build_album_listbox`.
- Split `spawn_enqueue_with_callback` by extracting `build_file_task` for per-path FileTask construction.
- Split `ffmpeg_extract_thumbnail` into `run_ffmpeg_frame`, `scale_pixbuf_to_thumbnail`, and `decode_local_pixbuf`.
- Extracted `status_text` and `simple_alert` shared helpers to reduce code duplication across the staging view.

## [9.7.0] - 2026-06-16

### Added

- Shift+Click range selection in the library grid. Clicking an asset with Shift held selects the contiguous range from the last-clicked anchor to the current position. Ctrl+Shift adds the range to the existing selection without clearing it.
- Download folder confirmation dialog. When no default download folder is saved, the folder picker now appears on every download. After choosing a folder, a prompt asks whether to save it as the default ("Always") or use it once ("Just Once").
- Download Folder setting in the Library preferences group. Shows the current saved folder with Change and Clear buttons, so users can view and manage the default download location from Settings.
- Batch download summary dialog. After a multi-select download completes, a dialog reports how many assets were downloaded, skipped, or failed, and names the destination folder.
- Unified file conflict dialog for batch downloads. When existing files are found, a single dialog offers Skip, Rename (auto-suffix), or Overwrite, with an "Apply to all remaining conflicts" checkbox instead of spawning one dialog per file.
- Added `cargo test --locked` to `validate.sh` to match CI and catch regressions locally.
- Added detailed permission error dialogs across the Library, Explore, and Server Statistics views to clearly identify missing API scopes (e.g. `HTTP 401/403`) instead of treating them as generic network failures.
- New masonry layout for the Photos view in Library. Images now keep their natural aspect ratios and pack into justified rows instead of a fixed tile grid.
- New `Library Thumbnail Quality` setting with `Auto`, `Thumbnail`, `Preview`, and `Full Size` options. `Auto` chooses a size based on the rendered cell size, and `Full Size` falls back automatically when the server does not provide that image size.

### Changed

- Updated README and in-app missing permission dialogs to explicitly document `asset.statistics` as a required API key scope for fetching server statistics.
- Library layout now uses image dimensions from Immich EXIF data earlier in the load path, so rows are sized more accurately from the first paint.
- Thumbnail memory cache is now sized automatically from available system RAM, using up to 20% of memory with built-in minimum and maximum limits, so the manual memory-cache limit setting has been removed.
- Thumbnail loading now uses separate concurrency limits for smaller thumbnails and larger preview/full-size requests to keep browsing responsive while larger images are still loading.
- Library settings text was shortened and cleaned up to make common options easier to scan.
- Removed the redundant "(Selected via Flatpak portal)" text globally (affects Settings, Diagnostics, Album views) since the app is exclusively distributed via Flatpak.
- `validate.sh` now uses `set -euo pipefail`, passes `--locked` to clippy/test, `--deny warnings` to cargo audit, and fails fast when `cargo-audit` is missing instead of auto-installing it.

### Fixed

- Fixed Shift+Click in the library grid having no effect. The click handler now checks `SHIFT_MASK` and selects the contiguous range between the anchor and clicked position.
- Fixed library downloads silently persisting the chosen folder on first use and never prompting again. The folder picker now appears each time until the user explicitly opts into a default.
- Fixed batch download showing "Download Complete" even when all assets were skipped. The heading now reads "No Assets Downloaded" or "Download Failed" as appropriate.
- Fixed batch download spawning a separate overwrite dialog for every conflicting file simultaneously. Conflicts are now resolved sequentially with a unified dialog.
- Fixed batch download summary showing the full sandbox path instead of just the folder name.
- Selection mode now automatically exits after a batch download completes.
- Fixed an issue where the footer statistics would remain permanently missing if the initial network connection failed at startup.
- Fixed the Server Statistics missing permissions dialog text truncating on narrow screens (like 360px width) by allowing it to wrap.
- Fixed `validate.sh` to automatically apply `cargo fmt` fixes instead of failing on formatting errors.
- Fixed native GTK button hover and scale animations across the app by replacing the rigid CSS transition with a smoother `cubic-bezier` curve.
- Masonry grid scrolling and thumbnail loading are now more stable. Items close to the visible area load first, and the layout no longer shifts as much while images are coming in.
- Large cells can now request higher-quality preview and full-size thumbnail buckets correctly, with automatic fallback when a higher bucket is unavailable on the server.
- Queue Inspector: Fixed the Recent Queue Activity layout so it no longer redundantly duplicates the filename in two columns.
- Queue Inspector: Allowed filenames to smoothly wrap to multiple lines, preventing truncation (cut off with ellipses) when the window is narrow.
- Settings: Replaced the Application Quit button's FlowBox layout with a native Libadwaita ActionRow, fixing an oversized invisible touch target anomaly and matching standard OS styling.

### Refactored

- Decomposed high-complexity functions across the codebase to bring cognitive complexity under 15 and cyclomatic complexity under 8, enforced via `clippy::cognitive_complexity` at warn level. Affected modules: `monitor`, `startup_scan`, `api_client`, `album_sync`, `album_link`, `canvas`, `lightbox`, `queue_manager`, `settings_window`, `main`, and `texture_decode`.
- Extracted `texture_decode` into a directory module with a dedicated `codecs` submodule for JXL, SVG, JP2, and PSD decoders.
- Split JPEG marker parsing (`is_lossless_jpeg`, `find_jpeg_end`) into smaller helpers (`classify_jpeg_marker`, `skip_segment`, `seek_marker`, `scan_sos_entropy`).
- Extracted libraw FFI helpers (`init_libraw`, `configure_libraw_full_decode`, `run_libraw_full_decode`, `unpack_libraw_fallback_thumb`) from monolithic unsafe blocks.
- Split masonry layout packing into `collect_row_indices` and `build_row`; gesture handling into `handle_primary_click`, `handle_secondary_click`, and `toggle_selection`.
- Decomposed `build_settings_window_with_parent` into per-section UI builders and extracted `build_behavior_group` sub-builders (`add_core_rows`, `add_quiet_hours_rows`).
- Split `finalize_upload_progress` into `apply_idle_state`, `apply_active_state`, and `check_batch_notification`.

## [9.6.1] - 2026-05-31

### Changed

- Revised API key permission guidance across the app, README, and wiki to match Immich's exact scope names. The documentation and in-app messaging now call out `user.read`, `albumAsset.create`, and `albumAsset.delete`, and clarify the extra scopes needed for Library / Explore browsing and deletion mirroring.

### Fixed

- Lightbox mouse drag-pan is now smooth and jitter-free when zoomed in. The drag and pinch gestures now share the scrolled-image coordinate space.

## [9.6.0] - 2026-05-25

### Added

- Face visibility filters in the Explore view allowing users to show/hide face-tagged assets with server-side filtering via new `personVisibility` parameter.
- Server Statistics Dialog displaying key library metrics (total assets, photos, videos, archive count, person count, etc.) in a responsive FlowBox layout that adapts to window size.
- Cargo audit configuration to ignore unmaintained EXIF dependencies, streamlining the security audit workflow.
- Subtle press animations across all interactive UI elements (header buttons, sidebar rows, grid tiles, explore/album tiles, settings rows, dialog buttons). Uses a brief scale-down (0.97x, 80ms) on press; animations are automatically disabled when the GTK `gtk-enable-animations` system setting is off.
- RAW rendering mode toggle in Settings > Library: "Full RAW Decoding" switch allows users to choose between fast embedded JPEG preview extraction (~10ms, default) and full sensor demosaic via libraw (~1-3s). The decode cache setting is gated to only appear when full decode is enabled.
- Embedded JPEG preview extraction from RAW files via `libraw_unpack_thumb` + `libraw_dcraw_make_mem_thumb`. Supported across all major RAW formats (CR2, CR3, NEF, ARW, DNG, ORF, RW2, PEF, FFF, RAF, SR2, MRW, etc.) with automatic fallback to full demosaic when no embedded preview exists.
- Toggleable RAW decode cache setting in Settings > Library. Stores demosaiced textures as PNGs on disk to skip re-processing on re-opens. Defaults to off to conserve storage.
- Lightbox swipe gesture navigation: swipe left for next asset, swipe right for previous. Works with both touch and trackpad input. Automatically disabled when zoomed in to avoid conflicting with pan gestures. Essential on mobile viewports (360px) where the prev/next header buttons are hidden.
- XMP sidecar upload support: companion `.xmp` files alongside media are automatically detected and attached via the Immich `sidecarData` multipart field during upload. Searches `photo.ext.xmp` (preferred) then `photo.xmp` (fallback), case-insensitive. Global toggle in Settings > Behavior with per-folder override in Folder Rules.

### Changed

- Mobile and narrow viewport UI overhaul: optimized component dimensions for 360px width screens, adjusted album and explore tile layouts to 2-column on mobile with uniform sizing, reduced header controls footprint, and improved overall narrow-screen usability.
- Album and explore view tile rendering now uses fixed 100px height with viewport-responsive width (via FlowBox homogeneous layout), ensuring consistent thumbnail aspect ratios and eliminating layout jitter on window resizes.
- Grid view minimum columns reduced from 3 to 2 on narrow viewports to fit within 360px width constraints without overflow.
- Added comprehensive rustdoc comments across all source files: module-level `//!` docs expanded to multi-line descriptions, and doc comments added to all public and private structs, enums, functions, and fields.
- Top toolbar redesigned with context-aware search, sorting, and action triggers, providing better integration with face filters and statistics features.
- Explore and album cover layouts now use breakpoint-driven responsive sizing (600sp threshold) to prevent image stretching on different viewport sizes.
- Server statistics API endpoints enhanced to support library metrics and aggregation queries.

### Fixed

- Lightbox now shows a video poster with a clickable play badge when navigating to a video asset (via arrow keys or Prev/Next), instead of the "Preview unavailable" overlay. Clicking the badge hands off to the same external-player flow used by grid clicks (local files via system default app, remote files downloaded to `~/.cache/mimick/video/`). Zoom controls, resolution toggle, and download button are hidden while a video is the current asset.
- RAW embedded preview extraction now scans the file directly for the largest SOI-bounded JPEG as the primary path, instead of relying on libraw's preferred thumbnail. Resolves the postage-stamp preview problem on cameras that store a tiny JPEG followed by a full-resolution one (Sony ARW and similar). When no JPEG is present in the file at all (Samsung DNG, OnePlus DNG, and other phone DNGs that store their preview as uncompressed TIFF strips), the bitmap thumbnail from `libraw_dcraw_make_mem_thumb` is used as the fallback with container orientation applied. The full RAW demosaic path is unchanged.
- Embedded JPEG previews extracted from RAW files (.fff, .pef, .dng, .3fr, .RAW, etc.) now display with correct orientation. The extractor routes through `Pixbuf::apply_embedded_orientation` for JPEG thumbnails and applies the RAW container's `flip` field via `Pixbuf::rotate_simple` for bitmap thumbnails. Previously `Texture::from_bytes` ignored EXIF orientation tags.
- RAW thumbnails from cameras that pre-rotate the embedded preview (Kodak DCR, Nikon E5700 NEF, Leaf MOS) no longer appear double-rotated. A new `is_thumbnail_prerotated` check compares the preview aspect ratio against rotated sensor dimensions and skips the container flip when the preview is already oriented correctly.
- SOI JPEG scanner no longer selects lossless JPEG payloads (SOF3 / `FF C3`) as preview candidates. RAW files wrap compressed Bayer sensor data in SOF3 containers that are never renderable. Previously the scanner selected these multi-MB blobs as the "largest JPEG", wasting a Pixbuf decode attempt before falling back to libraw. Affects 19 of 55 tested RAW formats (Nikon NEF/NRW, Pentax PEF, Canon CR3, Kodak KDC, Panasonic RW2/RWL, Leica DNG, Hasselblad 3FR, Sony SRF, Phase One CAP, Sigma X3F).
- Local folder thumbnail generation for RAW files now skips the `gdk_pixbuf::from_file_at_scale` attempt entirely, going straight to the custom RAW decoder. Pixbuf never recognises RAW formats, so the previous attempt always failed with "Couldn't recognize the image file format" before falling through to the custom decoder, adding latency and log noise on every RAW thumbnail.
- Lightbox details pane toggle button is no longer hidden at narrow viewports (360px). Previously all three header buttons (prev, next, details) were hidden when the split view collapsed, leaving no discoverable way to access the EXIF details pane on mobile.
- Lightbox trackpad pinch-to-zoom now works reliably and is smooth. Zoom is now jitter-free: scroll adjustment ranges are pre-set synchronously to match the new content size so the scroll position applies in the same frame as the resize, eliminating the one-frame flicker from the previous deferred update.
- Album/explore tile thumbnails now maintain uniform sizes within a viewport and display correctly at 360px window width, with no collapse on window-height changes.
- FlowBox children per line constraints adjusted (min 2, max 6 for albums) to ensure 2-column layout on mobile while limiting tile width growth on desktop.
- Raw asset handling and EXIF metadata extraction now properly exports `gexiv2_metadata_free` for modern gexiv2 linking compatibility.
- Lightbox JPEG XL decoding switched from `jpegxl-rs` (system `libjxl` bindings, frequently mismatched at runtime) to `jxl-oxide` (pure-Rust). Removes the "Generic Error. Please build `libjxl` from source" failure mode on valid JXL files and drops the libjxl system dependency. Now also handles 1-channel grayscale and 2-channel grayscale-with-alpha JXL inputs by expanding to RGB / RGBA.
- Lightbox RAW decoding now uses `libraw` (vendored C++) as the primary decoder with `imagepipe` as a pure-Rust fallback. libraw applies per-camera color matrices and white balance so output matches darktable / Lightroom instead of imagepipe's generic sRGB pipeline. Adds proper support for ARI (Arriraw), FFF (Hasselblad), CR3 (Canon mirrorless), ERF (Epson), Sony ARW variants, Phase One IIQ, and Sigma Foveon X3F -- formats imagepipe either rejected outright or rendered with wrong colours.
- libraw decoder now explicitly enables `use_camera_wb` (camera as-shot white balance) and `user_qual = 3` (AHD demosaic) via direct `libraw-sys` FFI, since the `libraw-rs` Rust wrapper does not expose those params. Fixes the muted / blue cast that was visible on Nikon NEF, Hasselblad FFF, and Canon CR3 files compared to darktable.
- Added PSD (Photoshop) lightbox decoding via the pure-Rust `psd` crate. Previously `.psd` files fell through every decoder and showed "Preview unavailable".
- Fixed `gtk_gesture_group: assertion ... == ... failed` GTK-CRITICAL that fired every time the lightbox opened. The drag gesture must be attached to its widget _before_ `group_with(&pinch)` is called.
- Release profile switched from `panic = "abort"` to `panic = "unwind"` so `catch_unwind` actually catches third-party decoder panics. Previously, `rawloader`'s out-of-bounds slice access on certain malformed RAW files (IIQ, ARW, CR3) aborted the entire app -- `catch_unwind` is a no-op under abort. The ~60-100 KB unwinding-machinery cost is worth the crash resistance for a viewer that ingests user files.
- Lightbox SVG rendering now uses `resvg` (pure-Rust) instead of relying on the gdk-pixbuf SVG loader, which is not always present in Flatpak runtimes. Restores SVG previews regardless of which pixbuf loaders the host bundles.
- Lightbox SVG parser now tolerates real-world SVGs that use undeclared XML namespace prefixes (e.g. `c2pa:` C2PA provenance metadata from Adobe exports). Missing namespaces are injected with placeholder URIs before parsing.
- Lightbox JPEG decoding now uses `libjpeg-turbo` (`turbojpeg` crate, vendored) as the primary decoder. Supports arithmetic-coded JPEGs (DAC marker) that `image-rs` and `gdk-pixbuf`'s Glycin backend reject with "header DAC is not supported".
- Lightbox WebP decoding now uses `libwebp` (`webp` crate, vendored) as the primary decoder. Handles complex WebP bitstreams that `image-rs`'s pure-Rust WebP decoder rejects as "corrupt".
- Lightbox JPEG 2000 (`.jp2`) decoding added via `openjpeg` (`jpeg2k` crate, vendored). Previously these were silently unsupported by both pixbuf and image-rs and only showed "Preview unavailable".
- Lightbox RAW decoder now catches panics from `imagepipe`/`rawloader` (out-of-bounds in `crw.rs` and `packed.rs` decoders on certain RAW files) and falls through to libraw rather than crashing the worker thread.
- Process-wide panic hook now filters out the noisy stderr messages from caught `rawloader`/`imagepipe` panics so the log stays readable when iterating over a folder of RAW files.
- Lightbox navigation between assets is now race-free: each load tags itself with a generation counter and skips its own `set_paintable` if the user has already navigated to a different asset by the time the decode finishes. Previously a slow RAW decode could clobber a newer image after rapid Next/Prev.
- Lightbox slide transitions now fire after the new image decodes, not before. Previously the slide animated to a copy of the current image (or to a blank target) and the new image popped in after; now the current image stays visible with a loader spinner while decode runs, and the slide animates straight to the loaded result.
- Pixbuf and image-rs decode failures in the lightbox now log at debug level instead of silently returning, making future format-support issues diagnosable from `mimick.log`.
- Dropped MPO from the supported-extensions registry; Immich's server rejects the format, so mimick no longer queues `.mpo` files for upload or tries to render them in the lightbox.
- Centralized the RAW-extension list in `media_kinds` (next to MIME mappings) and removed the duplicate hardcoded list from `library/mod.rs`. New `media_kinds::is_raw_ext()` helper for callers.
- Local folder thumbnails now generate correctly for RAW images (CR3, NEF, ARW, DNG, ORF, etc.) and other formats without built-in gdk-pixbuf loaders (HEIF, JXL, JP2, PSD). When `Pixbuf::from_file_at_scale` fails, the thumbnail cache falls back to `load_texture_blocking` (the same decoder pipeline used by the lightbox) and converts the result via `TextureDownloader` (GDK 4.10+) for scaling and disk caching. Previously these assets showed as broken/missing thumbnails in the linked folder local view.
- Explore view no longer filters the people row down to a single person after navigating away and back. The shared `search_entry` widget previously carried a person's name set by the person-click handler into the next Explore-view activation, where it was reapplied as the people filter. Clearing the entry on `content_stack` view switches restores the full people list. The same fix applies to the Albums view.
- Lightbox slide animation between assets is smoother. The stack child switch is now deferred by one idle tick so the target `GtkPicture` re-measures with the newly-painted texture before the slide starts; the first frame no longer captures the previous texture's aspect ratio.
- Added debug-level logging when the "Show hidden" people filter is toggled, printing the new state and the number of hidden people in the cached list so wiring issues vs empty server-side data are distinguishable from the log.

### Security

- Replaced `std::env::temp_dir()` usage in the RAW decode cache with `tempfile::NamedTempFile` to avoid predictable temp path vulnerabilities (`rust.lang.security.temp-dir.temp-dir`).

## [9.5.4] - 2026-05-17

### Added

- Per-folder sync rules: each watch folder can be set independently to **Upload only**, **Download only**, or **Full sync**. Bidirectional sync deletions (local→remote, remote→local) are configurable per folder and independent of the sync method, with both off by default (#120).
- Periodic remote-album reconciler (5 min) so changes made directly on Immich mirror back without waiting for the next startup scan (#120).
- Pre-flight checksum dedup before upload (batched on startup, per-asset on live events) and local rename detection so renaming doesn't cause an upload+trash cycle (#120).
- Three-tier local trash (`gio` → XDG portal → manual XDG) for reliable trashing of Flatpak document-portal paths (#120).
- Documented Immich API key permission requirements end-to-end: README/wiki tables, in-app welcome and field subtitles, 401/403 error guidance, and a troubleshooting entry (#120).
- Asset generator tool overhaul and testing wiki page (#118); Codacy badge in the README (#116).

### Changed

- Split three large modules into directory modules with focused submodules to improve incremental compile times: `library/mod.rs` (3725 LOC → 7 submodules), `api_client.rs` (2224 LOC → 6), `settings_window.rs` (2173 LOC → 2). No behaviour change (#117).
- Album→folder local trash is gated off until the upstream Flatpak portal trash bug is fixed; the settings toggle is disabled with an explanatory subtitle (#120).
- Info logs are quieter — internal mechanics moved to debug; `MIMICK_PROFILE=dev` defaults to `mimick=debug` (#120).
- CI: switched workflows to `ubuntu-latest`, decoupled the two Flatpak manifests' build triggers, removed the deprecated maintainer-approval workflow, and CodeQL now sets up Rust + `cargo fetch` for reliable extraction.
- Dependabot: bumped `taiki-e/install-action`, `github/codeql-action`, `flatpak/flatpak-github-actions`, and `release-drafter/release-drafter` (#119).

### Fixed

- Live file-monitor events no longer re-upload already-synced files. The `MonitorEvent::Ready` handler now consults `ShardedSyncIndex` via `sync_decision` before queueing, mirroring the startup-scan path. Without this, `PollWatcher` (Flatpak's polling watcher for portal FUSE paths) could lose its internal "seen" state under heavy I/O and re-emit Create events for unchanged files.
- Multiple deletion-safety fixes in the new sync engine: strict `album_id` match so re-targeting a folder doesn't mass-trash local files; per-album reconcile lock so manual + periodic sync can't race; two-tick confirmation for batch deletions >5; assets present elsewhere on the server (in another album, or referenced from another watch folder) are kept or only de-associated rather than fully trashed; orphan classification requires physical absence on disk (#120).
- Immich base64 asset checksums normalised to hex at deserialisation; self-induced filesystem events suppressed so own trash/download no longer propagate back as sync work; live monitor clears sync records only after the server op succeeds so transient failures retry on the next tick (#120).

## [9.5.3] - 2026-05-11

### Added

- Back navigation in the library window. The header bar now includes a back button (Alt+Left) that returns to the previously visited view (Photos, Album, Explore, etc.). A nav-history stack is maintained per library source — searches are not pushed since they're ephemeral, and consecutive duplicates are coalesced. The button is disabled when there's no history to return to.
- Lightbox image zoom support via Ctrl+scroll wheel, trackpad pinch gesture, on-screen `−` / `+` / `100%` button group, and Ctrl+`+` / Ctrl+`-` / Ctrl+`0` keyboard shortcuts. The current zoom percentage is shown in the centre button (click it to reset to fit). The zoomed image scrolls within the viewer for panning. Zoom level resets to fit-to-window when navigating between assets.
- Lightbox slide animation when navigating between images. Forward navigation (next button or Right arrow) slides the new image in from the right; backward navigation slides it in from the left. Falls back gracefully when GTK animations are disabled in system settings.
- Configurable test-asset generator script for reproducing deduplication and startup scan benchmarks across all supported API asset formats (#101).
- Graceful shutdown for in-flight uploads. Quitting the app now stops accepting new tasks, waits up to 5 seconds for active uploads to finish cleanly, then cancels anything still in flight via a cancellation token. Uploads cancelled at the deadline are persisted to the retry queue and resumed on the next launch instead of leaving partial assets on the server.
- Profile switcher for development and testing via the `MIMICK_PROFILE` environment variable. Each named profile (`MIMICK_PROFILE=dev`) gets fully isolated state: its own config file, sync index, retry queue, thumbnail cache, and keyring entry. The GTK application id is varied per profile so multiple profiles can run simultaneously without activating each other's windows. Portal folder grants are shared across profiles since they are scoped to the Flatpak app-id.

### Changed

- Disk thumbnail cache is now pruned on a 10-minute background interval instead of only at startup, and its cap was raised from 500 MB to 1 GB so long sessions no longer grow unbounded.
- Consolidated the three previously hand-maintained extension/MIME tables (file watcher, upload client, library enumerator) into a single `phf` perfect-hash registry. Eliminates table drift and turns the watcher's hot-path extension check from a 68-entry linear scan into an O(1) lookup.
- Hardened security by adding strict path sanitization against directory traversal on downloads, and enforcing `http`/`https` scheme validation for server URLs (#98).
- Centralized read/write lock configuration access into `AppContext`, eliminating redundant disk parsing and streamlining context usage across modules (#98).
- Replaced standard non-async locks (Mutex/RwLock) with `parking_lot` for faster operations, and added `atomic_write()` for crash-safe file persistence (#98).
- Eliminated single-lock bottlenecks by replacing the monolithic `SyncIndex` with a 16-shard `ShardedSyncIndex` backed by `RwLock` shards (#99).
- Significantly improved startup scan speeds by rewriting it as a two-stage parallel pipeline using `rayon` for fast directory enumeration and bounded asynchronous queueing (#99).
- Added a worker pool cap to file monitor events with backpressure channels rather than unbounded blocking spawns (#99).
- Implemented a custom `LibraryAssetModel` replacing the monolithic `gio::ListStore` to enable client-side sorting independently of server retrieval (#100).
- Memory unbounded growth issues when scrolling large remote libraries are resolved using a new 400-asset sliding window with FIFO eviction (#100).
- Implemented background lookahead thumbnail prefetching and lowered scroll trigger thresholds so thumbnails pop in faster while dragging down the grid (#100).
- Added formal sorting support (`SortOrder`) across metadata and OCR search endpoints from the client side (#100).
- Relocated the server connection status indicator from the sidebar top to the bottom for better visibility and layout balance.
- Removed the redundant checkbox toggle icon from the library header bar; selection mode is now managed via Ctrl-hold or keyboard interaction.
- Removed support for `.xmp` files from the media scanning and MIME detection logic as they are not utilized by the application.
- Removed the "Sync State" option from the library sort dropdown; it was only meaningful in unified/local views and produced no useful ordering in the standard photos view.
- Transfer direction in the progress bar is now shown as an icon (`mimick-upload-symbolic` / `mimick-download-symbolic`) rather than the text prefix "Uploading" / "Downloading", keeping the label focused on the active filename and speed.

### Changed

- Explore page Places section now shows all cities with geotagged assets instead of only the small popular subset returned by `/api/search/explore`. A new `fetch_all_places` method pages through all assets with EXIF city data, collecting unique cities and a representative thumbnail asset per city.

### Fixed

- Details pane timestamps (Taken and Created) no longer display the raw UTC ISO 8601 string with a confusing `+00:00` suffix. A new `format_datetime_display` helper parses the timestamp and formats it as `YYYY-MM-DD HH:MM:SS`, stripping the offset indicator so the displayed time matches the unambiguous value Immich recorded.

- Search pagination — particularly OCR search — now uses Immich's `nextPage` field as the source of truth instead of a "did we get a full page?" heuristic. Previously, when Immich's search response post-filtered results (for visibility, archive, library scope) it returned short pages even with more matches available, causing pagination to stop early and hide the rest. Applies to all four search endpoints (Smart, OCR, Metadata, Advanced) and to album/unified variants that route through the same endpoint.
- Closing the settings window no longer also closes the library window when background sync is disabled. The "quit when settings closes" path now checks for other open application windows first and only quits when settings was the only window left.
- Settings: the "Enable Library View" toggle, "Open Originals in Lightbox" toggle, and "Thumbnail Memory Cache (MB)" spinner now save immediately on change instead of requiring a click on the connection-save button. Each handler skips the disk write when the value matches the existing config (avoids redundant writes during initial population).
- Settings: the connection-save button has been renamed from "Save Connection Settings" to "Save Credentials" so the action label matches what the field group is actually about (URL + API key).
- Concurrent workers racing to create the same album on first run now serialize via a per-album-name lock with double-checked cache lookup, preventing N duplicate albums being created simultaneously (one per queued file).
- `fetch_all_albums` now collapses concurrent callers into a single network request via a fetch lock with double-checked `albums_fetched` flag. Previously, concurrent startup-scan workers each fired an independent `GET /api/albums`, then re-inserted the same entries and reported every album as a false-positive duplicate.
- Duplicate album detection now compares IDs within a single server response (built into a fresh map before replacing the cache), so "same name, same ID" entries from a re-fetch are ignored silently while genuine server-side duplicates (same name, different ID) still warn and keep the first.
- `refresh_album_cache` now holds the fetch lock across its clear → reset → refetch sequence, closing a race where a concurrent in-flight fetch could populate the cache after the clear but before the reset, leaving the cache empty with the flag set to true.
- Sync index state is now flushed to disk when the upload queue goes idle, ensuring a clean restart never re-queues already-uploaded files even after an immediate exit following a fast batch.
- Sync index is now flushed on graceful shutdown (tray quit, window close) so records written since the last 10-second periodic flush are not lost.
- SIGINT and SIGTERM signals now route through the GTK graceful shutdown path instead of killing the process immediately, so uploads drain, retries persist, and the sync index flushes before exit.
- `flush()` in the sync index now clears dirty bits only after a successful write. Previously, a failed `atomic_write` (e.g. disk full) would silently mark shards clean, causing subsequent flush calls to skip them and permanently lose the unwritten records.
- Removed a broken auto-flush trigger in `record_synced` that fired when `shard.entries.len()` was a multiple of 50 — this checked total entry count, not dirty-since-last-flush count, so it fired unpredictably and never for small datasets. Flush scheduling is now handled solely by the 10-second timer and idle-queue flush.
- Concurrent `check_connection` callers (queue workers, library ping loop, main loop) now serialize via a single-flight lock. Callers that arrive while a probe is already in flight coalesce onto its result within a 1-second window, eliminating redundant LAN/WAN ping bursts at startup without suppressing the 5-second library re-check.
- Escape key and Clear button now properly exit selection mode entirely instead of just clearing selected items.
- Asset sync status in the lightbox details pane and thumbnail hover now reflects the asset's true state (local only, remote only, or both) instead of being implied by the active view. Root cause: Immich returns SHA-1 checksums as base64 in API responses while the sync index stores them as lowercase hex; the representations are now normalised on read so checksum-to-path reverse lookups resolve correctly across all views including unified and album-unified.
- In-app symbolic icons (`mimick-upload-symbolic`, `mimick-download-symbolic`) are now compiled into the binary via `glib-build-tools::compile_resources` and registered at startup with `gtk::IconTheme::add_resource_path("/dev/nicx/mimick/icons")`, replacing a `theme.add_search_path(env!("CARGO_MANIFEST_DIR"))` call that resolved to a nonexistent path in all non-`cargo run` environments.

---

## [9.5.2] - 2026-05-07

### Added

- Right-click context menu on grid assets with download, open-with, and delete actions gated by asset type and source.
- Sync status icons (cloud/computer/check) and centered video badge overlay on grid thumbnails, replacing the old generic icon.
- Auto-refresh library surfaces after album creation, bulk delete, download completion, and album sync mutations.
- Queue inspector launchable from the library header bar, with enlarged dialog and improved long-path rendering.
- Settings save acknowledgement dialog on explicit save.

### Changed

- Updated `h2` and `tower-http` dependencies and removed unused `iri-string` dependency.
- Bumped `github-actions` dependencies (`taiki-e/install-action` and `github/codeql-action`).

### Fixed

- Sync index is now stored in the persistent data directory instead of the cache directory. Clearing the app cache no longer wipes sync state or triggers a full re-upload. Existing index files are migrated automatically on first run.
- Ctrl+click selection no longer skips the first asset. Holding Ctrl now reveals checkboxes transiently; clicking an asset commits the selection. Releasing Ctrl without clicking dismisses selection mode.
- Local and unified views for linked albums are now scoped to the selected album's linked folder only, instead of showing assets from all linked albums.
- EXIF orientation is now applied to thumbnails and lightbox images via `apply_embedded_orientation()`. Stale thumbnail cache entries are invalidated with a new cache key version.
- Details pane is now fixed at 320px width with `max_width_chars` constraints on labels so it no longer resizes dynamically with image dimensions.
- Grid view thumbnails now use a fixed 356px width (16:9 at 200px height) instead of expanding to fill available space.
- Explore page places grid and album tab tiles are now sized at 300x220px with a horizontal meta row layout (name left, count right) matching the explore page grid style.
- Consolidated duplicate refresh buttons by removing the sidebar refresh button and keeping the status bar one. Added F5 keyboard shortcut for refresh.

---

## [9.5.1] - 2026-05-04

### Fixed

- Startup view no longer forced to Settings when background sync is disabled; the default window (Library if enabled) now opens correctly.
- Direct navigation between Album and Explore views now works without routing through Photos first.
- Default folder name albums now auto-link to the correct remote album and no longer create duplicate config entries on re-save.
- Folder-linking UI is now hidden when navigating to Explore or Albums from within an album view so it only appears in relevant contexts.
- Local asset count in album sync no longer double-counts files reached via symlinks or duplicate paths.

### Changed

- Removed `--env=MESA_LOG_LEVEL=error` from Flatpak manifests

---

## [9.5.0] - 2026-05-03

### Added

- New Library View feature for browsing assets in-app with dedicated library navigation and interactions.
- Foundational library module components were introduced, including shared state wiring through `AppContext` and a dedicated library surface.
- Library search expanded with metadata filters, timeline search, OCR-selectable search dimensions, and random asset search.
- New Explore surface added for people, places, and things with integrated fetch flows.
- Library sidebar now includes album-focused navigation and source-aware controls for browsing.
- Local source enumeration was added for library integration and settings-driven source visibility.
- Asset details now include EXIF model support and richer asset-detail fetching.
- Albums view added with Recent, Owned, and Shared sections, plus in-app album creation.
- Album synchronization support added for library workflows.
- Thumbnail cache now supports ThumbHash + Base64 data paths for faster preview rendering.

### Changed

- Library source switching logic was refactored for readability and cleaner state transitions.
- Explore view and sidebar composition were refactored to simplify state management and UI behavior.
- Thumbnail loading/caching was reworked to reduce redundant fetches and improve cache initialization behavior.
- Thumbnail decode/load paths now use cancellation-aware, bounded work to smooth scrolling under heavy grids.
- Streaming downloads, disk-cache pruning, and sync-condition checks were optimized for runtime efficiency.
- App identifier references were renamed from `io.github.nicx17.mimick` to `dev.nicx.mimick` across desktop and project configuration.
- Documentation was updated to cover library view behavior and permissions in current builds.

### Fixed

- Grid view CSS states and layout behavior were polished for more consistent library interactions.
- Asset download error handling in library-related fetch paths was improved.

## [9.4.2] - 2026-04-28

### Changed

- Revised app logic to background sync. Now if background sync is disabled app won't persist in background when closed using window close button. App startup will open the settings window for the same. Quit action will work the same (Close the app).

- UI: about section is now moved to title bar

## [9.4.1] - 2026-04-25

### Added

- Stream startup scan candidates directly into the upload queue to reduce startup memory churn.

### Changed

- Fetch Immich albums immediately after saving connection settings.
- Parse album list responses into typed structs instead of generic JSON for safer handling.
- Use local time for quiet-hours checks.
- Reduce cloning of folder status state during settings UI refresh and avoid cloning the sync index during persistence to improve performance.
- Increase settings window startup width while preserving the 360px minimum mobile layout target.

### Fixed

- Fix live watcher queue metadata after settings changes so queue state remains consistent.
- Prevent the settings window from auto-saving partially populated UI state.
- Avoid creating albums during startup scan inspection and ensure album creation only happens when appropriate.
- Fix Application action buttons so About and Quit keep matching visual and touch target sizing.
- Initialize the Pause button label from the real queue state on first render.
- Fix install method card overflow so cards remain within the install block width.

### Removed

- Removed unused legacy config fields and dead monitor code.
- Removed the grain/noise background effect from the site theme.

## [9.4.0] - 2026-04-23

### Added

- Settings: Live auto-apply for most preferences (workers, quiet hours, folder rules, per-folder album selection, watch-folders). Connectivity fields (API key and server URLs) are now applied only when explicitly saved from the Connectivity section.
- Single-batch sync summary notification: multiple concurrent upload workers now aggregate results and emit a single "processed" summary notification when a sync batch completes.
- Flatpak packaging now targets the GNOME 50 runtime for current desktop compatibility.
- GitHub Pages repository pipeline now dynamically generates a `mimick.flatpakref` file for one-click graphical installations.

### Changed

- Logging: Console output is colorized by level and file logs use a plain, machine-friendly formatter with automatic rotation (approx. 2 MB per file, keep 5). See README and wiki for configuration details.

## [9.3.0] - 2026-04-14

### Added

- New notification toggle. Allow user to enable or disable the notifications sent through the app

### Changed

- Replaced `secret-tool` (libsecret CLI) with the `oo7` Rust crate for credential storage. Inside Flatpak, credentials are now stored in a portal-encrypted file within the sandbox. On native installs, the desktop's D-Bus Secret Service (GNOME Keyring, KWallet) is used directly. This eliminates the `user interaction failed` error that occurred when `secret-tool` tried to render a prompter dialog across the Flatpak sandbox boundary.
- The `.flatpakrepo` file now includes a `RuntimeRepo` directive pointing to Flathub. This allows Flatpak to automatically resolve and download the required GNOME Platform runtime on systems where Flathub is not pre-configured (notably Ubuntu 25+ and certain Fedora spins).
- Removed `libsecret` / `libsecret-1-dev` from build prerequisites. The `oo7` crate is pure Rust and requires no system-level keyring library at build time.
- Removed hardcoded `GSK_RENDERER=gl` from Flatpak manifests. GTK4 now auto-detects the best renderer (Vulkan, NGL, GL) for the host GPU.
- Removed unnecessary `--talk-name=org.freedesktop.secrets` from Flatpak manifests. The `oo7` crate uses the Secret portal inside the sandbox and does not need direct D-Bus access to the host keyring.
- Added `MESA_LOG_LEVEL=error` to Flatpak manifests to suppress harmless Mesa driver developer warnings (FINISHME notes) from cluttering application logs.
- Consolidated all documentation from `docs/` into the project wiki. The `docs/` markdown files have been removed to prevent drift.

### Fixed

- Fixed duplicate URL toggle validation handlers that caused two error dialogs to appear when disabling the last enabled URL switch.
- Added missing config fields (`startup_catchup_mode`, `upload_concurrency`, `quiet_hours_start`, `quiet_hours_end`) to the diagnostics redacted export and plain-text summary.
- Fixed Flatpak installation failing with `org.gnome.Platform was not found` on fresh Ubuntu and Fedora installations that do not ship Flathub enabled by default.

## [9.2.0] - 2026-04-14

### Changed

- Added support for`SingleMainWindow=true` to the `.desktop` launcher to better integrate with GNOME 50+ dock contexts preventing redundant "New Window" options.
- Migrated desktop notifications from the `notify-send` system command to native `gio::Notification`, fixing the issue where notifications would silently fail inside the Flatpak sandbox.
- Notifications now correctly display the app's SVG icon natively via the XDG Notification Portal constraint.
- Removed redundant async blocking wrappers (`tokio::task::spawn_blocking`) around notification dispatches, delegating instead directly to `glib::idle_add_once`.
- Cleaned up redundant branch metadata keys in the Flatpak manifests to optimize build parsing.
- Refined the "Startup Catch-up Mode" drop-down label length in the Settings UI so it no longer visually clips within its ComboRow box.

## [9.1.1] - 2026-04-10

### Changed

- Switched Flatpak repository to correctly advertise as `stable` instead of defaulting to a `beta` channel badge.
- Reconfigured the Flatpak repository builder workflow (`flatpak-repo.yml`) to exclusively deploy on new tag releases rather than on every push to the `main` branch.

### Fixed

- Fixed an internal GTK critical focus assertion error (`box != NULL`) that occurred when opening the folder rules configuration dialog.
- Fixed a bug where a discarded failed-upload task could leave a persistent "Pending: 1" ghost label on the folder configuration UI across application restarts.

## [9.1.0] - 2026-04-08

### Added

- Expanded supported media formats to match latest Immich server: AVIF, BMP, HEIF, JPEG 2000, JPEG XL, PSD, SVG, 3GPP, AVI, FLV, M4V, Matroska (MKV), MP2T, MXF, and more. The app now recognizes and uploads all Immich-compatible image and video extensions.

### Changed

- The settings window now explicitly follows the desktop light/dark appearance preference at startup, allowing light mode when the system theme is light.
- The `Status` page now uses a standard symbolic page icon for more consistent rendering across icon themes.
- Flatpak packaging now targets the GNOME 50 runtime for current desktop compatibility.

## [9.0.0] - 2026-03-29

### Fixed

- Fixed an Immich asset timestamp regression where newly uploaded files could land at the wrong timeline time or lose their intended timezone after server-side metadata processing.

### Changed

- Upload metadata handling now preserves filesystem-based creation times more reliably and reapplies the local timezone after upload so Immich keeps the correct asset date placement.
- The settings window now uses `Status` and `Settings` pages, shows the first-run API-key guidance at the top of the configuration flow, and no longer forces dark mode.
- `Save & Restart` has been replaced with live `Save Changes` behavior that updates the running API client, queue policy, upload worker count, and watched folders without relaunching Mimick.
- Watch-folder changes now reconfigure the live filesystem monitor in place, so adding or removing folders takes effect immediately after saving.

## [8.0.0] - 2026-03-25

### Added

- **Health Dashboard**: A visual status area on the Controls page showing active server route, watched folder count, pending items, recent retries, and latest errors.
- **Per-Folder Status**: The settings UI now displays the pending queue count and last sync time specific to each configured watch folder.
- **Permission Health Checks**: On startup, Mimick now verifies that it still has read access to all configured directories. If a Flatpak permission is lost, a warning is prominently displayed.
- **Safer Startup Catch-Up Controls**: Added a "Startup Catch-up Mode" dropdown in settings allowing users to limit startup scans to "Recent Changed Only (7 days)" or "New Files Only" to save on disk I/O.
- **Actionable Errors**: Meaningful connection failure and folder access loss messages replace generic request timeouts.
- **Better Album Picker**: The per-folder album selector is now a modal search dialog. Users can filter existing Immich albums by name, pick the default folder-name behavior, or type a new name to create an album on the fly.
- **First-Run Wizard**: When no API key is configured, Mimick automatically opens the Setup page and displays a welcome banner. The "Save & Restart" button is disabled until an API key is entered, preventing silent broken-connection states.
- **Notifications That Matter**: Replaced per-file notification spam with a single batch summary notification that fires once a sync cycle completes. Added a dedicated "Connection Lost" notification that fires after consecutive failures.
- **Upload Concurrency**: Users can now configure between 1 and 10 parallel upload workers in the settings, allowing for better tuning based on network capacity.
- **Quiet Hours**: Added a configurable quiet-hours window to pause uploads during specific hours of the day (e.g., to prevent impact on nighttime network usage).
- **Mobile Responsive UI**: Refactored the settings window from a rigid `adw::ApplicationWindow` to a native `adw::PreferencesWindow`. Primary controls and action buttons now use adaptive `FlowBox` layouts that auto-stack vertically on narrow displays (down to 360px), ensuring the app is fully usable on Linux phones and small monitors.
- **Adaptive Folder Rows**: Watch folder entries now use `adw::ExpanderRow` to hide additional settings (Album, Rules, Remove) until clicked, maximizing screen space on mobile.

### Fixed

- Fixed an "endless loop" bug where offline network conditions caused already-synced files to be incorrectly re-queued for reassociation.
- Fixed an issue where the processed file count in the UI would increment infinitely during network failures.
- Fixed a bug where a previously selected album target reverted visually to a "Custom Album" field after an application restart.

## [7.0.0] - 2026-03-22

### Added

- A queue inspector in the settings window with recent queue activity, failed-item visibility, per-item retry actions, `Retry All Failed`, and `Clear Failed Queue`.
- Manual sync controls in both the settings window and tray menu with `Pause / Resume` and `Sync Now` actions.
- Per-folder sync rules for ignoring hidden files, limiting maximum file size, and restricting allowed file extensions.
- A diagnostics export bundle that writes a support-friendly snapshot containing a summary, config copy, status cache, retry queue, sync index, and log file without including the API key.
- Best-effort environment-aware pausing for metered-network and battery-power operation.

### Changed

- Startup scans and live monitoring now apply the same per-folder rule checks and temporary-file filtering before queueing uploads.
- Shared runtime state now records recent queue events, pause reasons, the last completed file, and diagnostics export counts for better visibility and supportability.
- The settings window now separates `Setup` and `Controls`, uses a slimmer layout, and keeps `Close`, `Quit`, and `Save & Restart` pinned in a footer.
- Documentation now covers the new sync controls, diagnostics workflow, per-folder rules, and current test/packaging flow.
- CI and Flatpak publishing documentation now match the current `cargo fmt`, `cargo clippy --locked`, `cargo test --locked`, and containerized Flatpak build setup.

## [6.0.0] - 2026-03-15

### Added

- A startup catch-up scan that walks watched folders on launch and queues media that was missed while Mimick was not running.
- A local sync index that records previously synced files so unchanged media can be skipped quickly on later startups.

### Changed

- Changing the target Immich album for a watched folder now causes unchanged files to be reassociated to the new album on a later startup instead of being ignored.
- If a previously targeted album no longer exists, Mimick now refreshes album resolution and retries with the current configured album target.
- Terminal and file logs now include timestamped detailed formatting for easier troubleshooting.
- Flatpak tray integration now uses a narrower StatusNotifier permission model and no longer requests broad `org.kde.*` bus-name ownership.

## [5.0.1] - 2026-03-14

### Added

- GitHub releases now attach a signed `mimick.flatpakrepo` file and a `SHA256SUMS.txt` checksum file for easier end-user installs.

### Changed

- The GitHub Pages Flatpak repository workflow now signs published repo metadata with a dedicated GPG key and embeds the public key in the generated `.flatpakrepo` file.
- The release workflow now uses the same Flatpak signing key material from GitHub Actions secrets so release assets match the published repository trust chain.

## [5.0.0] - 2026-03-14

### Added

- A built-in **Run on Startup** setting that requests desktop-portal background permission in Flatpak builds and writes a native autostart desktop entry outside Flatpak.
- Friendly folder labels for portal-backed watch directories, so selected Flatpak folders show names like `Screenshots` instead of raw `/run/user/.../doc/...` paths.
- Real **Save & Restart** behavior that relaunches Mimick after settings are saved.
- Explicit **Close** and **Quit** actions in the settings window, plus a launcher **Quit Mimick** desktop action.
- A published GitHub Pages landing page for the Flatpak repository with direct install instructions and repository links.

### Changed

- Flatpak builds now use selected-folder access through the file chooser portal instead of `--filesystem=home`.
- Folder monitoring inside Flatpak now uses a polling watcher so portal-backed directories continue to sync reliably.
- Local Flatpak development builds now use the same selected-folder permission model as the deployed app.
- App quit paths now shut down gracefully instead of using a hard process exit from the tray.
- The Flatpak repository landing page has been redesigned with a simpler, more cohesive visual style and a one-click copy action for install commands.

## [4.0.0] - 2026-03-14

### Changed

- Added Flatpak packaging support
- Removed default photo watch path configuration on startup
- Polished AppStream metadata for Flathub compliance

## [3.0.0] - 2026-03-09

### Added

- **Complete Rust Port**: Entire application rewritten from Python/PySide6 to Rust + GTK4 + Libadwaita. Binary drops from ~80MB (PyInstaller bundle) to ~2MB.
- **Tokio async runtime**: Concurrent upload workers (configurable, default 3) with streaming `reqwest` multipart — constant RAM regardless of file size.
- **In-memory shared state**: `Arc<Mutex<AppState>>` replaces disk-based IPC polling. No disk I/O during normal operation.
- **`flexi_logger`**: Logs written to both stdout (systemd) and `~/.cache/mimick/mimick.log` for persistent debugging.
- **Tray via `ksni`**: StatusNotifierItem tray using a `tokio::sync::watch` channel — no zombie processes, no D-Bus spawn.
- **Duplicate upload prevention**: `active_tasks` HashSet in the file monitor prevents multiple `wait_for_file_completion` tasks for the same file during long writes (e.g. screencasts).
- **App ID standardized**: Unified to `io.github.nicx17.mimick` across the binary, `.desktop`, `.metainfo.xml`, icons, and install scripts.
- **AppImage packaging**: `build_test_appimage.sh` compiles a release binary and assembles a standard AppDir in 5 steps.

### Changed

- Settings window uses hide-on-close (built once per process) — eliminates repeated GTK widget tree allocations.
- `ImmichApiClient` is a singleton (`OnceLock`) — single `reqwest` connection pool for the lifetime of the process.
- Autostart now uses `io.github.nicx17.mimick.desktop` symlink.
- All documentation (`ARCHITECTURE.md`, `DEVELOPMENT.md`, `TESTING.md`, `TROUBLESHOOTING.md`, `APPIMAGE_CREATION.md`) updated for Rust/Cargo.
- GitHub Actions release workflow updated for Rust toolchain.
- CodeQL analysis updated to use `languages: rust` with `build-mode: none`.

### Removed

- All Python source files (`main.py`, `settings_window.py`, `tray_icon.py`, etc.)
- `requirements.txt`, `pyproject.toml`, `setup.py`, `MANIFEST.in`

## [2.0.1] - 2026-03-08

### Changed

- Renamed repository and backend strings from `immich_sync_app` to `mimick`

## [2.0.0] - 2026-03-08

### Added

- **Complete Rebranding to Mimick**: Officially renamed the project from "Immich Sync" to "Mimick" to establish a unique identity and drop the generic moniker. All internal app IDs, metadata, documentations, and daemon variables have been fully synchronized.
- **GTK4 / libadwaita Migration**: Totally replaced the heavy PySide6 UI framework with a native, responsive GTK4 + libadwaita interface. The application now perfectly mimics the native look and feel of modern GNOME and KDE desktop environments.
- **Scalable Vector Icons**: Modernized app icon integration by deploying the high-resolution `mimick.svg` into system `hicolor/scalable/apps/` directories.

### Changed

- AppImage build scripts and installation loops have been completely restructured to support the new `mimick` nomenclature and GTK requirements.
- Standardized the GNOME window `StartupWMClass` bindings effectively preventing stray or duplicate launcher icons on Wayland/X11 desktops.

## [1.0.2] - 2026-03-07

### Fixed

- **AppImage Python 3.12 Bundle**: Overhauled AppImage scripts to download and bundle a standalone `python-build-standalone` payload, resolving missing C-Extension (`Pillow`) bugs on modern OS hosts (like Ubuntu 24).
- **GTK AppIndicator Native Support**: Added `PyGObject` to the packaged environment and successfully bridged host GUI drivers via `GI_TYPELIB_PATH` to ensure system tray icon features don't crash under isolated packaging.
- **Duplicate Album Creation Race Condition**: Implemented `threading.Lock()` on the `get_or_create_album` REST endpoint to ensure multiple simultaneous workers handling bulk image drops to new directories don't spawn multiple identical albums on the server if they bypass the cache at the same time.
- **Ubuntu 24 Tray Icon Crash**: Added graceful try/except block wrapping around the `TrayIcon/pystray` initialization loop. On modern Desktop Environments (Ubuntu 24 Wayland / Mutter) that deny AppIndicator injection, the application no longer permanently fails. Instead it safely disables the visual tray while dropping seamlessly into a headless background daemon. Launching from the GUI menu with the tray disabled intelligently loads the Settings Window.

## [1.0.1] - 2026-03-07

### Added

- **File Move/Rename Support**: `ImmichEventHandler` now captures `on_moved` watchdog events. Temporary file downloads (e.g. `video.mp4.tmp` from web browsers, rsync, Syncthing) that later rename internally to a valid media extension are now successfully captured and pushed to the upload queue.

### Fixed

- **Incomplete Video File Upload Bug (`wait_for_file_completion`)**: Prevented massive media files (like 30-minute GUI screencasts) from triggering early timeouts before they were fully written. Replaced absolute 10s wait logic with an adaptive 300-second _idle_ timeout loop; continuously growing items dynamically rest the counter keeping uploads safe regardless of copy duration.

## [1.0.0] - 2026-03-06

### Added

- **Animated UI Toggles**: Added custom beautiful `SlideSwitch` CSS animations to the Settings Window allowing users to visually toggle Internal (LAN) vs External (WAN) URL behaviors on and off.
- Config now persists `internal_url_enabled` and `external_url_enabled` booleans.
- Expanded testing coverage for `api_client` and `config` including advanced error-state simulation and file-system failure catching.

### Fixed

- **Captive Portal Bug Fix**: The API Ping routing logic now strictly requires a `{"res": "pong"}` JSON payload resolution to avoid falsely pinging local cafe Wi-Fi captive portals and breaking sync loops.
- **Failover Cache Reset Bug Fix**: Fixed an issue where a timeout connection to the Internal URL loop would not flush the active API endpoint causing the logic to effectively loop blindly instead of bouncing sequentially to the External URL.
- Fixed critical App UI freezing (App Not Responding) during testing connection pings syncing via a synchronous socket process - now visually wraps tests via Qt override wait cursors.
- **Queue Offline Resolution Fix**: Fixed a data-loss bug that permanently flushed queued failed uploads if the user closed the window. Implemented `~/.cache/mimick/retries.json` to seamlessly save pending cache limits, accompanied by an explicit background locking worker loop restoring files successfully.

## [0.2.0] - 2026-03-06

### Added

- AppImage distribution! A new fully packaged AppImage version of `mimick` is now available, bundling `PySide6` and all Python dependencies into a single, highly portable executable.
- Introduced `AI_CONTEXT.md` to help agentic tools understand the application's unique multi-threaded API architecture, system constraints, and X11/Wayland workarounds.

### Fixed

- Fixed critical Qt 6 Wayland connection error where the DBus portal rejected window launching (`Could not register app ID`). Application metadata is now strictly set before Qt engine initialization.
- Fixed a metadata warning regarding the `.desktop` suffix in Qt's `setDesktopFileName` handler.
- Fixed buggy AppRun bash script backslash escaping that was causing `Exec format error` exceptions inside generated `AppImage` distributions.
- Fixed a bug where native AppImages were trying to execute `main.py` outside of isolated module logic.

### Changed

- Promoted project status from Alpha to properly release `v0.2.0` (removed beta tags completely from code structure and internal About tags).
- Modified API `_ping` function tests from testing generic text formats to raw JSON validation checks.
- Added robust direct-file editing scripts to fully automate AppImage extraction, generation, and packaging (`build_test_appimage.sh`).
- Updated PySide6 dependencies and application system documentation (`ARCHITECTURE.md` and `DEVELOPMENT.md`).

## [0.1.0-alpha] - 2026-03-03

### Added

- Created `AppImage` deployment script and comprehensive guide for easy Linux distribution natively bundling `PySide6` and python libraries.
- Extended testing suite to cover `notifications`, `tray_icon`, and `state_manager` using fully mocked implementations.
- Implemented desktop entry integration and `install.sh` enhancements standardizing icons to `/usr/share/pixmaps`.
- Added new AppImage-specific helper scripts (`install-appimage.sh` and `uninstall-appimage.sh`).
- Added User Guide (`docs/USER_GUIDE.md`), Testing Guide (`docs/TESTING.md`), and Architecture Guide (`docs/ARCHITECTURE.md`) to assist end-users and developers.
- Added `CONTRIBUTING.md` and initial project scaffolding.
- Added modern structural badges and active Alpha-phase developmental warnings to the `README.md`.
- Properly credited application icon to Unsplash's Round Icons.

### Fixed

- Fixed issue on GNOME/X11 where the application icon would not render in the dock or settings window due to misaligned `.desktop` metadata (`StartupWMClass`).
- Revised the `install.sh` routine to ensure Python virtual environment integrity and `pip` availability before attempting dependency installation.

### Changed

- Transitioned project license from MIT to **GPL-3.0**.
- Refactored PySide6 window initializations to fallback to a reliable absolute image path as opposed to breaking natively on XDG theme engines lacking caching.
- Updated `pyproject.toml` and `setup.py` metadata for publishing (PyPI readiness), adding GPLv3 and Alpha classifiers.