Installation

Where to download each Mauvely app, what the installer does, and how updates are delivered on Windows and Linux.

Downloads live on mauvely.com. What is available today differs by app, so this page is organised that way rather than by platform.

Mauvely Compose

Download MauvelyCompose-<version>-windows-x86_64.msi and run it.

The installer is per-user: Compose is installed into your own %LOCALAPPDATA% rather than Program Files. Two consequences worth knowing:

  • It never asks for administrator rights, and neither do updates.
  • Each Windows account on the machine installs its own copy.

First launch

Compose asks you to sign in before it opens. Sign-in happens in your browser, not in the app — see Accounts for why, and for what happens when you are offline.

After signing in you land on the welcome screen, not in a course: recent courses and the news feed on one side, New course, From a template and Open on the other.

Updates

Compose checks for updates a few seconds after launch and every six hours after that.

Platform Behaviour
Windows Downloads in the background, verifies it, then offers Update ready — restart.
Linux, AppImage Same: downloads, verifies, replaces the image in place on restart.
Linux, installed by a package manager Notifies you and links to the download page. Your package manager owns the update.

Every download is checked against a SHA-256 published alongside it, and a file that does not match is discarded rather than offered. A failed check — no network, service down — is silent by design; it never interrupts you with a dialog.

You can turn the startup check off in Settings ▸ Advanced ▸ Updates.

Mauvely Cloud

Nothing to install. Open cloud.mauvely.com in any modern browser and sign in with your Mauvely account.

The first time you open it you are asked to set up a vault — this creates your encryption keys and gives you a 24-word recovery phrase. Do not skip it, and do not skip writing the phrase down; it is one of only two things that can ever open your files.

See Setting up your vault.

Sotto

Sotto is Linux only and ships as a single AppImage:

chmod +x Sotto-x86_64.AppImage
./Sotto-x86_64.AppImage

There is no Flathub package and no .deb, .rpm or AUR package. Building from source lets you choose a GPU backend, which materially affects transcription speed — see Installing Sotto for both routes and the desktop requirements.

On first launch Sotto opens its Settings window so you can download a speech model. Nothing works until one is installed.

Mauvely Snap

Not yet available. Snap is an early build with no packaging or release pipeline, so there is no installer to download on any platform. When it ships it will be Windows first; the Linux build exists but is deliberately not distributed, because a Wayland client is not allowed to read the screen and the resulting product would be materially different.

What is built, and what is not →

Ask AI

Ask anything about Mauvely

Answers come from this documentation.