BubbleFacts

Download

Download BubbleFacts

BubbleFacts 2.0 beta · Release notes
Free and open source for Mac, Windows and Linux.

Beta note

Your Mac or Windows may ask you to confirm you want to open BubbleFacts, because this beta isn't digitally signed yet. Here's exactly what to click.

  • Mac

    macOS 13 Ventura or newer.

    Download for Mac

    A disk image. Open it, then drag the app into your Applications folder.

    Need the Intel version?

    Which Mac do I have?

    Most Macs sold since late 2020 have Apple silicon, and the button above is for those. To check yours:

    1. Click the Apple menu in the top-left corner of the screen.
    2. Choose About This Mac.
    3. If it says Chip: Apple M… (M1, M2, M3 or newer), you have Apple silicon: use the button above. If it says Processor: Intel, use the Intel version.

  • Windows

    Windows 10 or 11, 64-bit.

    Download for Windows

    An installer. Open it to install the app just for you, with no administrator password.

  • Linux: Ubuntu and Debian

    64-bit. Tested on Ubuntu 24.04 and newer.

    Known issue in this beta: on some Linux computers the built-in fact writer can't start yet. BubbleFacts still works with your own messages, and the free online fact writer (Groq, in Settings) works fine. A fix is on the way.

    Download .deb

    A package that installs like other apps on Ubuntu, Debian and similar systems.

  • Linux: other

    64-bit, with glibc 2.35 or newer. Not tested, but should work.

    Download AppImage

    A single file that runs without installing. Allow it to run as a program, then open it.

Needs macOS 13 or newer, Windows 10 or 11, or 64-bit Linux, plus OBS Studio 28 or newer on the same computer. Full system requirements.

What's new

Opening it the first time

The app isn't signed yet. Signing is a paid registration with Apple and Microsoft that tells your computer who made an app. Until that's done, your computer warns you the first time you open BubbleFacts. These warnings go away once the app is signed.

Mac

Your Mac may say the app "can't be opened because Apple cannot check it for malicious software."

  1. Open your Applications folder.
  2. Right-click BubbleFacts (or Control-click) and choose Open.
  3. Click Open again in the message.

If there's no Open button: open System Settings, go to Privacy & Security, scroll down, and click Open Anyway. You only need to do this once.

Windows

Windows SmartScreen may show a blue box saying Windows protected your PC.

  1. Click More info.
  2. Click Run anyway.

Your browser may also say the file isn't commonly downloaded. Choose to keep it.

Then follow the setup guide.

For security-conscious users and developers

Check your download

This checks that the file you downloaded is complete and exactly the one published on GitHub.

The file checker needs JavaScript turned on. You can still check a file by hand with the commands below.

Every file has a fingerprint (a SHA-256 checksum), worked out from its contents. Change even one byte and the fingerprint changes. GitHub lists the fingerprint of every download, so if yours matches, your file is good.

A match means the file arrived complete and unchanged from what's on the GitHub release page. It doesn't prove who made the file. App signing does that for your computer, and signing isn't set up yet.

Where the files come from

Every file is built by GitHub Actions from the public source code, with a build-provenance attestation: a signed record of how and where it was built, which anyone can check.

File names and commands

Release files have the version number in their names:

  • BubbleFacts-VERSION-mac-arm64.dmg (Apple silicon) and BubbleFacts-VERSION-mac-x64.dmg (Intel)
  • BubbleFacts-VERSION-windows-x64.exe
  • bubblefacts_VERSION_amd64.deb
  • BubbleFacts-VERSION-linux-x86_64.AppImage

Each release also includes SHA256SUMS.txt, the list of fingerprints. To check a file by hand, compare its line there with the output of one of these:

shasum -a 256 FILE
Get-FileHash FILE

The first works on Mac and Linux (or sha256sum on Linux), the second in Windows PowerShell. To check the build-provenance attestation, install the GitHub CLI and run:

gh attestation verify FILE --repo frolicchris/bubblefacts

With JavaScript off, each download button opens the GitHub Releases page, where you can pick the file. Older versions are there too.