Install Beermat

Beermat is free. Download it from the releases page, or try it in your browser first.

Windows

• Microsoft Store (in the browser): the Store installs Beermat and keeps it up to date, with no warning to get past.
• Installer (Beermat-windows-setup.exe): run it and follow the steps. It can install for you alone (no administrator needed) or for everyone on the computer, open .bbm files with Beermat, and put the beermat command on the PATH.
• Portable (Beermat-windows-portable.zip): unzip it anywhere and run Beermat.exe. Nothing is installed.

The installer isn’t signed yet, so Windows may say it protected your PC: choose More info, then Run anyway.

macOS

Open Beermat-macos.dmg and drag Beermat to Applications. The app isn’t signed yet, so macOS stops it the first time:

1. Open Beermat from Applications. macOS says it can’t check it for malicious software; choose Done (or OK).
2. Open System Settings → Privacy & Security. Under Security, next to the message about Beermat, choose Open Anyway, and enter your password if asked.
3. Open Beermat again and choose Open.

You do this only once; after that it opens as any app does.

Linux

Install beermat-linux.deb (Debian, Ubuntu) or beermat-linux.rpm (Fedora, openSUSE) with your package manager. Beermat goes in /opt/beermat and in the applications menu.

In the browser

beermat.pub/try runs Beermat in the browser: the same page, toolbar and keys. Your sheet stays in the browser until you save it to your computer. Printing, PDF, .xmcd import, symbolic algebra beyond the basics, Python functions and AI assistants need the desktop app; the browser shows them greyed out.

In VS Code

The Beermat extension opens .bbm files on their page inside VS Code, with the toolbar and the same keys. In VS Code, open Extensions, search for Beermat and choose Install (it’s on the Visual Studio Marketplace and on Open VSX, for VSCodium and others). Or download beermat-….vsix from the latest release and use Extensions → ⋯ → Install from VSIX…. The page edits the file’s text, so saving, undo and git work as for any file; Open as Text at the top right shows the Markdown beside the page. With the desktop app installed, symbolic algebra works on the page too: the extension uses its beermat command. Data files beside the sheet are read too, and Python functions run after you say the file may (in a trusted folder). Excel files are read the same way, and Beermat: Import .xmcd Worksheet… converts an .xmcd file.

The beermat command

The desktop app brings the beermat command with it, for scripts and AI assistants.

• Windows: the installer adds it to the PATH (an option, on by default). Open a new terminal and type beermat.
• macOS and Linux: in the app, Tools → Install the beermat command….

Updates

Beermat checks for a new version when it starts and tells you if there is one; turn this off in Help → Check for updates at startup.