Bambu_lab/README.md

StudioBridge

This portable distribution bundles StudioBridge v2.1.1 — the latest release from Rdiger-36/StudioBridge.

With StudioBridge it is possible to make Bambu Lab 3D Printers visible in Bambu Studio or Orca Slicer, that cannot be automatically added by them. It is also possible to connect printers from other subnets or from accessible external networks (e.g. via VPN) or in your normal home network. There are many scripts for all kinds of systems, but many users feel more comfortable with a GUI. Therefore StudioBridge was developed, which is basically based on the scripts found in countless forums.

How it works

StudioBridge sends a UDP request to your Slicer (Bambu Studio or Orca Slicer) with the printer data (IP address, serial number, printer type, printer name). Once all the data has been entered, it can be sent to your Slicer, making the printer visible. Now the printer can be accessed via the LAN access code. This means that all the usual functions are available.

This programme has nothing to do with Bambu Connect and it also does not replace it. It is only for the connection in your Slicer.

With StudioBridge all printers of the Bambu Lab assortment can be added. It is also possible to create and save a profile for each printer.

You have the option to send the package via broadcast or directly to Bambu Studio.

You can check if the printer would connect correctly in Bambu Studio with the function "Check Printer".

Successfully tested on:

• Windows 10/11 ARM and x86
• Linux Ubuntu 25.10 ARM and x86
• MacOS Intel and M-Series

Supported Printers (v2.1.1)

Display Name	Model Code
A1	N2S
A1 Mini	N1
P1P	C11
P1S	C12
P2S	N7
X1	3DPrinter-X1
X1C	3DPrinter-X1-Carbon
X1E	C13
X2D	N6
H2C	O1C
H2C (new revision)	O1C2
H2D	O1D
H2D Pro	O1E
H2S	O1S

Arguments

For the portable .jar version on Windows, use the bundled launcher:

.\StudioBridge.bat [OPTIONS]

Starting options:
  --noupdate             Skip search for latest updates on startup
  --sendonly             Start with no GUI, only send data from all printers to Bambu Studio
  --direct               Send UDP package directly to Bambu Studio, not over broadcast
  --help                 Show help for StudioBridge

Profile options:
  --customProfilesDir='/path/to/profiles/'
      Set custom profiles directory (Default: ~/.studio-bridge/Profiles)
  --selectedPrinters='/path/to/profile.sbp/','/path/to/other/profile2.sbp/'
      Set profiles to use (single and multi profiles comma-separated)

Example:
  .\StudioBridge.bat --sendonly --noupdate --direct
  .\StudioBridge.bat --sendonly --customProfilesDir='C:\Users\YourName\Documents\Profiles'
  .\StudioBridge.bat --sendonly --selectedPrinters='C:\Profiles\My P1S.sbp','C:\Profiles\H2D-Pro.sbp'

Requirements

• min. Java 21 (required for the .jar release)
• The bundled JRE in portable-dist/jre is Temurin 21.0.11+10 (OpenJDK 21 LTS) — no separate Java installation needed for the portable launcher.

Installing Java and Running the JAR File (Only for using .jar!)

StudioBridge.jar is built in Java, so a Java Runtime Environment (JRE) is required to run the program. Below are simple instructions for installing Java on Windows, macOS, and Linux.

Windows:

1. Download the latest Java 21 JRE from Adoptium.
2. Run the installer and follow the on-screen instructions.
3. Verify with java -version in a terminal.

macOS:

1. Download the latest Java 21 JRE for macOS from Adoptium.
2. Open the downloaded .pkg and follow the instructions.
3. Verify in "System Preferences > Java".

Linux:

1. Install via your package manager: sudo apt install openjdk-21-jre (Debian/Ubuntu) or equivalent.
2. Verify with java -version.

Running the GUI:

1. Download StudioBridge-2.1.1.jar from the GitHub releases page.
2. Double-click the .jar to launch, or run: java -jar StudioBridge-2.1.1.jar

FAQ

Q: My app won't start on macOS (app is corrupted error) A: This is macOS Gatekeeper. Disable the quarantine flag with:

xattr -dr com.apple.quarantine /Applications/StudioBridge.app

Q: My Printer does not connect to Bambu Studio (Error Code -1) A: Check that all printer information (IP, serial number, model) is correct. Try disabling/enabling Only-LAN-Mode. You can also try disconnecting the printer from the cloud and reconnecting it (Issue #12).

---

Portable Launcher for StudioBridge

To make StudioBridge even easier to use, a portable launcher solution is included:

• Launch-StudioBridge.bat: This batch file automatically locates and launches StudioBridge in the correct environment. It relaunches itself minimized so it does not distract the user.
• How it works:
  • When you run Launch-StudioBridge.bat, it checks if it is already minimized. If not, it relaunches itself in a minimized window and then starts StudioBridge.
  • This makes the launcher less intrusive and more user-friendly, especially for portable or desktop use.
• No additional tools required: This solution works out-of-the-box on Windows without needing VBS scripts or third-party utilities.

You can find and use the launcher in the project root directory. For best results, run the batch file directly or create a shortcut to it.

---