Running it
Flatty is at flatty.higreg.pl, and that is always where the newest version is. It is free — no key, no account, nothing to sign up for.
There is no installer, nothing to register, and no runtime to fetch alongside it. The whole program is one executable, and even the font it draws with is baked inside. Unpack it wherever you keep your tools and run it.
flatty_1.0.0_linux_amd64.tar.gz
├── flatty the program
├── LICENSE what you may do with it
└── THIRD-PARTY-NOTICES.md the open-source components it is built on
Take the build that matches your machine. On the download page they are named
flatty_<version>_<system>_<chip> — windows_amd64, linux_amd64,
darwin_arm64 for an Apple Silicon Mac, darwin_amd64 for an Intel one.
Windows
Right-click the .zip and choose Extract All. Run flatty.exe from the
folder it produces.
Windows may show a blue “Windows protected your PC” box the first time. That is SmartScreen reacting to a program it has not seen many people run yet, not to anything it found in the file. Click More info, then Run anyway.
Do not run Flatty from inside the .zip — Windows opens it in a temporary
folder, and anything you save from there disappears.
macOS
Take the arm64 archive for an Apple Silicon Mac (M1 and later) and the amd64 one for an Intel Mac. The Apple menu → About This Mac tells you which chip you have — and, on the same panel, which version of macOS you are running. You will need that second number in a moment.
There is no disk image and no Flatty icon to drag into Applications, and that is deliberate rather than unfinished. Apple only lets an application open without a warning if its author pays for a developer account and submits each build for scanning. Flatty is free and does not, so a bundle would have been refused by your Mac just as firmly as the bare program is — while looking as though it should work. You are given the program itself instead, and told honestly how to let it run.
It takes about a minute, once.
The short way, on any version of macOS
Open Terminal and run these, one line at a time:
cd ~/Downloads
tar xzf flatty_*_darwin_arm64.tar.gz
xattr -d com.apple.quarantine flatty
./flatty
The xattr line removes the flag macOS puts on anything a browser downloaded. It
may answer No such xattr — that only means the flag was not there, and you can
carry on to the next line.
Flatty is now unlocked for good. Later on you can run it by double-clicking it in Finder like anything else.
The Finder way, if you would rather not use Terminal
Double-click the .tar.gz to unpack it, then double-click flatty. It will be
refused the first time. What you do next depends on your version of macOS, and
this is where most people get stuck.
On macOS 14 and earlier — Monterey, Ventura, Sonoma:
Control-click (or right-click) flatty, choose Open, and confirm with Open again in the box that follows. That is all, permanently.
On macOS 15 and later — Sequoia, Tahoe:
Apple removed that shortcut, so Control-click no longer offers Open at all. Instead:
- Double-click flatty and let it be refused. Close the message.
- Open System Settings → Privacy & Security and scroll down to Security.
- Next to the line mentioning flatty, click Open Anyway and confirm.
Do that part promptly. The Open Anyway button only appears for about an hour after a refused launch, and if you come back later it simply will not be there. Double-click flatty again to bring it back, then go straight to Settings.
A Terminal window opens next to Flatty
That is expected and it is not an error. Flatty is a plain program rather than a Mac application bundle, so Finder runs it through Terminal and that window stays open for as long as Flatty does. Closing it quits Flatty, so leave it be and put it behind the main window.
Linux
tar xzf flatty_*_linux_amd64.tar.gz
chmod +x flatty
./flatty
The chmod is usually unnecessary — the archive carries the executable bit — but
it costs nothing and it is the fix if you get Permission denied.
Or take the AppImage
There is a second Linux download, ending in .AppImage. It is the same program in
the format Linux uses for “one file you can just run”: no archive to unpack, and
your desktop picks up its name and icon.
chmod +x flatty_*_linux_amd64.AppImage
./flatty_*_linux_amd64.AppImage
Here the chmod is not optional — a download arrives without the executable bit,
and without it nothing happens when you click.
It needs a reasonably current system: Ubuntu 22.04, Debian 12, Fedora 36 or
newer, or anything of about that vintage. On something older, take the
.tar.gz instead. Neither version can do anything the other cannot; pick whichever
suits how you like to keep programs.
If you want it in your applications menu rather than in a folder, a tool like Gear Lever or AppImageLauncher will file it away for you. Nothing obliges you to — it runs perfectly well from wherever it sits.
Either way
You need a graphics driver and a desktop session, which any normal Linux install has. On a bare server there is nothing to draw into and the program will not start.
Check it works
flatty -demo cloud
That opens the editor with a small piece of artwork already loaded, so you can see a model before you have drawn anything.
Press Ctrl+Q to leave — Esc deliberately does not quit.
Where Flatty keeps things
Two places, and nothing else:
| What | Where |
|---|---|
| your work | folders you choose — see Projects |
| your settings and recent-project list | one config file |
Your palettes, brush textures, themes and saved layouts live beside that file, a folder apiece — see Your libraries.
| Platform | Config file |
|---|---|
| Linux | ~/.config/flatty/config.json |
| macOS | ~/Library/Application Support/flatty/config.json |
| Windows | %AppData%\flatty\config.json |
There is a second folder for things Flatty can rebuild by itself — the list of fonts on your machine, and the thumbnails in the media gallery. It lives in your system’s cache directory, and deleting it costs you nothing but the few seconds it takes to fill in again.
Nothing is written anywhere else, nothing is installed system-wide, and removing Flatty is a matter of deleting the executable. Your projects are ordinary folders and are not touched by that.
What you may do with it
The full terms are in the LICENSE file beside the program. The short version:
Everything you make with Flatty is entirely yours. Your drawings, your exported models, and anything you build from them. No royalty, no revenue share, no attribution and no permission needed — however successful the work becomes. Sell it, licence it, open-source it, put it in a game with a million players. That clause outlives the rest of the agreement: even if your licence ended tomorrow, what you already made stays yours.
You may use Flatty for any purpose, personal or commercial, including paid client work, and install it on as many machines as you like. There is no limit on how many people at an organisation may use it.
Please do not redistribute the program itself — do not resell it, bundle it into another product, or publish copies of it. It is free, but it is not open source, and the download page is where it should come from.
It comes with no warranty — so keep backups of your work, as you would with any tool that writes files.
THIRD-PARTY-NOTICES.md, also in the archive, lists the open-source components
inside Flatty and their licences.
Next: Your first model.