From 8448348dce7db1b6b1b09c85eef62dd07f6366d7 Mon Sep 17 00:00:00 2001 From: dan-sheehan Date: Tue, 28 Jul 2026 23:56:19 -0700 Subject: [PATCH 1/2] docs(readme): clarify which release asset to download per platform Signed-off-by: Dan Sheehan --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 72af92ce13..873540f09f 100644 --- a/README.md +++ b/README.md @@ -115,7 +115,19 @@ New to Buzz? Pick the path that matches you. ### I just want to try the app -Grab a packaged build from the [latest release](https://github.com/block/buzz/releases/latest) — macOS (`.dmg`), Linux (`.AppImage` / `.deb`), or Windows (`.exe`). Install it like any other app. +Grab a packaged build from the [latest release](https://github.com/block/buzz/releases/latest): + +| Platform | File | +|---|---| +| macOS (Apple Silicon) | `Buzz__aarch64.dmg` | +| macOS (Intel) | `Buzz__x64.dmg` | +| Linux (x86_64) | `Buzz__amd64.AppImage` or `Buzz__amd64.deb` | +| Windows (x64) | `Buzz__x64-setup_alpha-unsigned.exe` | + +On a Mac, check the Apple menu > About This Mac: "Apple M1/M2/M3/M4" means Apple Silicon, "Intel" means x64. + +The Windows build is not code-signed, so SmartScreen will show "Windows protected your PC" on first launch. Click **More info**, then **Run anyway**. + By default the app connects to `ws://localhost:3000`. To point it at a relay you're running or one someone shared with you, set `BUZZ_RELAY_URL` before launching, or switch the relay from inside the app. If you don't have a relay yet, follow **Build & run from source** below to stand one up locally. From 3b6a011fcde92cd99dcd5a977b3a07d43eb9ef7f Mon Sep 17 00:00:00 2001 From: npub12gtutshhh76rx0jx697f32f9tffd4hhp3hx58fp4x6u4uemkm7sqf8f757 <5217c5c2f7bfb4333e46d17c98a9255a52dadee18dcd43a43536b95e6776dfa0@buzz.block.builderlab.xyz> Date: Sat, 1 Aug 2026 08:57:23 -0400 Subject: [PATCH 2/2] docs(readme): make platform guidance future-proof Co-authored-by: npub12gtutshhh76rx0jx697f32f9tffd4hhp3hx58fp4x6u4uemkm7sqf8f757 <5217c5c2f7bfb4333e46d17c98a9255a52dadee18dcd43a43536b95e6776dfa0@buzz.block.builderlab.xyz> Signed-off-by: npub12gtutshhh76rx0jx697f32f9tffd4hhp3hx58fp4x6u4uemkm7sqf8f757 <5217c5c2f7bfb4333e46d17c98a9255a52dadee18dcd43a43536b95e6776dfa0@buzz.block.builderlab.xyz> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 873540f09f..cb84aac913 100644 --- a/README.md +++ b/README.md @@ -124,9 +124,9 @@ Grab a packaged build from the [latest release](https://github.com/block/buzz/re | Linux (x86_64) | `Buzz__amd64.AppImage` or `Buzz__amd64.deb` | | Windows (x64) | `Buzz__x64-setup_alpha-unsigned.exe` | -On a Mac, check the Apple menu > About This Mac: "Apple M1/M2/M3/M4" means Apple Silicon, "Intel" means x64. +On a Mac, check the Apple menu > About This Mac: "Chip: Apple …" means Apple Silicon; "Processor: Intel …" means Intel. -The Windows build is not code-signed, so SmartScreen will show "Windows protected your PC" on first launch. Click **More info**, then **Run anyway**. +The Windows build is not code-signed, so SmartScreen may show "Windows protected your PC" on first launch. If available, click **More info**, then **Run anyway**. By default the app connects to `ws://localhost:3000`. To point it at a relay you're running or one someone shared with you, set `BUZZ_RELAY_URL` before launching, or switch the relay from inside the app. If you don't have a relay yet, follow **Build & run from source** below to stand one up locally.