Skip to content

armgit / BUI

Public Imported from GitHub
0

Blender's GPU Accelerated UI, Decoupled from it's original codebase. Supports Rust, Python, JS, React, C & C++. Twice as good as GPUI

macos testers

Preetham Pemmasani65ec79c64a5a
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 3bf7b0b..59151d0 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -65,7 +65,7 @@ include `ui/`.)
| `gpu/` | The draw surface used by the toolkit (`GPU_*`, `imm*`) behind seam headers + a null backend that *records and forwards*: with a sink installed it emits screen-space primitives (`GPU_backend_sink.h`); without one it discards them. Theme colors reach the GPU layer through function-pointer hooks. | **Builds + tested** |
| `compat/` | Seam headers carrying upstream API names (`RNA_access.hh`, `BLF_api.hh`, …) with BUI-owned opaque types and stub implementations (`intern/bui_stubs.cc`). | **Builds** |
| `ui/` | The toolkit sources from `editors/interface`: interface.cc family, widgets, handlers, regions, view2d, views, textbox. Kept for reference and porting work; **not compiled by default** (`-DBUI_BUILD_UI=ON` builds it as `bui_ui`). `kit/` re-ports what it needs in C. | **Compiles + links** (opt-in) |
-| `kit/` | Blender's UI as a retained-mode C runtime: node tree, uiLayout-style layout, `interface_handlers.cc` interaction rules, widget drawing ported from `interface_widgets.cc` (widget-base shader parameters rendered by `gpu/` raster), menus, color picker, views, editors; Tk-style pack/grid/place geometry managers, canvas display list, multi-line text area; UI undo/redo, Tab field traversal, vertical multi-drag, panel animation; Blender's file browser; images (`kit/intern/image`: Blender's imbuf design, one format table over Wuffs, libjpeg-turbo, libwebp and BUI's HDR/PNM/SVG readers in `kit/extern`, decode at the drawn size, a worker pool and a memory-budgeted cache; see [the Images page](https://bui.preetham.top/docs/concepts/images/)); damage-driven rendering; Blender's Dark and Light themes (`kit_theme_presets.c`, generated by `tools/gen_theme.py` from Blender's `Blender_Dark.xml` / `Blender_Light.xml` presets over `userdef_default_theme.c`; `BK_set_theme`); native window hosts for Win32, X11 and Cocoa (`kit_window_win32.c`, `kit_window_x11.c`, `kit_window_cocoa.m`; `kit_window_null.c` elsewhere). The Win32 host is BUI's own; the X11 host follows Blender's GHOST input mapping, and the Cocoa host (experimental: checked by CI and tried by hand on an Apple Silicon Mac) is ported from GHOST's Cocoa backend. `kit/intern/blender/` holds Blender files copied in and edited for the kit (each edit marked `BUI:`): `interface_string_search.cc` (menu search with recent searches), `interface_undo.cc` (text-edit undo), `interface_utils.cc` (float display precision). C API: `kit/include/BUI_kit.h`. | **Builds + tested** |
+| `kit/` | Blender's UI as a retained-mode C runtime: node tree, uiLayout-style layout, `interface_handlers.cc` interaction rules, widget drawing ported from `interface_widgets.cc` (widget-base shader parameters rendered by `gpu/` raster), menus, color picker, views, editors; Tk-style pack/grid/place geometry managers, canvas display list, multi-line text area; UI undo/redo, Tab field traversal, vertical multi-drag, panel animation; Blender's file browser; images (`kit/intern/image`: Blender's imbuf design, one format table over Wuffs, libjpeg-turbo, libwebp and BUI's HDR/PNM/SVG readers in `kit/extern`, decode at the drawn size, a worker pool and a memory-budgeted cache; see [the Images page](https://bui.preetham.top/docs/concepts/images/)); damage-driven rendering; Blender's Dark and Light themes (`kit_theme_presets.c`, generated by `tools/gen_theme.py` from Blender's `Blender_Dark.xml` / `Blender_Light.xml` presets over `userdef_default_theme.c`; `BK_set_theme`); native window hosts for Win32, X11 and Cocoa (`kit_window_win32.c`, `kit_window_x11.c`, `kit_window_cocoa.m`; `kit_window_null.c` elsewhere). The Win32 host is BUI's own; the X11 host follows Blender's GHOST input mapping, and the Cocoa host (experimental: checked by CI and tried by hand on two Apple Silicon Macs) is ported from GHOST's Cocoa backend. `kit/intern/blender/` holds Blender files copied in and edited for the kit (each edit marked `BUI:`): `interface_string_search.cc` (menu search with recent searches), `interface_undo.cc` (text-edit undo), `interface_utils.cc` (float display precision). C API: `kit/include/BUI_kit.h`. | **Builds + tested** |
| `api/` | `bui_c_api.h` — small stable C ABI: version info + sink/viewport plumbing for hosts and bindings. | **Builds + tested** |
| `bindings/python/` | `buipy` CPython extension (no third-party deps) + `bui` package: `bui.components` (Blender component library), `bui.qtsyntax` / `bui.tksyntax` (Qt / tkinter APIs as thin facades over the kit), `bui.host` (native or Tk windows), `SvgSink` headless renderer, `bui.qt.BuiCanvas` PySide6/PyQt6 widget. | **Builds + tested** |
| `bindings/imgui/` | Dear ImGui (vendored, 1.93.1 WIP) on BUI: `imgui_impl_bui` platform + renderer backend hosted in a kit `custom` node (input, cursors, clipboard, DPI, damage-driven frames) drawing through `BUI_raster_mesh` and BUI textures; Blender style and Inter font; the C API (`cimgui.h`) and the generator behind the Python and Rust bindings; the Blender-widgets build (`blender/`, `-DBUI_IMGUI_BLENDER_WIDGETS=ON`). Gate: `-DBUI_BUILD_IMGUI` (ON with C++). | **Builds + tested** |
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b666ca5..af02122 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,15 @@ All notable changes to **blenderui** (BUI). The format follows
## [Unreleased]
+### Changed
+- **macOS:** the testing guide now lists both testers ([Krish Kalaria](https://github.com/krishkalaria12): issue #3, fixed by
+ pull request #4; [DanNoby](https://github.com/DanNoby): 17/17 tests, issue #6), explains the Command Line Tools versus
+ SDK mismatch (`ld: tapi error: malformed file`: select the full Xcode toolchain and delete
+ `build/`), and records a known bug from his log: the Python extensions `buipy` and
+ `_buiimgui` each embed the Cocoa host, so Objective-C prints "Class BUIKitView is implemented
+ in both". The docs and the website say two Apple Silicon Macs.
+- **CI:** the Apple Silicon runner is `macos-15` (GitHub retired `macos-14`).
+
## [0.4.0] - 2026-11-06
### Added
diff --git a/README.md b/README.md
index 06c2b2d..95d4e02 100644
--- a/README.md
+++ b/README.md
@@ -1107,7 +1107,7 @@ A **window host** puts a kit context in a top-level window and feeds it input.
| -------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Win32** (`kit_window_win32.c`) | Windows | BUI's own host. Per-monitor DPI, vsync-paced animation, clipboard, cursors, window-manager features. |
| **X11** (`kit_window_x11.c`) | Linux; Wayland through XWayland | Input mapping after Blender's GHOST. `Xft.dpi` scaling. libX11 is loaded when the first window opens. |
-| **Cocoa** (`kit_window_cocoa.m`) | macOS | **Experimental.** Ported from Blender's GHOST Cocoa code, with Retina scaling. It's checked by CI and has been tried by hand on one Apple Silicon Mac so far; testing notes in [docs/macos-testing.md](docs/macos-testing.md). |
+| **Cocoa** (`kit_window_cocoa.m`) | macOS | **Experimental.** Ported from Blender's GHOST Cocoa code, with Retina scaling. It's checked by CI and has been tried by hand on two Apple Silicon Macs so far; testing notes in [docs/macos-testing.md](docs/macos-testing.md). |
| **Tk** | Python, anywhere | A stdlib `tkinter` window that shows the kit's frame buffer. `BUI_HOST=tk` forces it; it's also the fallback where no native host works. |
| **Headless** | Everywhere | No window: render into a raster for tests and screenshots, with a virtual clock that steps animations exactly. |
@@ -1641,11 +1641,11 @@ py bindings/python/bench/tk_canvas_bench.py 3000 one # move one
| HiDPI | Per-monitor DPI | `Xft.dpi` | Retina (backing scale) |
**Works** means it works and is tested. **Experimental** means it's written
-but has had little hands-on testing on real hardware (macOS: one Apple Silicon Mac so far, plus CI).
+but has had little hands-on testing on real hardware (macOS: two Apple Silicon Macs so far, plus CI).
**macOS.** The macOS window host is new: it's a port of Blender's Cocoa code
-(GHOST). So far it has been checked by CI and tried by hand on one Apple Silicon
-Mac by [Krish Kalaria](https://github.com/krishkalaria12), who reported issue #3 and fixed it in pull request #4. If you have another one, please try it and
+(GHOST). So far it has been checked by CI and tried by hand on two Apple Silicon
+Macs: by [Krish Kalaria](https://github.com/krishkalaria12), who reported issue #3 and fixed it in pull request #4, and by [DanNoby](https://github.com/DanNoby) (17/17 tests; issue #6 added a toolchain note to the guide). If you have another Mac, especially an Intel one, please try it and
tell us what happens: [docs/macos-testing.md](docs/macos-testing.md). Python
can still use the stdlib Tk window there (`BUI_HOST=tk`; this needs Python's
`tkinter`, for example from python.org or `brew install python-tk`). Node runs
@@ -1828,7 +1828,7 @@ How each was counted: [Coverage](https://bui.preetham.top/docs/reference/coverag
| Rust components | No async resources (`use_resource`); no generic components |
| Dear ImGui | Python and safe Rust skip the `va_list`, `void*` and C-callback functions (reachable from C and the Rust FFI); with Blender widgets, window title bars, tooltips, plain popups, tables and the color picker keep ImGui's drawing |
| JavaScript / React packages | npm packages are prebuilt for Windows x64 only (on Linux, build the addon from source); events reach JavaScript after BUI handled them (no native `preventDefault`), and `event.target` is the deepest _listening_ element |
-| macOS | **Experimental.** The native Cocoa window host is written, checked by CI and tried by hand on one Apple Silicon Mac ([how to help](docs/macos-testing.md)); JavaScript is headless there (Node's UI thread isn't the main thread); no GPU renderer yet |
+| macOS | **Experimental.** The native Cocoa window host is written, checked by CI and tried by hand on two Apple Silicon Macs ([how to help](docs/macos-testing.md)); JavaScript is headless there (Node's UI thread isn't the main thread); no GPU renderer yet |
| Themes | Dark and Light work; loading other Blender theme files doesn't yet |
**Planned (coming soon)**
diff --git a/docs/getting-started.md b/docs/getting-started.md
index fea8e2e..29b7dd2 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -105,7 +105,7 @@ shared (`bui.host`).
changed tiles. It follows the display's DPI (per-monitor on Windows,
`Xft.dpi` on X11) and paces animations to the display's refresh rate.
- **Native (macOS, experimental).** A Cocoa window (a port of Blender's GHOST
- code; new, checked by CI and tried by hand on an Apple Silicon Mac) with Retina scaling. It needs the main
+ code; new, checked by CI and tried by hand on two Apple Silicon Macs) with Retina scaling. It needs the main
thread. See [macos-testing.md](macos-testing.md).
- **Tk (with `BUI_HOST=tk`, or where no native host works).** A stdlib `tkinter` window that
shows the kit's frame buffer and forwards input to it. The UI and the API
diff --git a/docs/macos-testing.md b/docs/macos-testing.md
index 9371cdf..aff8888 100644
--- a/docs/macos-testing.md
+++ b/docs/macos-testing.md
@@ -1,10 +1,14 @@
# Testing BUI on macOS
-Thanks for testing BUI on a Mac. The macOS window host is new. CI checks it, and
-[Krish Kalaria](https://github.com/krishkalaria12) has tried it by hand on an Apple Silicon MacBook Air. His
-report (issue #3) and fixes became pull request #4: Quit, window sizing and tkinter. More Macs find
-more, especially Intel Macs and older macOS versions, because a person clicking
-around finds what CI can't.
+Thanks for testing BUI on a Mac. The macOS window host is new. CI checks it, and two people
+have tried it by hand on Apple Silicon Macs (below). Their reports found real bugs and a build
+trap, now fixed or documented. More Macs find more, especially Intel Macs and older macOS
+versions, because a person clicking around finds what CI can't.
+
+| Tester | Mac | Commit | Result | What it led to |
+| --- | --- | --- | --- | --- |
+| [Krish Kalaria](https://github.com/krishkalaria12) | MacBook Air (M5), simulated input | `53263f8` | 16/17 ctest; Cocoa window, Retina, input all work | Issue #3, fixed by pull request #4: tkinter variables, Quit, `geometry()` and fit-to-content sizing |
+| [DanNoby](https://github.com/DanNoby) | Apple Silicon, trackpad and mouse, Python 3.12 | `adf5632` | 17/17 ctest, the whole section 5 checklist works | Issue #6: the toolchain trap in section 1, and the duplicate Objective-C classes in section 7 |
This guide takes about 30–60 minutes: build from source, run the tests, try a
few apps, and report back.
@@ -34,6 +38,21 @@ You need macOS 11 (Big Sur) or newer, on Apple Silicon or Intel.
The `python3` that comes with the Command Line Tools is 3.9, which is too old.
Use the full name of a newer one (`python3.12` below) everywhere.
+**If CMake fails at its compiler test with `ld: tapi error: malformed file` or
+`error: unknown architecture arm64e.x1-macos`:** the Command Line Tools on your Mac are older
+than its macOS SDK (seen with AppleClang 17 against `MacOSX27.0.sdk`), so the linker can't read
+the SDK's text stubs. This is a toolchain mismatch, not a BUI bug. Select the full Xcode
+toolchain, delete the build directory (CMake caches the failed compiler test) and configure again:
+
+```sh
+sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
+rm -rf build
+```
+
+Reported and confirmed by [DanNoby](https://github.com/DanNoby) (issue #6): after that the build succeeded and all tests
+passed with no source changes. Updating the Command Line Tools in System Settings > Software
+Update does the same for most people.
+
## 2. Get the code
```sh
@@ -209,6 +228,15 @@ Blender's Ctrl** (Cmd+C, Cmd+V, Cmd+Z, Cmd+wheel) and **Option is Alt**.
- **No input method (IME) support yet:** composed input such as Japanese or
Chinese, and possibly dead-key accents, is not expected to work.
- Fonts are Blender's (Inter, drawn with FreeType like Blender), not the system font.
+- **Python prints `objc: Class BUIKitView is implemented in both buipy... and _buiimgui...`**
+ (also `BUIKitNSWindow`, `BUIKitWindowDelegate`, `BUIKitAppDelegate`) when both extensions are
+ loaded, for example in the Dear ImGui test. Each of the two Python extensions embeds the Cocoa
+ host, so its Objective-C classes exist twice. The tests pass with it (17/17 on [DanNoby](https://github.com/DanNoby)'s Mac),
+ but the Objective-C runtime warns it "may cause spurious casting failures and mysterious
+ crashes", so treat it as a known bug until the host is shared or renamed. It needs a Mac to
+ verify the fix. Reported through [DanNoby](https://github.com/DanNoby)'s test log. Also expected in that log:
+ `gpu_parity: no GPU device, skipped` (there is no Metal renderer) and
+ `[imgui-error] Missing End()` (a test of error reporting).
- Python: when tkinter is importable, BUI starts a hidden Tk first (Tk insists on
creating the application object). `BUI_MAC_TK=0` skips that; `BUI_HOST=tk`
draws BUI inside a Tk window instead of a native one, for comparison.
diff --git a/docs/rust.md b/docs/rust.md
index 9bcdc2a..e3a51a8 100644
--- a/docs/rust.md
+++ b/docs/rust.md
@@ -720,7 +720,7 @@ The `gdi-text` feature uses Windows' GDI engine and system fonts.
transforms) shows its first frame. `video`, `audio`,
`iframe` show a placeholder.
- **Windows** are native on Windows (Win32), Linux (X11) and macOS (Cocoa,
- new, tried by hand so far on one Apple Silicon Mac; it needs the main thread). The GPU
+ new, tried by hand so far on two Apple Silicon Macs; it needs the main thread). The GPU
renderer runs on Windows and Linux.
- `text-align: justify` aligns left. Table columns are sized from their
widest single-line content, a simpler version of browsers' auto layout.
diff --git a/website/src/components/landing/Coming.astro b/website/src/components/landing/Coming.astro
index 99d0ab0..2a8d59c 100644
--- a/website/src/components/landing/Coming.astro
+++ b/website/src/components/landing/Coming.astro
@@ -3,7 +3,7 @@
import Icon from "../site/Icon.astro";
const items = [
- { title: "macOS, tested", body: "The Cocoa host has been tried by hand on an Apple Silicon Mac, and that found and fixed real bugs. Next: more Macs (Intel, older macOS; testers welcome), then the GPU renderer and JavaScript windows there.", tag: "In progress" },
+ { title: "macOS, tested", body: "The Cocoa host has been tried by hand on two Apple Silicon Macs, and that found and fixed real bugs. Next: more Macs (Intel, older macOS; testers welcome), then the GPU renderer and JavaScript windows there.", tag: "In progress" },
{ title: "WebAssembly", body: "The kit in the browser: the raster blits to a <canvas>, and React and the DOM-like API run on top, unchanged.", tag: "Planned" },
{ title: "egui", body: "BUI panels inside egui apps, plus a Blender-styled egui theme.", tag: "Planned" },
{ title: "More languages", body: "MyGo, C#, Go, Zig, Swift, Kotlin and Lua over the same C header; Godot, Unity, Bevy and Flutter.", tag: "Planned" },
diff --git a/website/src/components/landing/Platforms.astro b/website/src/components/landing/Platforms.astro
index ba023ac..0c02da3 100644
--- a/website/src/components/landing/Platforms.astro
+++ b/website/src/components/landing/Platforms.astro
@@ -51,7 +51,7 @@ const rows: [string, Cell, Cell, Cell][] = [
<p class="flex gap-2 border-t border-border px-5 py-3 text-[13px] leading-6 text-muted sm:px-8">
<span class="mt-1"><StatusMark status="experimental" compact /></span>
<span>
- The macOS window host is a port of Blender's Cocoa code (GHOST): checked by CI and tried by hand on one Apple Silicon Mac so far, by <a class="text-link underline underline-offset-4" href="https://github.com/krishkalaria12">Krish Kalaria</a>, who also fixed what he found. Python can use the
+ The macOS window host is a port of Blender's Cocoa code (GHOST): checked by CI and tried by hand on two Apple Silicon Macs so far, by <a class="text-link underline underline-offset-4" href="https://github.com/krishkalaria12">Krish Kalaria</a>, who also fixed what he found, and <a class="text-link underline underline-offset-4" href="https://github.com/DanNoby">DanNoby</a>. Python can use the
standard Tk window there meanwhile (<code class="font-mono">BUI_HOST=tk</code>). If you have another Mac (Intel, or an older macOS) and a free afternoon,
you could be next: the <a class="text-link underline underline-offset-4" href={repoFile("docs/macos-testing.md")}>macOS testing guide</a>{" "}
walks you through it.
diff --git a/website/src/content/docs/concepts/window-hosts.mdx b/website/src/content/docs/concepts/window-hosts.mdx
index e336327..80b32c3 100644
--- a/website/src/content/docs/concepts/window-hosts.mdx
+++ b/website/src/content/docs/concepts/window-hosts.mdx
@@ -16,7 +16,7 @@ This page explains each host, how to choose one yourself, and what to expect on
<StatusTable columns={["Host", "Status", "Where and what"]} rows={[
["<strong>Win32</strong>", "done", "Windows. Native, written in C"],
["<strong>X11</strong>", "done", "Linux (Wayland sessions through XWayland). Native, written in C"],
- ["<strong>Cocoa</strong>", "experimental", "macOS. Native, tried by hand on one Apple Silicon Mac so far"],
+ ["<strong>Cocoa</strong>", "experimental", "macOS. Native, tried by hand on two Apple Silicon Macs so far"],
["<strong>Tk</strong>", "done", "Anywhere Python has <code>tkinter</code>. Python only; the fallback"],
["<strong>Headless</strong>", "done", "Anywhere. No window: tests and screenshots"],
]} />
diff --git a/website/src/content/docs/project/publishing.mdx b/website/src/content/docs/project/publishing.mdx
index cf45f7e..2145824 100644
--- a/website/src/content/docs/project/publishing.mdx
+++ b/website/src/content/docs/project/publishing.mdx
@@ -150,7 +150,7 @@ A published crate can't reach files outside itself, so `blenderui-sys` must carr
## Known gaps before 1.0
-- **macOS:** the native Cocoa host has been tried by hand on one Apple Silicon Mac so far. With `BUI_HOST=tk`, the wheels use the standard Tk window instead.
+- **macOS:** the native Cocoa host has been tried by hand on two Apple Silicon Macs so far. With `BUI_HOST=tk`, the wheels use the standard Tk window instead.
- **Windows wheels** are built with MinGW. MSVC builds work (the Rust crate and the CMake build use it), but aren't what's published.
- **No musllinux or 32-bit wheels** yet.
- **npm:** prebuilt for Windows x64 only.
diff --git a/website/src/content/docs/project/roadmap.mdx b/website/src/content/docs/project/roadmap.mdx
index 7cc6508..16f760e 100644
--- a/website/src/content/docs/project/roadmap.mdx
+++ b/website/src/content/docs/project/roadmap.mdx
@@ -38,7 +38,7 @@ Each row has a status: **Works** when it works and is tested, **Partial** when c
["Rust components", "partial", "No async resources (<code>use_resource</code>) and no generic components yet"],
["Dear ImGui", "partial", "Python and safe Rust skip the <code>va_list</code>, <code>void*</code> and C-callback functions; in the Blender-widgets build, title bars, tooltips, plain popups, tables and the color picker keep ImGui's drawing"],
["npm packages", "partial", "Prebuilt for Windows x64 only; on Linux, build the addon from source"],
- ["macOS", "experimental", "The Cocoa window host is checked by CI and has been tried by hand on one Apple Silicon Mac (<a href='https://github.com/ppmpreetham/BUI/blob/main/docs/macos-testing.md'>testing guide</a>); JavaScript is headless there; no GPU renderer yet"],
+ ["macOS", "experimental", "The Cocoa window host is checked by CI and has been tried by hand on two Apple Silicon Macs (<a href='https://github.com/ppmpreetham/BUI/blob/main/docs/macos-testing.md'>testing guide</a>); JavaScript is headless there; no GPU renderer yet"],
]}
/>
diff --git a/website/src/content/docs/reference/platforms.mdx b/website/src/content/docs/reference/platforms.mdx
index 098bc71..905e691 100644
--- a/website/src/content/docs/reference/platforms.mdx
+++ b/website/src/content/docs/reference/platforms.mdx
@@ -22,7 +22,7 @@ BUI runs on Windows, Linux and macOS. Windows and Linux are fully supported; mac
| Images | All [built-in formats](/docs/concepts/images); decode threads; GPU atlas | All built-in formats; decode threads; GPU atlas | All built-in formats; decode threads (CPU raster) |
| [Video](/docs/concepts/video) | Works: Media Foundation (DXVA), tested | Works: GStreamer (VA-API where available), tested under WSL | AVFoundation: written, **untested** |
-**Works** means it works and is tested. **Experimental** means it's written and checked by CI, but has had little hands-on testing on real hardware (macOS: one Apple Silicon Mac so far).
+**Works** means it works and is tested. **Experimental** means it's written and checked by CI, but has had little hands-on testing on real hardware (macOS: two Apple Silicon Macs so far).
## Windows
@@ -44,7 +44,7 @@ BUI runs on Windows, Linux and macOS. Windows and Linux are fully supported; mac
## macOS <Badge tone="preview">Experimental</Badge>
-- **Window:** a native Cocoa host, ported from Blender's GHOST code, with Retina scaling. It's checked by CI and has been tried by hand on one Apple Silicon Mac by [Krish Kalaria](https://github.com/krishkalaria12), who also fixed the bugs he found (issue #3, pull request #4). AppKit only allows windows on the main thread.
+- **Window:** a native Cocoa host, ported from Blender's GHOST code, with Retina scaling. It's checked by CI and has been tried by hand on two Apple Silicon Macs: by [Krish Kalaria](https://github.com/krishkalaria12), who also fixed the bugs he found (issue #3, pull request #4), and by [DanNoby](https://github.com/DanNoby) (17/17 tests; issue #6 added a toolchain note to the guide). AppKit only allows windows on the main thread.
- **Python fallback:** if the native host misbehaves, use the standard Tk window: `BUI_HOST=tk`. That needs a Python with `tkinter` (for example from python.org, or `brew install python-tk`).
- **JavaScript is headless.** Node runs BUI on its own UI thread, and macOS only allows windows on the main thread.
- **Renderer:** the CPU raster only.
diff --git a/website/src/content/docs/rust/overview.mdx b/website/src/content/docs/rust/overview.mdx
index fc05315..063d13d 100644
--- a/website/src/content/docs/rust/overview.mdx
+++ b/website/src/content/docs/rust/overview.mdx
@@ -217,7 +217,7 @@ BUI's Rust side covers a lot, but not everything. Each page lists its own gaps;
- **Images**: every [format](/docs/concepts/images) decodes and animations play, but one inside a CSS effect layer (filters, masks, 3D transforms) shows its first frame. `video`, `audio` and `iframe` show a placeholder.
- **Transforms:** every 2D transform draws, but clicks use the untransformed box. 3D transforms have no effect.
- **Tables** size columns from their widest single-line content, a simpler version of browsers' auto layout.
-- **Windows** are native on Windows (Win32), Linux (X11) and macOS (Cocoa). The Cocoa host is new and has been tried by hand on one Apple Silicon Mac so far, and it needs the main thread. The GPU renderer runs on Windows and Linux.
+- **Windows** are native on Windows (Win32), Linux (X11) and macOS (Cocoa). The Cocoa host is new and has been tried by hand on two Apple Silicon Macs so far, and it needs the main thread. The GPU renderer runs on Windows and Linux.
- **Components:** async resources (`use_resource`) and generic components are <ComingSoon inline />.
<Callout type="joke">