Skip to content

Home

Jump to bottom
Desktop Material Verification edited this page Jul 24, 2026 · 11 revisions

Bambu Studio MD3

This fork's maintained delivery target is the native Windows build of Bambu Studio with its UI rebuilt on Material Design 3. The production wxWidgets/C++ application consumes a single vendored MD3 design system (ui-md3/design-system/, mirrored exactly by src/slic3r/GUI/Widgets/MD3Tokens.hpp) for colors, typography, metrics, and component anatomy. Upstream cross-platform releases remain available from Bambu Lab; macOS and Linux are outside this fork's release gate.

The in-repository docs are canonical; this wiki is a distilled overview. Start at the documentation index, README, ROADMAP, and HANDOFF.

MD3 program state (2026-07-22)

  • The token and typography layer is complete: theme colors and fonts across essentially the whole GUI tree (roughly 120 files over six migration waves) resolve through semantic MD3 tokens, with Roboto and Roboto Mono shipped as private application fonts. Contextual accent schemes follow the workspace: brand green for Prepare and general UI, purple for the G-code Preview, teal for Device. Functional data colors (filament swatches, G-code feature colors, 3D paint palettes) are deliberately preserved. See Design System.
  • Structural component anatomy is driven by the element-by-element MD3 parity register, the canonical live tracker. After nine implementation waves it stands at 120 rows done, 4 recorded deviations (each documented with concrete evidence in the register), and 5 open rows — the deep Prepare-sidebar rebuilds (printer identity card, bed field, filament info-rows, Process card, Objects card) — which a concurrent implementation wave is finishing.
  • Landed anatomy highlights: the Material Symbols icon font and ImGui glyph atlas, the rebuilt shared widget kit, the MD3Dialog shell with the MessageDialog family and the raw-wxMessageBox sweep, the kit title bar, the Preferences NavRail with runtime density and accent-seed controls, the device camera HUD, temperature rows, print options, AMS reskin and farm card grid, the Preview timeline transport bar, the G-code Preview color-scheme legend (per-filament value columns aligned under their headers, and the change-times / cost summary lines spaced to the table's own row rhythm), and the glyph-to-GL-texture bridge for the 3D toolbar and gizmo rail. The legend anatomy is documented at G-code preview ▸ toolpath legend.

Installer overhaul and build-from-source

The NSIS installer is restyled to Material Design 3 (custom Welcome, language, install-source, build-progress, and Finish pages, with the unavoidable Win32 deviations documented), and the previously garbled Cantonese language page is fixed at the root (UTF-8 sources compiled with /INPUTCHARSET UTF8). Alongside the default prebuilt install, an optional interactive Build from source mode bootstraps a toolchain, clones the repository at the release tag, compiles it locally with a bounded automated repair loop, and hands the payload to the same ownership, recovery, and uninstall flow as the prebuilt path. It is never reachable in silent mode and never runs in CI; its first end-to-end run on a real machine is still an open verification item. See Build From Source and the canonical installer and build-from-source docs.

Language modes

The Windows UI provides three canonical fork modes: English (en), a curated Hong Kong Cantonese preview (yue_HK), and a compact English + Cantonese bilingual preview (bilingual_en_yue_HK). Missing Cantonese copy falls back to English; bilingual presentation is opt-in on migrated surfaces; existing Bambu Studio locales remain available, and formal zh_TW is never relabeled as Cantonese. The installer offers the same three choices (silent /LANGMODE= option) and hands the selection to the app on first launch. Canonical: language-modes.md.

Native features added in this effort

  • A native OpenGL model preview for the MakerWorld "Download and Open" flow (doc).
  • A dockable Prepare sidebar (left/right/top/bottom, live re-dock from Preferences) (doc).
  • App-local, Git-backed version history for .3mf projects (local to the device, never a .git beside the project, no retention policy yet).

Releases

Windows-only releases are published by the hosted pipeline as immutable, uniquely tagged GitHub releases with an installer, SHA-256 checksum, and CycloneDX SBOM. The installer is currently unsigned — verify the accompanying SHA-256 before running it. See Releases for the release train, the immutable-release gate, the TOKEN_GITHUB publish path, and the manual r56 fallback.

Historical validation evidence from the pre-register phase (2026-07-20) is preserved on Windows MD3 Rewrite.

Clone this wiki locally