BambuStudio · BenJule Fork

About

What is this fork?

A community-maintained fork of BambuLab's BambuStudio with a focus on Linux quality, automated packaging, and hardened CI/CD pipelines.

v02.07.01

Current Version

5+

Package Formats

6

Build Platforms

Daily

Nightly Releases

ℹ️

This fork tracks BambuLab/BambuStudio upstream and adds Linux packaging (APT, AUR, RPM, Flatpak), Wayland fixes, a develop-branch/nightly workflow, and OpenSSF security hardening. All upstream features are preserved.

Fork Lineage

Slic3r Original open-source slicer by Alessandro Ranellucci (AGPL-3.0)
PrusaSlicer Prusa Research's fork — advanced multi-material, supports & infill (AGPL-3.0)
BambuStudio Bambu Lab's fork — X1/P1/A1 printer support, cloud features (AGPL-3.0)
BenJule/BambuStudio This fork — enhanced Linux support, packaging, Wayland, CI/CD (AGPL-3.0)

Capabilities

What this fork adds

Everything from upstream, plus Linux-first improvements and enterprise CI/CD.

📦

Multi-Distro Packaging

Native packages for Debian trixie, Ubuntu 22.04 + 24.04, Fedora 42, openSUSE Tumbleweed, and Arch Linux. APT repository with automatic updates.

🌊

Wayland Support

Fixes gtk_window_resize assertion on Wayland compositors. Window geometry is safely deferred until the compositor has realized the window.

🌱

develop Integration Branch

Fixes and features land on develop first, where the nightly builds every platform. Only a green, stable develop is promoted to master — keeping master release-ready.

🔒

Hardened CI/CD

Pinned action SHAs, Harden Runner (egress audit), OpenSSF Scorecard, Dependency Review, CodeQL, signed commits required on master.

🌙

Nightly Releases

Automated nightly pre-releases built from develop — daily at 22:00 UTC and on every push to develop. 14-day rolling history keeps the release page clean.

🤖

Copilot-Reviewed PRs

Every pull request receives a GitHub Copilot code review before merge. Medium and high findings must be resolved before landing.

🎨

Splash Screen Fix

Application name and version displayed on separate lines in the splash screen for improved readability at any resolution.

🏗️

Branch Protection

Master requires the CI Gate status check to pass and GPG-signed commits; force-push and branch deletion are blocked — nothing broken can land.

💻

All Upstream Features

Multi-plate management, remote control, tree/normal/hybrid supports, multi-material painting, STEP format, arc paths (G2/G3), and more.

Installation

Get BambuStudio

Choose your platform. APT and AUR provide automatic updates via your package manager.

APT Repository (recommended — automatic updates)

curl -fsSL https://apt.s3-dev.ovh/KEY.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/bambustudio.gpg
echo "deb [signed-by=/etc/apt/trusted.gpg.d/bambustudio.gpg] https://apt.s3-dev.ovh stable main" \
  | sudo tee /etc/apt/sources.list.d/bambustudio.list
sudo apt update && sudo apt install bambu-studio

Updates via sudo apt upgrade. Supports Debian 12+, Ubuntu 22.04, Ubuntu 24.04.

Ubuntu PPA (Launchpad)

sudo add-apt-repository ppa:benlue/bambu-studio
sudo apt update && sudo apt install bambu-studio

Native apt updates from Canonical's Launchpad. Built for Ubuntu 22.04 (jammy) and 24.04 (noble).

Direct .deb download

Download the latest .deb from the releases page and install:

sudo dpkg -i bambustudio_*.deb && sudo apt-get install -f

COPR (recommended — automatic updates)

sudo dnf copr enable benlue/bambu-studio
sudo dnf install bambu-studio

Native dnf updates from Fedora COPR. Updates via sudo dnf upgrade. Built for Fedora 42/43/44.

Direct .rpm download

Download the latest .rpm from the releases page and install:

sudo dnf install ./bambustudio-*.rpm

AUR Helper (recommended)

yay -S bambu-studio-bin

Works with any AUR helper: paru, trizen, etc. Updates via yay -Syu.

Manual installation

Download the snapshot directly from the AUR package page, then build and install:

git clone https://aur.archlinux.org/bambu-studio-bin.git
cd bambu-studio-bin
makepkg -si

Update manually by pulling the latest PKGBUILD and running makepkg -si again, or use the AUR package page to download the snapshot.

ℹ️

The bambu-studio-bin package installs the pre-built binary — no compilation required. It is maintained by BenLue and updated automatically after each release.

AppImage (portable — any Linux distro)

Download the latest AppImage from the releases page:

chmod +x BambuStudio_*.AppImage && ./BambuStudio_*.AppImage

No installation required. Works on any modern 64-bit Linux. Ubuntu 22.04 and 24.04 AppImages are produced nightly.

Homebrew (recommended)

brew tap BenJule/homebrew-tap
brew install --cask bambu-studio

Updates via brew upgrade --cask bambu-studio. Supports macOS 13+ (Intel & Apple Silicon).

Direct download

Download the .dmg installer from the releases page.

winget

winget install BenJule.BambuStudio

Updates via winget upgrade. Requires Windows 10 or later.

Installer

Download the .exe installer for x64 or ARM64 from the releases page.

Pipelines

CI/CD & Build Status

Fully automated pipelines: changes land on develop, the nightly validates every platform, then a green develop is promoted to master — signed, tested, and packaged.

Workflow	Trigger	Platforms
CI: PR Build	Every PR to develop/master	Path-aware: Debian, Fedora, macOS, Windows + CI Gate
CI: Debian Container	Weekly / Dockerfile change	ghcr.io debian:trixie image
CD: Nightly	Push to `develop` / daily 22:00 UTC	All platforms + Flatpak
CD: Release Candidate	Push to `release/**`	All platforms + Flatpak
CD: Release	Version tag / manual	All platforms + SBOM + Attestation
CD: Build Packages	Manual / release	Debian trixie, Fedora 42
Security: CodeQL	Push to master / PR / weekly	C++ (security-and-quality)
Security: Dependency Review	Every pull request	—
OpenSSF Scorecard	Push to master / weekly	—

Release Pipeline

Pull Request opened against develop Path-aware CI builds the affected platforms; the CI Gate aggregates them; dependency security check runs automatically
Merged to develop Signed commit required; the CI Gate must be green. develop is the shared integration branch — never push fixes straight to master
Nightly build (push to develop / 22:00 UTC) All platforms built and tested from develop; pre-release published with 14-day rolling history
Promoted to master Only a green, stable develop is promoted to master — the controlled, release-ready snapshot
Release triggered Version tag pushed → full platform matrix → signed tag, APT, AUR, Homebrew, winget, and Flatpak deployed

Master Branch Protection

✅ Required Status Check

The single CI Gate check aggregates the path-aware platform builds and must pass before any PR merges to master. Docs-only PRs pass without a full build.

✅ Signed Commits

All commits to master must be GPG-signed. Force push and branch deletion are permanently blocked.

✅ develop → master Promotion

Master is only advanced from a green, stable develop. Release Candidate and Release builds are always cut from master.

Get Involved

Contributing

Contributions are welcome. Every change follows the Issue → Branch → PR → Review → Merge workflow.

⚠️

Open every PR against develop, not master. develop is the shared integration branch; master is advanced only by promoting a green, nightly-tested develop. Never push directly to either branch.

Contribution Workflow

1. Open an IssueDescribe the bug or feature. Assign milestone and label.
2. Create a branch off developUse fix/short-description or feat/short-description.
3. Open a Pull Request to developTarget develop and reference the issue with Closes #N. Path-aware CI runs automatically.
4. ReviewRequest a Copilot review in the GitHub UI. Address medium/high findings.
5. Squash Merge to developCI Gate green → squash-merge. The nightly then validates develop on all platforms before it is promoted to master.

🐛

Report a Bug

Use the bug report or crash report template.

Open issue →

💡

Request a Feature

Describe the use case and expected behaviour.

Open issue →

🔒

Security Vulnerability

Do not open a public issue. Use the security policy.

Security policy →

📚

Build from Source

Linux, macOS, and Windows compile guides available.

Build guide →

APT Repository

Linux Package Repository

A signed APT repository is hosted at apt.s3-dev.ovh for Debian and Ubuntu users.

Repository signing key GPG public key for package verification

↓ KEY.gpg

Repository details

Field	Value
Base URL	`https://apt.s3-dev.ovh`
Distribution	`stable`
Component	`main`
Package name	`bambu-studio`
Architecture	`amd64`

One-liner setup

curl -fsSL https://apt.s3-dev.ovh/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/bambustudio.gpg && \
echo "deb [signed-by=/etc/apt/trusted.gpg.d/bambustudio.gpg] https://apt.s3-dev.ovh stable main" \
  | sudo tee /etc/apt/sources.list.d/bambustudio.list && \
sudo apt update && sudo apt install bambu-studio