Installation
This page covers the available ways to install Beutl.
In the instructions below, {version} represents the version of Beutl you are installing.
System requirements
Beutl runs on x64 and ARM64 computers. On x64, the processor must support x86-64-v2: the CX16, POPCNT, SSE3, SSSE3, SSE4.1, and SSE4.2 instructions. Every Intel and AMD processor that its maker still supports has them; the last processors without them went out of support around 2013. The .NET 11 runtime that Beutl includes requires them, so from 2.0.0-preview.12 on, Beutl does not start on an x64 processor without them. The requirement for ARM64 has not changed.
For Windows
Windows supports both x64 and ARM64. For an ARM64 device, use an installer with arm64 in its file name.
Using the standalone installer (recommended)
- Download and run
beutl-standalone-setup.exe(ARM64:beutl-standalone-arm64-setup.exe). - Follow the on-screen instructions to install.
- Launch
Beutl.exe.
The release packages include the .NET runtime. Lightweight installers and framework-dependent archives are no longer published. When updating from an older lightweight or portable Windows installation, download the standalone installer.
For Debian and Ubuntu
The Debian package installs on Ubuntu 22.04, 24.04, and 26.04, and on Debian 12 and 13.
Installing from Debian package
- Download
beutl_{version}_amd64.debfor x64, orbeutl_{version}_arm64.debfor ARM64. Use the matching downloaded filename in the command below. - Run the following commands:
sudo apt update
sudo apt install ./beutl_{version}_amd64.deb
- Installation is complete.
Manual installation
- Download and extract
Beutl-linux-x64-standalone-{version}.ziporBeutl-linux-arm64-standalone-{version}.zipfor your architecture. - Use
chmodto makeBeutl,Beutl.ExceptionHandler,Beutl.PackageTools.UI,Beutl.FFmpegWorker, andBeutl.AgentToolkit.Mcpexecutable. - Launch
Beutl.
For Linux (Flatpak)
Flatpak lets you install Beutl on any Linux distribution without a distribution-specific package.
Requires flatpak with the Flathub remote configured. The bundle pulls the org.freedesktop.Platform runtime from Flathub on first install.
- Download
Beutl-{version}.flatpakfor x64, orBeutl-arm64-{version}.flatpakfor ARM64, from the release page. Use the matching filename below. - Install the bundle for the current user:
flatpak install --user Beutl-{version}.flatpak
- Launch Beutl:
flatpak run net.beditor.Beutl
After installation, Beutl also appears in your desktop environment's application menu.
Updating a Flatpak installation
Beutl's built-in updater can download and install the new Flatpak bundle into the same user or system installation for the running architecture. When the update finishes, close and reopen Beutl to use the new version.
An installation for all users, which flatpak install and GNOME Software make by default, needs an administrator: your desktop asks for the password once. If you cancel the prompt or authentication fails, choose Retry to try again, or download the update from Release notes and install it yourself.
For macOS
- Download and extract
Beutl.osx_arm64.app.ziporBeutl.osx_x64.app.zip. - Double-click the downloaded file to extract it.
- Double-click
Beutl.appto launch the application.
Updating Beutl
When Beutl finds a new version at startup, it downloads the update in the background while you keep editing. A short Downloading the update notification with Release notes says so, and the Status button in the title bar shows the progress. To be asked first, turn off Download updates automatically on the Info page of the settings. Beutl then shows a notification with Install and Release notes, and Install starts the download. If more than one Beutl is running, only one of them downloads without asking, and the others offer Install. Open the status popup to see the update dialog; Run in background hides it again, and Esc cancels the update.
When the update is ready, a notification shows the version and offers:
- Start installer on Windows, or Restart and update on macOS and Linux: Beutl closes and the update starts. On macOS and Linux, Beutl starts again afterward.
- Update on quit: The update installs when you quit Beutl, after your work is saved, and Beutl stays closed.
- Release notes: Opens the release page and keeps the notification on screen.
A Flatpak installation installs the new bundle as soon as it is downloaded, so it never downloads without asking, and the settings do not show Download updates automatically; see Updating a Flatpak installation.
If the download or the preparation fails, the notification and the dialog offer Retry, and the message names the step that failed.
The first time a newly published version starts, a notification offers Release notes, which open that version's release page.
Before updating
2.0.0-preview.13 keeps the project file format floor of preview.11. Projects saved by preview.13 still open in preview.11 and preview.12, but not in preview.10 or earlier. Keep a copy of the whole project folder before saving it in the new version if you need to return to preview.10 or earlier. See Project Structure.
On x64, Beutl needs a processor with x86-64-v2 since preview.12. See System requirements.
Existing projects can look different after updating to preview.13:
- SDR video tagged BT.709, BT.601, or BT.2020 shows darker shadows. Beutl now reads these tags with the curve QuickTime uses, so a macOS screen recording looks as the screen did. The difference is largest near black, where video code 13 (of 255) now shows as about sRGB 10 instead of 28, and is less than 1 level above code 128. Existing proxies are discarded and made again once. See Color tags.
- BT.709 exports have brighter shadows than before, and play back in QuickTime as they look in Beutl.
Updates found at startup now download without asking. See Updating Beutl.
If you use an AI coding agent, reinstall its Beutl integration after updating.