floe CLI, so it sends to and
receives from browser peers and CLI peers without any extra setup.
It is in beta and Windows only. macOS and Linux are planned. On anything else, use the
web app or the CLI.
Requirements
- From the Microsoft Store: Windows 10 version 2004 (build 19041) or later. The package itself declares that minimum version.
- From GitHub: any Windows 10 or later. The installer stops on anything older.
- x64. Both channels ship an x64 build only. On a native ARM64 machine the GitHub installer refuses to run and says so; the portable zip has no such check and starts under Windows’ emulation instead, which works but is slower.
- The Microsoft Edge WebView2 Runtime, which draws the interface. Windows 11 includes it, and the vast majority of Windows 10 machines already have it. You do not normally need to do anything about it.
Choose a channel
- Microsoft Store
- GitHub release
The recommended way to install.Get Floe Desktop from the Microsoft StoreOr from a terminal:Microsoft re-signs the package with its own certificate, so it installs with no warning,
and updates arrive automatically through the Store.Three things about the app itself differ from the GitHub build:
Terminal
- The Show in right-click menu setting is not available, and the Windows section of Settings that contains it is hidden entirely. A packaged app’s registry writes go to a private view that File Explorer never reads, so the entry could be written but would never appear. Hidden beats shown and broken.
- Updates are handled by the Store, so there is nothing to download by hand. The Store build also never runs the GitHub build’s daily update check and does not show its Check for updates switch.
- No SmartScreen warning, because Microsoft signs the package.
Verify a download
Every GitHub release shipsSHA256SUMS.txt. To check a file you downloaded:
PowerShell
SHA256SUMS.txt. Store installs need no check:
the Store verifies the package signature itself.
Check the version
Open Settings (the gear in the title bar, orCtrl ,) and look at the About section.
App version reads the release tag, for example desktop-v0.2.11. A build you compiled
yourself reads dev.
That section also shows the transfer protocol version and which signaling server the app is
using, and a Copy button that puts all of it on the clipboard. Those are the details worth
including in a bug report.
Update
Desktop builds are published as GitHub pre-releases, so they never appear under Latest
release on the releases page. Watch floe.one/download or the
full release list instead.
Desktop releases carry their own
desktop-vX.Y.Z version numbers, separate from the vX.Y.Z
tags that release the CLI and the server. The two lines never need to match, and you never need
to match versions with the person on the other end of a transfer. See
version compatibility.
Uninstall
Open Settings in Windows, go to Apps, and uninstall it. The GitHub install is listed as Floe; the Store install is listed under its Store name, Floe Desktop, and can also be uninstalled by right-clicking it in the Start menu. Uninstalling removes the app, its shortcuts, and, on the GitHub build, the File Explorer right-click entry if you turned it on. It deliberately leaves a few things behind, so a reinstall picks up where you left off:- Your settings, in
%APPDATA%\floe\desktop.json. - Your transfer history and save folder, stored in the app’s local data.
- The update check’s once-a-day cache, in
%APPDATA%\floe\desktop-update-check.json.
%APPDATA%\floe folder to remove those as well. Note that the floe CLI keeps its
own files in that same folder, so only delete it if you are removing both.
Run alongside the CLI
The desktop app and thefloe CLI share the %APPDATA%\floe folder, and both talk to the same
signaling server by default, so a transfer started in one can be received by the other. Point
either at a different server and they still interoperate as long as both use the same one. See
Settings.