Skip to content

Home

Jump to bottom
Desktop Material Test edited this page Jul 28, 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.

The Pages site is now a tabbed application (2026-07-28)

The published site at https://ding-ding-projects.github.io/BambuStudio/ was rebuilt from a single scrolling landing page into a browser-style tabbed application: eight tabs with a pinnable, draggable, groupable, searchable strip; English and Hong Kong Cantonese copy at five funny levels per language on two independent sliders; a full ECMAScript regex builder behind every search bar; a changelog viewer over every published release; non-blocking notifications; and a one-in-a-hundred dim sum surprise. Its deploy is gated on 444 measured layout cases in a real headless browser.

Interactive visual showcase (2026-07-27)

The GitHub Pages landing page and interactive browser app now share eleven original, web-optimized visuals: a cinematic printer hero, one purpose-built image for every app screen card, app Home artwork, recent-project thumbnails, and a social preview. Essential labels and actions remain live localized HTML; the images are responsive, lazy-loaded where appropriate, reduced-motion aware, and deployed as a sub-700-KiB WebP set.

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 resizable, bounded Smart home dialog for Home Assistant media, lights, and safe printer handover. Native clipping review caught and corrected 44-pixel-square text actions, with genuine 720×760 and 520×480 captures and explicit performance limits (Smart Home and Home Assistant).
  • 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).

Wave 2026-07-24: search everywhere, config profiles & backup, Ctrl+F palette

  • The complete screenshot matrix was re-captured from the current build, light and dark (index), and two light-mode Preview defects found by that pass were fixed (legend text legibility, narrow move-bar overlap).
  • Search bars now cover Version history, the print-host upload queue, and config profiles; the Plater object search matches by filament colour (hex or name). Every search field carries the full regex builder, now with a tabbed Reference mini-documentation and an OpenCode helper (doc).
  • File > Config profiles & backup: export the entire data directory (secrets included, slide-to-confirm gated), import on another PC as a new profile, unlimited profiles with one-click launch, per-profile local Git snapshot history (doc).
  • Ctrl+F command palette over every menu command, navigation target and quick setting (doc).

Roadmap execution wave (2026-07-24, evening)

  • MD3 dialog chrome (custom captions replacing native title bars on the owned dialogs) and an M3 motion system (reduced-motion aware fades and snap-backs) (roadmap).
  • Preferences auto-history: every settings change commits BambuStudio.conf into an isolated local Git repo, with a browser and safe restore (doc).
  • AI printer watch: opt-in, localhost-only Ollama summaries of the live camera view with failure diagnosis (doc).
  • The MD3 parity register stands at 128 done / 3 justified deviations / 0 open.

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