v1.0.3

Whats Changed

Additions

• Added a "Fix NXM Handler…" button to Settings (General) to re-register the nxm:// protocol handler on demand, if Nexus's "Download with Manager" ever opens the wrong app or does nothing

Bug Fixes

• Fixed "Download with Manager" on Nexus sometimes opening a brand-new Mosaic window instead of using the one already running. Closing any duplicate/stray Mosaic window could silently delete the running instance's download-handoff channel, so the next Nexus download had nowhere to go. Mosaic now enforces a true single-instance lock — only one window can ever be open at a time, and a second launch attempt (a Nexus download link, or just relaunching the app) is handed off to the existing window instead of opening a new one. This also closes a real (if rare) risk of two instances deploying or restoring mods for the same game at the same time

---

Run the following command to install/Update. Or download the appimage directly.

curl -sSL https://raw.githubusercontent.com/TheMrGeeBee/Mosaic-Mod-Manager/main/src/appimage/Mosaic-MM-installer.sh | bash

v1.0.2

Whats Changed

Additions

• Baldur's Gate 3 mod.io updates now open a "Change Version" picker instead of installing immediately — mirrors the existing Nexus flow, letting you review the file history (with each version's changelog) and pick which one to install before anything downloads. Click the mod.io update flag, or use "Change Version (mod.io)" in the right-click menu; "Quick Update (mod.io)" stays available for one-click installs without reviewing
• Added "Ignore Update" support for mod.io mods, mirroring the existing Nexus feature — dismiss a specific version so it stops being flagged as an update until a newer one is published

Changes

• The Change Version (mod.io) file list now shows the mod's name instead of the raw archive filename (e.g. a hash-suffixed zip name); the archive filename is still available as a tooltip
• The right-click menu's "Nexus Actions" and "mod.io Actions" submenus now appear independently based on where a mod actually exists — a Nexus-only mod no longer shows an empty-looking "Nexus Actions" entry for a mod.io-only "Check Updates", and vice versa. "Check Updates" itself (which checks both sources at once) is now a single top-level item shown whenever either applies

---

Run the following command to install/Update. Or download the appimage directly.

curl -sSL https://raw.githubusercontent.com/TheMrGeeBee/Mosaic-Mod-Manager/main/src/appimage/Mosaic-MM-installer.sh | bash

v1.0.1

Whats Changed

Bug Fixes

• Fixed "Check for Update" silently reporting "All mods are up to date" right after launching the app without actually checking anything. A one-time keyring-availability check at startup could lose a race against the desktop's secret-service daemon and get permanently stuck treating Nexus as logged out for the rest of the session — only a full restart fixed it. The check now retries instead of caching that failure forever
• Fixed two Nexus GraphQL update-check requests skipping the OAuth token-refresh step every other request performs, which could silently return no results for mods with a stale access token
• The update summary now shows "Nexus: not logged in" instead of a misleading "All mods are up to date" whenever the Nexus half of a check was skipped due to a login problem

---

Run the following command to install/Update. Or download the appimage directly.

curl -sSL https://raw.githubusercontent.com/TheMrGeeBee/Mosaic-Mod-Manager/main/src/appimage/Mosaic-MM-installer.sh | bash

v1.0.0

Whats Changed

• Renamed to Mosaic Mod Manager. The project is no longer an upstream-tracking fork of Amethyst Mod Manager — see ATTRIBUTION.md for credit to the original project this began as. Version numbering resets to v1.0.0 to mark the relaunch; nothing below this point ever shipped as a v2.0.6 release, so this section carries that unreleased work forward under the new name and number

Additions

• Added a per-mod reorder lock: locked mods can't be dragged, sorted, moved to a separator, removed, or moved to another profile until unlocked (rename and notes remain available). "Set priority…" shows greyed out while locked
• Added the ability to copy or move separators (name, colour, lock state) to another profile, preserving their relative order
• Added a dedicated "Locked" column for the per-mod reorder lock (click to toggle), hidden by default but automatically shown when a loaded profile actually has a locked mod, so shared/imported profiles surface their locks
• Baldur's Gate 3 mods installed from mod.io now have their mod ID, version, uploader and tags identified automatically at install time, without needing to run "Check for Updates" first
• The Category, Uploaded By and Version columns now show mod.io tags/uploader/version for mods that have no Nexus metadata
• Baldur's Gate 3 mods flagged with a mod.io update can now be updated directly from the modlist — click the update flag or use "Quick Update (mod.io)" in the right-click menu — instead of having to open the mod.io page and install the file manually
• Added a Mosaic-branded startup splash screen (mosaic mark + wordmark) with a minimum display time, so it no longer flashes by too quickly to read on fast startups

Changes

• Fixed the "Show / hide columns" tooltip capitalisation to "Show / Hide columns"

Bug Fixes

• Fixed mods not retaining their priority order when copied or moved to another profile while the modlist was sorted by a column or in reverse-priority view
• Fixed separator colour/lock/collapsed state not being fully cleaned up when a separator was removed
• Fixed mod and separator reorder-lock state being silently dropped from share-code (AMMCODE1) exports and imports
• Fixed "Export as Mosaic package" refusing to export profiles containing mod.io-identified mods; such mods are now bundled into the export like other bundle-sourced mods
• Fixed mod.io update detection reporting a false "update available" when the newest uploaded file was a hidden/test build rather than the mod's actual public release
• Fixed mod.io uploader/tags staying permanently blank for mods identified before those fields existed; "Check for Updates" now backfills them
• Fixed mod.io update checks repeatedly retrying (with several seconds of backoff each time) mods whose pak carries a leftover/placeholder PublishHandle that was never actually published to mod.io
• Fixed installed mods sometimes not appearing in the modlist until "Refresh Modlist" was clicked — using the "Rename mod after install" prompt could save a stale copy of the modlist over the mod's just-written entry
• Fixed a data-loss race where two near-simultaneous writes to modlist.txt (e.g. a background install and a manual reorder/toggle) could silently drop one of them
• Fixed Deploy/Restore being able to start while a mod install or collection install was still running, which could make the install write its files/index against the wrong profile

---

Run the following command to install/Update. Or download the appimage directly.

curl -sSL https://raw.githubusercontent.com/TheMrGeeBee/Mosaic-Mod-Manager/main/src/appimage/Mosaic-MM-installer.sh | bash

v1.0.0-beta.1

• Renamed to Mosaic Mod Manager. The project is no longer an upstream-tracking fork of Amethyst Mod Manager — see ATTRIBUTION.md for credit to the original project this began as. Version numbering resets to v1.0.0 to mark the relaunch; nothing below this point ever shipped as a v2.0.6 release, so this section carries that unreleased work forward under the new name and number

Additions

• Added a per-mod reorder lock: locked mods can't be dragged, sorted, moved to a separator, removed, or moved to another profile until unlocked (rename and notes remain available). "Set priority…" shows greyed out while locked
• Added the ability to copy or move separators (name, colour, lock state) to another profile, preserving their relative order
• Added a dedicated "Locked" column for the per-mod reorder lock (click to toggle), hidden by default but automatically shown when a loaded profile actually has a locked mod, so shared/imported profiles surface their locks
• Baldur's Gate 3 mods installed from mod.io now have their mod ID, version, uploader and tags identified automatically at install time, without needing to run "Check for Updates" first
• The Category, Uploaded By and Version columns now show mod.io tags/uploader/version for mods that have no Nexus metadata
• Baldur's Gate 3 mods flagged with a mod.io update can now be updated directly from the modlist — click the update flag or use "Quick Update (mod.io)" in the right-click menu — instead of having to open the mod.io page and install the file manually

Changes

• Fixed the "Show / hide columns" tooltip capitalisation to "Show / Hide columns"

Bug Fixes

• Fixed mods not retaining their priority order when copied or moved to another profile while the modlist was sorted by a column or in reverse-priority view
• Fixed separator colour/lock/collapsed state not being fully cleaned up when a separator was removed
• Fixed mod and separator reorder-lock state being silently dropped from share-code (AMMCODE1) exports and imports
• Fixed "Export as Mosaic package" refusing to export profiles containing mod.io-identified mods; such mods are now bundled into the export like other bundle-sourced mods
• Fixed mod.io update detection reporting a false "update available" when the newest uploaded file was a hidden/test build rather than the mod's actual public release
• Fixed mod.io uploader/tags staying permanently blank for mods identified before those fields existed; "Check for Updates" now backfills them
• Fixed mod.io update checks repeatedly retrying (with several seconds of backoff each time) mods whose pak carries a leftover/placeholder PublishHandle that was never actually published to mod.io
• Fixed installed mods sometimes not appearing in the modlist until "Refresh Modlist" was clicked — using the "Rename mod after install" prompt could save a stale copy of the modlist over the mod's just-written entry
• Fixed a data-loss race where two near-simultaneous writes to modlist.txt (e.g. a background install and a manual reorder/toggle) could silently drop one of them
• Fixed Deploy/Restore being able to start while a mod install or collection install was still running, which could make the install write its files/index against the wrong profile

---