Skip to content

Cloud Profiles

Manage and compare your Bambu Cloud slicer presets directly from Bambuddy.

Looking for Orca Cloud?

Bambuddy also supports syncing profiles from your OrcaSlicer Cloud account — see Orca Cloud Profiles. Both clouds work side by side; you can connect to either, both, or neither.

Cloud Profiles

Overview

Bambu Cloud Profiles lets you:

  • View your cloud slicer presets
  • Compare template differences
  • Manage visibility and organization
  • Track preset versions

Authentication

Connecting to Bambu Cloud

  1. Go to Cloud Profiles page
  2. Click Connect to Bambu Cloud
  3. Enter your Bambu Cloud credentials
  4. Click Login
  5. Complete 2FA verification (see below)

Multi-User Instances

When authentication is enabled, each user has their own independent Bambu Cloud login. Your cloud credentials are stored on your user account — logging in or out does not affect other users. The cloud:auth permission is required to use Cloud Profiles.

Headless / API access

Want to read your cloud presets and filament catalogue from a script or CI pipeline? Create an API key with Allow cloud access enabled — see API Keys → Cloud Access Scope. The key will read on its owner's behalf using your stored Bambu Cloud login; no second sign-in needed.

Two-Factor Authentication (2FA)

Bambuddy supports both types of Bambu Cloud 2FA:

Method Description
Email Verification A 6-digit code is sent to your email
TOTP (Authenticator App) Use your authenticator app (Google Authenticator, Authy, etc.)

The login flow automatically detects which method your account uses:

  • Email: You'll see "Verification code sent to your email"
  • TOTP: You'll see "Enter code from your authenticator app"

TOTP Recommended

If you have an authenticator app set up on your Bambu account, the login will be faster since you don't need to wait for an email.

Access Token Login

If email/password login doesn't work for you, you can log in using a Bambu Cloud access token instead:

  1. Click Use access token instead on the login page
  2. Pick your Region (Global or China) — must match where you registered your Bambu account
  3. Obtain your access token using one of the methods below
  4. Paste it into Bambuddy and click Set Token

China-region accounts must use token login

Bambu Lab China accounts (bambulab.cn) are tied to phone numbers, not email addresses. The email / password flow in Bambuddy's login form is unusable for these accounts — token login is the only path. Select Region: China before pasting the token so Bambuddy validates it against api.bambulab.cn instead of the global endpoint.

How to Obtain an Access Token

The access token is not available in the Bambu Studio UI and Bambu Lab no longer exposes it on their profile page either. The two reliable methods today:

The same token cookie MakerWorld stores in your browser session is the Cloud Access Token. Easiest path:

  1. Open MakerWorld (global) or MakerWorld 中国 (China) in your browser and log in.
  2. Press F12 to open Developer Tools.
  3. Go to Application (Chrome / Edge) or Storage (Firefox) → Cookies → the MakerWorld domain.
  4. Select the row whose name is token.
  5. Copy the Cookie Value from the panel at the bottom.
  6. Paste it into Bambuddy's Access Token field (with the matching Region selected) and click Set Token.

Treat the token like a password

It grants access to your Bambu Cloud account, including print history and MakerWorld actions. Don't paste it into GitHub issues, screenshots, or chat threads. Bambuddy stores it locally on your server only.

Method 2: Python script (Global region only)

Use a library like bambu-lab-cloud-api to handle the login flow — it sends your credentials, prompts for the email verification code, and returns the token. Targets the global api.bambulab.com endpoint only; doesn't work for China-region accounts because those don't accept email login.

Token details

  • The token is typically valid for 3 months, then needs re-issuing the same way.
  • Scripts often save it to a local file (e.g., ~/.bambu_token) for reuse.
  • This is the Cloud Access Token (for the cloud API / MQTT) — do not confuse it with the Printer Access Code (found on the printer screen under Network settings; used for local LAN connections only).

When to use token login

  • You're on a China-region account (required — see note above).
  • Email / 2FA login fails on the global region.
  • Your account uses a third-party SSO provider that Bambuddy can't authenticate against directly.

Credentials Storage

Credentials are stored locally and only used to access your presets.

Connection Status

Status Description
Connected Authenticated and synced
Disconnected Not authenticated
Syncing Fetching latest presets

Viewing Profiles

Profile Types

Type Description
Filament Material settings
Process Print settings
Printer Machine settings

Profile Information

Each profile displays:

  • Name
  • Type (filament/process/printer)
  • Modified date
  • Visibility status
  • Sync status

Comparing Profiles

Compare profiles to understand differences:

Comparing Templates

  1. Select a profile
  2. Click Compare with Template
  3. View differences highlighted

Cloud Profiles Comparison

Diff View

Color Meaning
Green Added/New value
Red Removed/Old value
Orange Changed value

What's Compared

  • Temperature settings
  • Speed settings
  • Retraction settings
  • Cooling settings
  • Support settings
  • And more...

Visibility Control

Template Visibility

Control which presets appear in Bambu Studio:

Status In Bambu Studio
Visible Shows in preset list
Hidden Hidden from list

Changing Visibility

  1. Find the profile
  2. Click the visibility toggle
  3. Changes sync to cloud

Declutter

Hide presets you don't use to keep Bambu Studio organized.

Syncing

Manual Sync

Click Sync to fetch latest presets from cloud.

What Syncs

  • Profile names and settings
  • Visibility status
  • Modified timestamps

Sync Direction

Currently read-only from Bambu Cloud:

  • View presets
  • Compare with templates
  • Edit preset values (use Bambu Studio)

Filtering Profiles

Filter Options

Filter Description
Type Filament, Process, Printer
Visibility Visible, Hidden, All
Search Text search in names

Sorting

Sort profiles by:

  • Name (A-Z, Z-A)
  • Modified date
  • Type

Using Profiles

In Bambu Studio

  1. Open Bambu Studio
  2. Sign in to Bambu Cloud
  3. Access synced profiles
  4. Apply to prints

From Bambuddy

View profiles but don't edit:

  • Reference settings
  • Compare versions
  • Track what you have

Version Tracking

Modified Dates

Each profile shows when it was last modified:

  • Helps track changes
  • Identify recent updates

Template Comparison

Compare your profile to the original template:

  • See what you've customized
  • Identify drift from defaults
  • Reset to template if needed

Troubleshooting

Authentication Failed

  1. Verify credentials are correct
  2. Check internet connection
  3. Ensure Bambu Cloud is accessible
  4. Try logging out and back in
  5. For TOTP: Ensure your device time is synchronized (TOTP codes are time-based)
  6. If all else fails, try the access token method instead (see Access Token Login)

TOTP Code Not Working

  1. Check your device time is accurate (enable automatic time sync)
  2. Make sure you're using the correct account in your authenticator app
  3. Try waiting for a new code (codes expire every 30 seconds)
  4. If persistent, try disabling and re-enabling TOTP on your Bambu account

Profiles Not Showing

  1. Click Sync to refresh
  2. Check filters aren't hiding profiles
  3. Verify cloud account has profiles
  4. Check connection status

Sync Issues

  1. Check network connectivity
  2. Try manual sync
  3. Re-authenticate if needed
  4. Check Bambu Cloud status

Tips

Regular Sync

Sync after making changes in Bambu Studio to keep Bambuddy current.

Compare Before Printing

Compare profiles to understand differences before choosing one.

Organize with Visibility

Hide unused presets to keep your active presets easy to find.

Document Changes

When you modify a profile significantly, note what you changed.