Flat
Join

Code

GPL v3 or later · 54 files · 1.2 MB

Read me What changed Versions and downloads

top / docs

docs/index.html · 22.1 KB · raw

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Lightmorphic Flat: your Flatpak apps and their settings, onto any Linux machine</title> <meta name="description" content="Keep a list of the Flatpak apps you always want. On a fresh install, press one button: every app goes on, and the ones you chose come back with their settings."> <link rel="canonical" href="https://flat.lightmorphic.com/"> <link rel="icon" href="images/flat.svg" type="image/svg+xml"> <link rel="apple-touch-icon" href="images/flat-512.png"> <link rel="preload" href="fonts/Manrope-VariableFont_wght.ttf" as="font" type="font/ttf" crossorigin> <link rel="stylesheet" href="style.css"> <meta name="theme-color" content="#111827"> <meta property="og:title" content="Lightmorphic Flat: your Flatpak apps and their settings, onto any Linux machine"> <meta property="og:description" content="Keep a list of the Flatpak apps you always want. On a fresh install, press one button: every app goes on, and the ones you chose come back with their settings."> <meta property="og:url" content="https://flat.lightmorphic.com/"> <meta property="og:image" content="https://flat.lightmorphic.com/images/flat-512.png"> <meta property="og:image:width" content="512"> <meta property="og:image:height" content="512"> <meta property="og:type" content="website"> <meta name="twitter:card" content="summary"> <meta name="twitter:title" content="Lightmorphic Flat: your Flatpak apps and their settings, onto any Linux machine"> <meta name="twitter:description" content="Keep a list of the Flatpak apps you always want. On a fresh install, press one button: every app goes on, and the ones you chose come back with their settings."> <meta name="twitter:image" content="https://flat.lightmorphic.com/images/flat-512.png"> <script type="application/ld+json"> { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://lightmorphic.com/#organization", "name": "Lightmorphic", "url": "https://lightmorphic.com", "description": "A UK studio building fast, privacy-first websites and free open-source tools.", "sameAs": [ "https://find-and-update.company-information.service.gov.uk/company/17423646" ], "legalName": "Lightmorphic Ltd", "address": { "@type": "PostalAddress", "addressCountry": "GB" } }, { "@type": "WebSite", "@id": "https://flat.lightmorphic.com/#website", "url": "https://flat.lightmorphic.com/", "name": "Lightmorphic Flat", "inLanguage": "en-GB", "publisher": { "@id": "https://lightmorphic.com/#organization" } }, { "@type": "SoftwareApplication", "@id": "https://flat.lightmorphic.com/#app", "name": "Lightmorphic Flat", "operatingSystem": "Linux (x86_64) with Flatpak", "applicationCategory": "UtilitiesApplication", "description": "Keeps a list of the Flatpak apps you always want and installs them all on a fresh Linux machine with one button, bringing back the settings of the ones you mark Keep settings from a backup. Backs up selected apps' data and permissions into one portable file.", "url": "https://flat.lightmorphic.com/", "downloadUrl": "https://flat.lightmorphic.com/downloads", "softwareVersion": "1.8.0", "dateModified": "2026-09-19", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "GBP" }, "license": "https://www.gnu.org/licenses/gpl-3.0.html", "author": { "@id": "https://lightmorphic.com/#organization" }, "publisher": { "@id": "https://lightmorphic.com/#organization" } }, { "@type": "FAQPage", "@id": "https://flat.lightmorphic.com/#faq", "mainEntity": [ { "@type": "Question", "name": "Do I have to know where an app lives on Flathub?", "acceptedAnswer": { "@type": "Answer", "text": "No. You only need its name. The search box on the My apps tab turns a name into the app's ID, the reverse-web-address name such as org.mozilla.firefox, and that is all Flat needs. The remote is Flathub unless you say otherwise." } }, { "@type": "Question", "name": "Will my browser logins come back?", "acceptedAnswer": { "@type": "Answer", "text": "Often, not always. Firefox and Thunderbird keep their logins inside their own profile folder, so those generally come back with everything else. Apps that keep their login in the system keyring, GNOME Keyring or KWallet, keep it outside Flatpak altogether, and those need signing in again on the new machine." } }, { "@type": "Question", "name": "What is in a backup file?", "acceptedAnswer": { "@type": "Answer", "text": "Your list of apps, and the settings of the ones you chose to keep: each app's own folder under ~/.var/app and its permission settings. For a browser that means bookmarks, history, saved passwords, cookies and extensions. What the app rebuilds by itself — its cache, and in browsers the websites' offline copies and downloaded parts — is left out unless you tick Full for that app. The file is not encrypted, so keep it somewhere as safe as the machine it came from." } }, { "@type": "Question", "name": "What happens to an app that is already on the new machine?", "acceptedAnswer": { "@type": "Answer", "text": "Restore leaves it alone, settings and all: it names it as already there and moves on to the next. Settings are only ever brought back for apps that Restore has just put on, so nothing already set up on a machine is overwritten." } }, { "@type": "Question", "name": "Does it need a password?", "acceptedAnswer": { "@type": "Answer", "text": "No. Everything Flat installs goes in for your own user, not system-wide, which needs no administrator password and works the same way on every distribution." } }, { "@type": "Question", "name": "What about apps that are not Flatpaks?", "acceptedAnswer": { "@type": "Answer", "text": "They are outside what Flat does. Native .deb and .rpm packages, Snaps and AppImages are not moved or installed." } }, { "@type": "Question", "name": "How do I update Flat?", "acceptedAnswer": { "@type": "Answer", "text": "The small dot beside the version number, top right. Green means up to date and a click checks again. Amber means a newer version is ready: click to download it, watch the white ring fill, and click the blue dot to restart into it. Red means the update server could not be reached. Flat looks when it starts and every half hour after, but nothing is downloaded until you click." } } ] } ] } </script> </head> <body> <a class="skip" href="#main">Skip to content</a> <nav class="topnav"> <div class="wrap topnav-inner"> <a class="brand" href="#top"> <svg viewBox="0 0 512 512" width="22" height="22" aria-hidden="true"><rect x="10" y="10" width="492" height="492" rx="120" fill="#fbc711"/><rect x="130" y="279" width="251" height="125" rx="28" fill="none" stroke="#111827" stroke-width="30"/><path d="M256 105V264m0 0-55-55M256 264l55-55" fill="none" stroke="#111827" stroke-width="30" stroke-linecap="round" stroke-linejoin="round"/></svg> Lightmorphic Flat </a> <div class="nav-links"> <a class="hide-sm" href="#how">How it works</a> <a class="hide-sm" href="#keep">Fresh or keep</a> <a class="hide-sm" href="#limits">Limits</a> <a class="hide-sm" href="#faq">Questions</a> <a href="#download">Download</a> <div id="all-apps"></div> </div> </div> </nav> <header class="hero" id="top"> <div class="wrap hero-grid"> <div> <h1>A fresh install,<br>and everything back on&nbsp;it.</h1> <p class="lede">Flat keeps a list of the Flatpak apps you always want. On a new machine, open your backup and press Restore: every app goes on, and the ones you have marked <strong>Keep settings</strong> come back with their profiles, bookmarks and preferences. Changing distribution stops meaning an afternoon of setting things up again.</p> <div class="hero-cta"> <a class="btn primary" href="#download">Download</a> <a class="btn ghost" href="#how">How it works</a> </div> <p class="hero-note">Free &amp; open source · GPL-3.0 · No account, no telemetry</p> </div> <aside class="routine" aria-label="A fresh install with Flat"> <p class="routine-title">On the new machine</p> <ol> <li><span><b>Download two files into one folder</b>Flat, and the backup you made on the old machine.</span></li> <li><span><b>Open Flat</b>The Restore tab finds the backup on its own.</span></li> <li><span><b>Press Restore</b>Every app goes on, and the Keep settings ones get their settings back.</span></li> </ol> <p class="routine-note">No terminal, and no password: everything goes in for your own user.</p> </aside> </div> </header> <main id="main"> <section id="how" aria-labelledby="how-title"> <div class="wrap"> <h2 id="how-title">Pick your apps. Back up. Restore.</h2> <p class="section-intro">Flat has three tabs: All apps, which is everything on this machine; My apps, the list you carry to the next one; and Restore, where it arrives.</p> <div class="steps"> <article class="panel"> <span class="step-num" aria-hidden="true">1</span> <h3>Pick your apps</h3> <p>All apps lists every Flatpak app on the machine you are leaving, with how much each one keeps. Tick them, or press All, and send them to My apps. There you switch on Keep settings for the ones whose settings matter; the rest install fresh.</p> </article> <article class="panel"> <span class="step-num" aria-hidden="true">2</span> <h3>Back up</h3> <p>Back up saves your list, and the settings of every Keep settings app, into one <code>.fmpack</code> file wherever you choose. It will not start while any of those is open, and it says which. Each app inside is checksummed, so a damaged copy is caught instead of restored.</p> </article> <article class="panel"> <span class="step-num" aria-hidden="true">3</span> <h3>Restore</h3> <p>On the new machine, the Restore tab shows the same list from the backup, with the switch already on for every app whose settings came along. Press Restore and it installs them in one go, then brings those settings back. Anything that goes wrong is named on its own row, and the run carries on to the next app.</p> </article> </div> <div class="shots"> <figure class="shot"> <img src="images/screenshot-all-apps.jpg" width="1600" height="971" loading="lazy" alt="The All apps tab: every Flatpak app on the machine with a tick box and the size of the data it keeps, all of them ticked, ready to add to My apps."> <figcaption>All apps: everything on this machine. Tick it and send it to My apps.</figcaption> </figure> <figure class="shot"> <img src="images/screenshot-install-run.jpg" width="1600" height="971" loading="lazy" alt="A restore run: seven apps each with a green tick, three noting their settings were brought back from the backup, one noting it was already on the machine."> <figcaption>Restore: every app accounted for, including the ones already there.</figcaption> </figure> </div> </div> </section> <section id="keep" aria-labelledby="keep-title"> <div class="wrap"> <h2 id="keep-title">Fresh, or keep the settings</h2> <p class="section-intro">Some apps you want as new. Others you want exactly as you left them. Each app on your list gets a switch. An app that has saved nothing says so, so there is nothing to switch on by mistake.</p> <figure class="shot"> <img src="images/screenshot-my-apps.jpg" width="1600" height="971" loading="lazy" alt="The My apps tab: a list of 67 Flatpak apps, all ticked, each with its name, app ID, remote and a Keep settings switch, and a Back up button."> <figcaption>My apps: the list you carry from machine to machine. Switch on the ones whose settings matter and press Back up.</figcaption> </figure> <div class="bento" style="margin-top:1.5rem"> <article class="panel"> <h3> <svg class="icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M4 7h16M4 12h16M4 17h10"/></svg> Build the list without typing it </h3> <p>Tick everything on All apps and send it across in one go, or press Add everything here. Or search by name and add apps you do not have yet. Delete one you never want again, and a later "add everything" leaves it out.</p> </article> <article class="panel"> <h3> <svg class="icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M12 2 4 6v6c0 5 3.4 8.7 8 10 4.6-1.3 8-5 8-10V6l-8-4Z"/><path d="m9 12 2 2 4-4"/></svg> Never overwrites what is there </h3> <p>Settings are brought back only for apps Restore has just put on. An app already on the machine is left exactly as it is, however the switch is set.</p> </article> <article class="panel"> <h3> <svg class="icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M3 12h4l3-8 4 16 3-8h4"/></svg> Gets the order right </h3> <p>An app restored by hand often opens as if brand new: its folder was copied before it was installed, or while it was running, or with the wrong owner. Flat installs first, closes the app, clears the empty folder the install made, unpacks your data, sets the owner to you, and restores its permissions, in that order.</p> </article> <article class="panel"> <h3> <svg class="icon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><rect x="3" y="4" width="18" height="14" rx="2"/><path d="M8 21h8M12 18v3"/></svg> One file, no installer </h3> <p>A single AppImage that runs before anything else is set up on a new machine. It sits in the tray while it works, so a long install can carry on with the window closed, and it keeps itself up to date through one small dot.</p> </article> </div> </div> </section> <section id="limits" class="limits" aria-labelledby="limits-title"> <div class="wrap"> <h2 id="limits-title">What it cannot do</h2> <div class="panel"> <ul> <li><strong>Logins kept in the system keyring do not travel.</strong> GNOME Keyring and KWallet sit outside Flatpak, so those apps need signing in again. Firefox and Thunderbird keep theirs in their own profile and generally come back signed in.</li> <li><strong>Apps come back at their newest version.</strong> Each one is installed fresh from Flathub, not copied across. Settings almost always carry over, but now and then a newer version asks you to set something up again.</li> <li><strong>It is for Flatpak apps only.</strong> Native packages, Snaps and AppImages are not moved.</li> <li><strong>A much older distribution may not carry the same version.</strong> Flat then installs the current one and says so on that app's row.</li> <li><strong>Everything installs for your own user.</strong> Apps that were system-wide on the old machine come back per-user on the new one, which needs no password and behaves the same everywhere.</li> </ul> </div> </div> </section> <section id="requirements" class="req" aria-labelledby="requirements-title"> <div class="wrap"> <h2 id="requirements-title">Requirements</h2> <div class="panel"> <p><strong>A 64-bit (x86_64) Linux desktop with Flatpak installed.</strong> Any distribution will do: Flat drives the <code>flatpak</code> command rather than linking against it, and says so plainly if it is missing. If Flathub is not set up yet, Flat offers to add it.</p> <p>To check Flatpak is there:</p> <pre><code>flatpak --version</code></pre> </div> </div> </section> <section id="faq" aria-labelledby="faq-title"> <div class="wrap"> <h2 id="faq-title">Questions</h2> <div class="panel faq"> <details class="faq-item"> <summary><h3>Do I have to know where an app lives on Flathub?</h3></summary> <p>No. You only need its name. The search box on the My apps tab turns a name into the app's ID, the reverse-web-address name such as <code>org.mozilla.firefox</code>, and that is all Flat needs. The remote is Flathub unless you say otherwise.</p> </details> <details class="faq-item"> <summary><h3>Will my browser logins come back?</h3></summary> <p>Often, not always. Firefox and Thunderbird keep their logins inside their own profile folder, so those generally come back with everything else. Apps that keep their login in the system keyring, GNOME Keyring or KWallet, keep it outside Flatpak altogether, and those need signing in again on the new machine.</p> </details> <details class="faq-item"> <summary><h3>What is in a backup file?</h3></summary> <p>Your list of apps, and the settings of the ones you chose to keep: each app's own folder under <code>~/.var/app</code> and its permission settings. For a browser that means bookmarks, history, saved passwords, cookies and extensions. What the app rebuilds by itself — its cache, and in browsers the websites' offline copies and downloaded parts — is left out unless you tick Full for that app. The file is not encrypted, so keep it somewhere as safe as the machine it came from.</p> </details> <details class="faq-item"> <summary><h3>What happens to an app that is already on the new machine?</h3></summary> <p>Restore leaves it alone, settings and all: it names it as already there and moves on to the next. Settings are only ever brought back for apps that Restore has just put on, so nothing already set up on a machine is overwritten.</p> </details> <details class="faq-item"> <summary><h3>Does it need a password?</h3></summary> <p>No. Everything Flat installs goes in for your own user, not system-wide, which needs no administrator password and works the same way on every distribution.</p> </details> <details class="faq-item"> <summary><h3>What about apps that are not Flatpaks?</h3></summary> <p>They are outside what Flat does. Native <code>.deb</code> and <code>.rpm</code> packages, Snaps and AppImages are not moved or installed.</p> </details> <details class="faq-item"> <summary><h3>How do I update Flat?</h3></summary> <p>The small dot beside the version number, top right. Green means up to date and a click checks again. Amber means a newer version is ready: click to download it, watch the white ring fill, and click the blue dot to restart into it. Red means the update server could not be reached. Flat looks when it starts and every half hour after, but nothing is downloaded until you click.</p> </details> </div> </div> </section> <section id="download" class="download" aria-labelledby="download-title"> <div class="wrap"> <h2 id="download-title">Download</h2> <div class="panel"> <div class="dl-row"> <a class="btn primary" href="/downloads">Download the AppImage</a> <span class="dl-meta">x86_64 · about 121&nbsp;MB · GPL-3.0-or-later</span> </div> <p class="dl-help">Mark the file executable (right-click → Properties → “Allow executing” on most desktops), then open it. On a new machine, put your backup file and your saved app list in the same folder as Flat and it finds them both on its own.</p> </div> </div> </section> </main> <footer class="foot"> <div class="wrap foot-inner"> <div class="foot-brand"> <a class="foot-lockup" href="#top"> <svg viewBox="0 0 512 512" width="26" height="26" aria-hidden="true"><rect x="10" y="10" width="492" height="492" rx="120" fill="#fbc711"/><rect x="130" y="279" width="251" height="125" rx="28" fill="none" stroke="#111827" stroke-width="30"/><path d="M256 105V264m0 0-55-55M256 264l55-55" fill="none" stroke="#111827" stroke-width="30" stroke-linecap="round" stroke-linejoin="round"/></svg> Lightmorphic Flat </a> <p class="foot-tagline">Your Flatpak apps and their settings, onto any Linux machine. Keep a list of the apps you always want, back up the ones whose settings matter, and put the lot on a fresh install with one button.</p> </div> <nav class="foot-nav" aria-label="Footer"> <p class="foot-nav-title">Pages</p> <div class="foot-nav-links"> <a href="#how">How it works</a> <a href="#keep">Fresh or keep</a> <a href="#limits">Limits</a> <a href="#faq">Questions</a> <a href="#download">Download</a> <a href="https://lightmorphic.com">Lightmorphic</a> </div> </nav> </div> </footer> <div class="legal"> <div class="wrap legal-inner"> <p class="legal-text"> &copy; Lightmorphic Ltd. Registered in England and Wales, company number 17423646.<br> Registered office: 82A James Carter Road, Mildenhall, IP28 7DE.<br> Page last updated: 19 September 2026. </p> <nav class="legal-links" aria-label="Legal"> <a href="privacy.html">Privacy</a> <a href="cookies.html">Cookies</a> <a href="terms.html">Terms</a> <a href="accessibility.html">Accessibility</a> <a href="complaints.html">Complaints</a> </nav> </div> </div> <script src="https://apps.lightmorphic.com/launcher.js" defer></script> </body> </html>