Desktop updates
Recover from a stuck download or restart and understand supported update paths.
Brainwrite checks for updates in the background and offers the download in a card at the bottom of the window. How the download is applied depends on what you installed.
| Build | What the button does |
|---|---|
| macOS, Windows, Linux AppImage | Restart to update — the app replaces itself and reopens. An AppImage is always rewritten at the path you launch, so your launcher, symlink or dock pin keeps working. |
Ubuntu .deb (and rpm/pacman) | Install — Brainwrite downloads and verifies the package, copies the install command, and opens a terminal for you to paste it into. The app never installs a system package itself, so it never asks for your administrator password. |
Ubuntu packages are installed from the releases repository by hand, so the app hands you the exact line rather than guessing at a package handler:
sudo apt-get install -y '/home/you/.cache/brainwrite-updater/pending/Brainwrite-<version>-amd64.deb'Reopen Brainwrite once it finishes to be running the new version.
The download keeps spinning
Leave the app open long enough for one complete attempt, then quit and reopen it. A failed differential update should fall back to the full package. If the same release remains stuck, download the current installer from the official releases page and install it over the existing copy.
Restart to update does nothing
Quit Brainwrite completely and launch it again. If the version did not change, install the latest release manually. Your conversations and settings live outside the application bundle and are not removed by replacing the app.
No terminal opened
The install command is on your clipboard either way. Open a terminal yourself and paste it. If the clipboard was overwritten, the package is already downloaded and you can run:
sudo apt-get install -y ~/.cache/brainwrite-updater/pending/Brainwrite-*-amd64.debUse apt-get, not dpkg -i — only apt-get resolves dependencies, and on Ubuntu 24.04 ours are satisfied through virtual packages that dpkg alone will not follow.
Verify the installed version
Open App settings and check the displayed version. A commit merged to main is not in the desktop app until a release workflow publishes a new version.
Use official artifacts
Do not install update files forwarded through chat or uploaded to an unrelated repository. Use the Brainwrite releases repository and its checksums.