What's improved
- Database update (FL-1683): Frameleaf moves from PostgreSQL 19 RC 1 to the final PostgreSQL 19.0. Update Frameleaf Manager to 1.2.25 first; it copies your database to PostgreSQL 19.0 during the Frameleaf update and keeps the old copy until it succeeds. Plain Docker Compose installs: follow "Moving to a new PostgreSQL build" in the Postgres administration docs before starting the new release.
- Back up your whole server to Frameleaf Cloud from Manager (FL-1665, FL-1667, FL-1668, FL-1669, FL-1670, FL-1672, FL-1673, FL-1679, FL-1689, FL-1690, FL-1692, FL-1694, FL-1695, FL-1696, FL-1697): Manager can back up your photo server, settings and database to Frameleaf Cloud on a schedule, with a speed limit and a time window. A replacement server can restore everything at once from a list of what was protected, or just the files you pick. Every backup includes Manager's settings and your library's backup keys, and runs on your own time zone. A recovery kit, and an optional locked copy of the recovery key in Frameleaf Cloud, get a new server back; it picks up the old server's backup settings. You can disconnect from Frameleaf Cloud or delete this server's backups, with 30 days to change your mind. On HexOS, Server Backup can protect the NAS's own folders. Server Backup uses your server's existing licence. This is an early preview and is switched off unless you turn it on.
- Cloud Backup restores by date and folder (FL-1666, FL-1675, FL-1676, FL-1677): browse a backup as it was on any kept date, restore whole folders or single files, and bring back an earlier version of a file that changed. Uploads can have a speed limit and set hours. File names and contents are encrypted before they leave your server.
- Bring video projects from other editors into Studio (FL-1542, FL-1543, FL-1544, FL-1545, FL-1546, FL-1547, FL-1548, FL-1550, FL-1551, FL-1552, FL-1566): import projects from Premiere Pro, DaVinci Resolve, Final Cut Pro, Avid (AAF), OpenTimelineIO and EDL, with each clip matched to its media. You can also send a project back out to another editor.
- Studio (FL-642, FL-1203, FL-1204, FL-1444, FL-1555, FL-1556, FL-1557, FL-1558, FL-1559, FL-1561, FL-1562, FL-1563, FL-1564): crossfades and curves for sound, sound channel mapping, colour tools (ASC CDL, lift/gamma/gain, hue curves and LUTs kept with the project), HDR-correct transitions and grading, new transitions, markers with notes, fonts kept with the project, and smoother playback of long clips.
- Choose what you share with a partner (FL-774, FL-786, FL-837, FL-922): share only chosen albums, people, folders or dates. Favourite shared photos just for yourself, add photos from a shared album or link to your own library, and give new shared links an expiry date by default.
- Albums (FL-838, FL-846, FL-869, FL-881): an album for each folder in a library, kept in step when the folder changes. Move photos between albums, hand an album to someone else, put photos in your own order and add text cards.
- People (FL-874, FL-864, FL-941, FL-1365): group people as Family, Friends, Work and more, add a date of passing and private notes, and keep archived photos out of People when you choose.
- Duplicates and downloads (FL-826, FL-832, FL-1660): set your own rules for which copy of a duplicate to keep. Frameleaf never suggests keeping a damaged or missing copy over a good one. Downloads can be the original, a full-size JPEG or a smaller web size.
- Search and Best Photos (FL-976, FL-1597, FL-1653, FL-1655): find photos that are in more than one album. Visual search answers quickly on large libraries and shows more than 100 results. Best Photos works with the larger search model.
- Eyes in culling (FL-843, FL-863, FL-891): each face gets eyes-open and sharpness scores, so you can sort by them and filter out closed eyes when picking from a shoot.
- More graphics hardware for machine learning (FL-984, FL-997, FL-1001, FL-1715): smart search and faces can run on an Intel NPU, NVIDIA GPUs on arm64 servers are supported (with an NVIDIA driver that supports CUDA 13), and the Desktop helper can use DirectML on Windows. Desktop helpers set themselves up from the machine learning settings, and several desktops can share the work.
- Imports and uploads (FL-797, FL-818, FL-849, FL-1030, FL-1661, FL-1662, FL-1685): a first iCloud sync starts downloading straight away instead of after listing your whole library, and a sync carries on after an interruption. Lightroom ratings, keywords, captions and collections come across. Large phone videos and CLI uploads pick up where they stopped.
- Imported photo times (FL-1683): photos imported from Photoview, LibrePhotos, Lychee, Nextcloud, pigallery2, Piwigo and PhotoPrism keep their own local time when your server isn't set to UTC, and exact timestamps keep their fractions of a second. Imports no longer stop with a mismatch on those servers.
- Bookings (FL-1606): confirm booking requests from your studio website as they arrive, with an email to the client, and add a Booking section to your website.
- Guest selfie search on Frameleaf Cloud by default (FL-1605): when face recognition is set to use Frameleaf Cloud, a gallery guest's selfie is matched there too, with no extra setting. If you keep your photos at home, guest selfies never go to Frameleaf Cloud.
- Library care (FL-977, FL-1362, FL-1378, FL-1674, FL-1680, FL-1686): file checks pace themselves instead of reading every photo every night. JPEG repair keeps the whole picture, and earlier repairs that cut photos short are made again. Video playback gets a self-test, and failed restore drills tell administrators.
- Manager (FL-973, FL-1538): go back to the version before the last update, with its database.
- Fixes (FL-1361, FL-1367, FL-1371, FL-1374, FL-1497, FL-1607, FL-1649, FL-1650, FL-1651, FL-1652, FL-1656, FL-1657, FL-1658, FL-1659, FL-1681, FL-1693, FL-1698, FL-1718, FL-1719, FL-1720, FL-940): the timeline no longer jumps to another month while photos are processing, and shift-click selects a range from the photo you clicked last. Long videos keep their thumbnail. The import bar counts photos. Activity, Memories and Places load faster and look right. Thumbnails from a folder scan start sooner, BMP colours are right, removing an account no longer fails, and the "Nothing lost" totals show by month and account. Live updates no longer blank Boards and library grids, edited videos keep their edited size, and the years chart fits on phones and counts photos from external libraries. Importing from Eagle lets you browse the server for the library folder, a new album opens as soon as you create it, and the library no longer reloads over and over during an upload.
Jira issues resolved
- FL-1374: fix(server): RGB565 BMP opens with the right colours (#1225)
- FL-1606: Bookings: confirm website booking requests live, email the client, and a Booking section on the studio website (#1226)
- FL-1607: fix(server): thumbnails from a library scan start before the whole library's metadata is read (#1227)
- FL-1605: Match gallery guest selfies on Frameleaf Cloud by default (#1228)
- FL-1440: Branding scan no longer allows an upstream Immich remote (#1229)
- FL-1538: Manager: Jobs at once stops at 32, the server's limit (#1231)
- FL-1361, FL-1367: Sign-in: count a guess before checking it; passkey reset ordering test (#1230)
- FL-1497: Removing an account no longer fails when its files are trashed at the same time (#1233)
- FL-1203, FL-1204: Studio exports promise the sound of imported songs (#1235)
- FL-1365: People: archived-photos choice applies to the People total and recognition's featured face (#1236)
- FL-1444: Smooth Motion chunks seek to their keyframe instead of decoding from the start (#1237)
- FL-642: Studio: windowed export with the master limiter, and split-clip colour match uses parent grade keys (#1243)
- FL-1546, FL-1547, FL-1548: Editor import: read FCPXML, Final Cut Pro 7 XML, OpenTimelineIO and EDL (#1239)
- FL-1371: Home Assistant: re-sign-in must be the same account; an unfinished events setup carries on (#1244)
- FL-1362: Library care: an older Try again waiting for a drive doesn't run after a newer one (#1238)
- FL-843: ML: eyes-open and eye-sharpness scores per detected face (#1241)
- FL-1378: Restore drill: a drill that can't be recorded ends as failed and tells administrators (#1240)
- FL-976: Search: filter for photos in more than one album (server) (#1234)
- FL-780: Threat model for connected apps, MCP and webhooks, with the small fixes it found (#1262)
- FL-846: Albums: move photos between albums and transfer ownership (server) (#1245)
- FL-1455: Mark rebuilt Library growth buckets in the analytics report (#1232)
- FL-973: Manager: go back to the version before the last update, with its database (#1260)
- FL-1566: Send a project back: write OpenTimelineIO, Final Cut Pro XML, Final Cut Pro 7 XML and EDL (#1268)
- FL-1555: feat(studio): crossfades between sound clips, and sound curves (#1242)
- FL-1542, FL-1543: Editor import: the import job, its endpoints, and finding each clip's media (#1248)
- FL-1557: Studio: the bundled render worker renders compositions and Lottie (#1246)
- FL-922: Sharing: default expiry for new shared links (server) (#1254)
- FL-864, FL-941: People: date of passing and private notes (server) (#1271)
- FL-940: Nothing lost: totals by month added and per account (server) (#1266)
- FL-1001: Desktop ML runtime: DirectML provider for Windows helper computers (#1279)
- FL-818: Shared resumable upload client in the TypeScript SDK (#1274)
- FL-797: Big phone videos stay resumable for 7 days after their latest bytes (#1253)
- FL-1563: feat(studio): marker ranges, notes and clip markers (#1252)
- FL-1597: Best Photos: learned score for SO400M and an admin note for an own search model (#1249)
- FL-977: Library care: video playback self-test with software fallback (#1270)
- FL-1564: feat(studio): Film Dissolve, Cross Zoom, Cube Spin and Page Peel (#1247)
- FL-1030: Read catalog ratings, keywords, captions and collections into Frameleaf (#1280)
- FL-849: CLI upload and watch resume interrupted files (#1275)
- FL-984: Machine learning: run smart search and faces on an Intel NPU through OpenVINO (#1277)
- FL-1544, FL-1545: Editor import: Import on the Studio projects page, and import notes in the editor (#1251)
- FL-838: Albums: an album for each folder in a library, kept in sync on rescan (server) (#1267)
- FL-1559: feat(studio): ASC CDL, lift gamma gain per channel, and hue curves (#1250)
- FL-1550: Editor import: read a Premiere Pro project (.prproj) (#1255)
- FL-1558: Studio: LUTs kept beside the project, 1D LUTs, a 24 MiB graph and a 5,000-clip timeline run (#1256)
- FL-863: Culling: store eye scores per face and score Clients shoots first (#1258)
- FL-1552: Editor import: read AAF (#1263)
- FL-1561: Studio sound: channel mapping on a clip's sound (mono, dual mono, picks from 5.1) (#1269)
- FL-869, FL-881: Albums: custom photo order and text cards (server) (#1261)
- FL-1551: Editor import: read DaVinci Resolve projects and timelines (.drp, .drt) (#1265)
- FL-891: Clients: eye badges, closed-eyes filter and eye-quality sort in culling (#1259)
- FL-1562: Studio titles: fonts kept with the project (#1272)
- FL-837: Sharing: add to my library from a shared album, space or link (server) (#1283)
- FL-1556: Studio HDR: transitions and grading effects render in linear HDR (#1281)
- FL-774: Sharing: share only chosen albums, people, folders or dates with a partner (server) (#1276)
- FL-786: Sharing: personal favourites on shared items (server) (#1278)
- FL-874: People: categories such as Family, Friends and Work (server) (#1273)
- FL-826: Downloads: choose original, high-quality JPEG or web size (server) (#1264)
- FL-832: Duplicates: rules for which copy to keep (server) (#1257)
- FL-1649: fix(web): space the Activity stage groups below the upload cards (#1284)
- FL-1650: fix(web,server): count photos, not thumbnail-queue jobs, in the import bar (#1285)
- FL-1651: fix(server): long videos keep their thumbnail when the embedded-metadata read times out (#1286)
- FL-1652: fix(web): shift-click ranges from the photo clicked last, not only a ticked one (#1287)
- FL-1653: fix(server): partner copies wait for their original before visual search (#1288)
- FL-1655: fix(server): visual search ranks through the index and pages past 100 (#1289)
- FL-1657: fix(server): details detection resumes after a failed start; shared pools do not wait on WAL flush (#1290)
- FL-1656: Activity: read a large unfinished run from a stored tally (#1291)
- FL-1658: perf(server): visited landmarks read each item once and sort less (#1292)
- FL-1659: fix(web): Memories Upcoming row no longer scrolls by a few pixels (#1293)
- FL-1660: Duplicates: never suggest or trash in favour of a damaged or missing copy (server) (#1294)
- FL-1661: fix(server): sweep Google Photos import staging nothing owns (#1295)
- FL-1662: iCloud sync: a run survives a lapsed claim (server) (#1296)
- FL-1665: Backup engine: repository format v1 with backup, restore, prune and verify (#1297)
- FL-1667: Backup engine: S3 storage with short-lived credentials, multipart and a speed limit (#1298)
- FL-1668: Manager: Server Backup jobs, routes and screens (before the Cloud link) (#1299)
- FL-1669: Manager: its own link to Frameleaf Cloud as a backup machine (#1300)
- FL-1670: Manager: Server Backup stores through Frameleaf Cloud (#1301)
- FL-997: Machine learning: CUDA image for arm64 NVIDIA servers (#1282)
- FL-1671: ci: run the workflows on self-hosted Forgejo runners
- FL-1671: ci: fixes for main's first run on Forgejo runners (#1303)
- FL-1678: Publishing: release from Forgejo, mirror images to Docker Hub and Forgejo (#1306)
- FL-1682: fix: main's type-check and web build after the 11-17 merges (#1311)
- FL-1683: ci: artifact actions and GHCR logins that work on Forgejo (#1315)
- FL-1684: ci: read cloud-contracts from Forgejo's npm registry on Forgejo (#1316)
- FL-1672: Manager: Connect Cloud step and restore from another server's backups (#1302)
- FL-1673: Server Backup shares the photo server's licence: the server vouches for its Manager (#1304)
- FL-1674: fix(server): colour palette waits for a preview instead of decoding the original (#1305)
- FL-1675: Backup engine: the photo server takes its shared backup helpers from packages/backup-core (#1307)
- FL-1680: fix(server): repair reads a JPEG whole whatever its decoder warns, and old repairs are made again (#1308)
- FL-1679: Server Backup: restore a whole server from a list of what was protected (#1309)
- FL-1681: fix(web): timeline refresh keeps the month on screen (#1310)
- FL-1676: Cloud Backup on the backup engine; old formats and object index removed (#1312)
- FL-1677: Cloud Backup restore by folder and earlier version; upload speed limit and hours (#1313)
- FL-1666: Backup: restore files or folders by date, earlier versions, Cloud Backup upload limits (web) (#1314)
- FL-1685: iCloud sync: photos download while the library is still being listed (server) (#1317)
- FL-1686: Library care: file checks read each original once a pass, not every night (server) (#1318)
- FL-1688: fix: server build, lint and settings words after the 11-17 evening merges (#1320)
- FL-1687: Release Frameleaf 1.2.25 and Manager 1.2.25 (#1319)
- FL-1691: ci: Docker mirror setup works on self-hosted job slots (#1323)
- FL-1691: test(ci): cover mirror setup on self-hosted job slots (#1324)
- FL-1653: fix(server): regenerate search queries file (#1330)
- FL-1686: fix(server): Run now's damage check reads every original (#1331)
- FL-1685: fix(server): iCloud sync sends the bridge only protocol library fields (#1335)
- FL-1683: ci: integration push logs in to GHCR with the publish token (#1336)
- FL-1683: test(server): longer default test timeouts for the self-hosted CI slots (#1337)
- FL-1683: ci: medium tests write their temp files to RAM (#1338)
- FL-1683: ci: Deploy's reusable workflows run on Forgejo (#1340)
- FL-1141: Address TrueNAS catalogue configuration review (#815)
- FL-1689: Server Backup: recovery kit, disconnect from Frameleaf Cloud, and restore from a fresh server (#1321)
- FL-1690: Server Backup: delete this server's backups (30-day hold, cancellable) and open the Cloud account (#1322)
- FL-1692: Server Backup: keep a locked copy of the recovery key in Frameleaf Cloud (optional, off by default) (#1325)
- FL-1694: Server Backup always includes Manager's settings and the photo library's backup keys (#1341)
- FL-1695: Server Backup: a replacement server picks up the old server's backup settings (#1327)
- FL-1696: Server Backup's schedule follows the owner's time zone, not the NAS container's UTC (#1342)
- FL-1693: fix(server): one live job per edit; imported edited videos take their edited size (#1329)
- FL-1697: HexOS: Manager can reach the NAS's own folders, so Server Backup can protect them (#1332)
- FL-1681: fix(web): live updates no longer blank Boards and library grids (#1333)
- FL-1698: fix(analytics): years chart on phones; external libraries count as your photos (#1334)
- FL-1715: Desktop AI workers set themselves up from the ML settings; several desktops share a queue (#1339)
- FL-1687: docs: 1.2.25 release notes cover the PRs merged after the bump (#1343)
- FL-1683: ci: reusable workflows load on Forgejo (no secrets block under workflow_call) (#1344)
- FL-1683: fix(server): imported wall clocks survive a non-UTC server time zone (#1345)
- FL-1715: fix(sdk): regenerate fetch-client.ts (#1346)
- FL-1683: ci: keep job-to-job artifacts 2 days so a run crossing midnight keeps them (#1347)
- FL-1683: ci: Deploy and the release run on Forgejo (#1348)
- FL-997: fix(ml): arm64 CUDA image uses PyPI's CUDA 13 onnxruntime-gpu (#1349)
- FL-997: ci: Studio runtime check accepts the browserless Ubuntu arm64 CUDA image (#1350)
- FL-1683: test(nas): workflow contract accepts Forgejo's upload action and the read token (#1351)
- FL-1683: test(docker): Postgres workflow contract accepts Forgejo's upload action (#1352)
- FL-1683: ci: the release script recognises Forgejo runners on its LAN addresses (#1353)
- FL-1683: test: release tests ignore the CI runner's own server URL (#1354)
- FL-1683: ci: Deploy passes the registry tokens to its reusable image builds (#1356)
- FL-1683: ci: Deploy's build steps treat Forgejo's workflow_call as the dispatch (#1357)
- FL-1683: feat(docker): database image moves to PostgreSQL 19.0 (#1358)
- FL-1683: PostgreSQL 19.0 image pin and schema catalog (#1361)
- FL-1683: NAS packaging expects the PostgreSQL 19.0 image pin (#1362)
- FL-1683: fix(server): schema checks accept PostgreSQL 19.0 index parentheses (#1363)
- FL-1718: fix(web): browse the server for an Eagle library (#1364)
- FL-1720: fix(web): library reloads once after uploads go quiet, not per upload (#1366)
- FL-1719: fix(web): open a new album after creating it; even out the New button spacing (#1365)
- FL-1715: fix(server): desktop AI worker routing, capacity, several leases and named refusals (#1367)
- FL-1687: docs: 1.2.25 release notes cover the fixes merged after the PostgreSQL 19.0 move (#1368)
- FL-1715: fix(server): schema catalog matches the new desktop worker settings keys; album spec formatted (#1369)
- FL-1720: test(web): the upload-reload spec gives the dates-to-check reply its timeBuckets (#1371)
- FL-1720: test(e2e): the million-photo timeline test waits for the quiet-period reload (#1372)
- FL-1720: test(e2e): the cross-tab restore test waits for the quiet-period reload (#1373)
- FL-1687: fix(release): a single-job rerun on Forgejo keeps the Test run as release evidence (#1374)
- FL-1687: fix(release): Deploy production can leave dry run when started from Forgejo (#1375)
Source: 3ad12c0
Build evidence: https://code.heroapps.ca/Frameleaf/frameleaf-app/actions/runs/945
Use the attached version-matched installation files and release-manifest.json. Verify an image with: cosign verify --key cosign.pub @
Full Changelog: frameleaf-v1.2.24...frameleaf-v1.2.25