Update StudioBridge to v2.1.1

- Replace StudioBridge JAR: 0.0.1-SNAPSHOT -> 2.1.1 (latest upstream release)
- Update StudioBridge.bat to reference new JAR filename
- Update README: full printer list (A1, A1 Mini, P1P, P1S, P2S, X1, X1C,
  X1E, X2D, H2C, H2C rev2, H2D, H2D Pro, H2S), Orca Slicer support,
  Check Printer feature, CLI arguments, Java 21 requirement
- Add .gitignore excluding portable-dist/jre/ (large binary, not for VCS)
- Bundled JRE upgraded locally to Temurin 21.0.11+10 LTS (not tracked in git)
This commit is contained in:
2026-05-05 09:19:33 +03:00
parent c19892669e
commit 72aed799f7
4 changed files with 90 additions and 56 deletions

2
.gitignore vendored Normal file
View File

@@ -0,0 +1,2 @@
portable-dist/jre/

136
README.md
View File

@@ -1,75 +1,107 @@
# StudioBridge # StudioBridge
With StudioBridge it is possible to make Only LAN 3D printers from Bambu Lab visible in Bambu Studio. > **This portable distribution bundles StudioBridge v2.1.1** — the latest release from [Rdiger-36/StudioBridge](https://github.com/Rdiger-36/StudioBridge).
Unfortunately, Bambu Studio does not offer the possibility to store printers from the network directly, which means that they cannot be used via Bambu Studio from other subnets or from accessible external networks (e.g. via VPN). This is because Bambu Lab adds its printers for Bambu Studio in the network via mDNS/SSDP. However, these services cannot be used across networks as they are not routed.
There are many scripts for all kinds of systems, but many users feel more comfortable with a GUI. Therefore I developed StudioBridge, which is basically based on the scripts i found in countless forums. 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 # How it works
StudioBridge sends a UDP request to Bambu Studio with the printer data (IP address, serial number, printer type, printer name). 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 BambuStudio, making the printer visible. Now the printer can be accessed via the LAN access code in BambuStudio. This means that all the usual functions are available. 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.
With StudioBridge all printers of the Bambulab assortment can be added to Bambu Studio. It is also possible to create and save a profile for each printer. 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"**.
It should work on all platforms with Java.
Successfully tested on: Successfully tested on:
- Windows 10/11 - Windows 10/11 ARM and x86
- Linux Ubuntu 24.04 LTS/24.10 - Linux Ubuntu 25.10 ARM and x86
- MacOS Intel and M-Series - MacOS Intel and M-Series
# Skip update check on startup # Supported Printers (v2.1.1)
To skip the update process, you can simply add the "--noupdate" argument | 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:
```bash ```bash
java -jar ./StudioBridge.jar --noupdate .\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 # Requirements
- min. Java 1.8 - **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.
# Preview # Installing Java and Running the JAR File (Only for using .jar!)
Lightmode
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.
Darkmode **Windows:**
1. Download the latest Java 21 JRE from [Adoptium](https://adoptium.net/temurin/releases/?version=21).
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](https://adoptium.net).
2. Open the downloaded `.pkg` and follow the instructions.
3. Verify in "System Preferences > Java".
# Demo **Linux:**
1. Install via your package manager: `sudo apt install openjdk-21-jre` (Debian/Ubuntu) or equivalent.
2. Verify with `java -version`.
# Installing Java and Running the JAR File **Running the GUI:**
1. Download `StudioBridge-2.1.1.jar` from the [GitHub releases page](https://github.com/Rdiger-36/StudioBridge/releases/tag/v.2.1.1).
StudioBridge 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, as well as for launching the StudioBridge GUI. 2. Double-click the `.jar` to launch, or run: `java -jar StudioBridge-2.1.1.jar`
Java Installation
Windows:
1. Visit the official Java website and download the latest Java Runtime Environment (JRE) for Windows.
2. Run the downloaded installer file and follow the on-screen instructions to complete the installation.
3. To confirm that Java is installed, you can search for “Java” in the Start menu. You should see options like “Java Control Panel” if installation was successful.
macOS:
1. Visit the official Java website and download the latest Java Runtime Environment (JRE) for macOS.
2. Open the downloaded .dmg file and follow the instructions to install Java by dragging it into the Applications folder.
3. After installation, open “System Preferences,” then “Java” to verify Java is installed and configured correctly.
Linux:
1. Most Linux distributions offer Java in their software repositories. Open the Software Center or Package Manager for your distribution and search for “OpenJDK” or “Java Runtime Environment.”
2. Select the version you need (Java 8 or later) and install it.
3. You can check if Java is installed by searching for it in the applications menu or checking for “Java” in system settings.
Running the StudioBridge GUI
1. Download the StudioBridge.jar file from the GitHub releases page.
2. Locate the StudioBridge.jar file in your Downloads or specified folder.
3. Double-click the .jar file to launch StudioBridge. This should open the GUI, allowing you to configure and use your 3D printers with Bambu Studio over LAN.
If the .jar file does not open directly, ensure Java is properly installed, and check your systems default settings for opening .jar files.
# FAQ # FAQ
Q: My Printer does not connect to Bambu Studio (Error Code -1) **Q: My app won't start on macOS (app is corrupted error)**
A: You have to Check if your Printer Informations are right. If thats true and it worked in othter version, then try to disable/enable Only-LAN-Mode. It also could help to diconnetd your printer from the cloud an d reconnect it ([Issue-12](https://github.com/Rdiger-36/StudioBridge/issues/12)) A: This is macOS Gatekeeper. Disable the quarantine flag with:
```bash
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](https://github.com/Rdiger-36/StudioBridge/issues/12)).
--- ---
@@ -77,7 +109,7 @@ A: You have to Check if your Printer Informations are right. If thats true and i
To make StudioBridge even easier to use, a portable launcher solution is included: 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 has been enhanced to minimize the Command Prompt window when starting, so it does not distract the user. - **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:** - **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. - 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. - This makes the launcher less intrusive and more user-friendly, especially for portable or desktop use.

View File

@@ -1,3 +1,3 @@
@echo off @echo off
set "JAVA_HOME=%~dp0jre" set "JAVA_HOME=%~dp0jre"
"%JAVA_HOME%\bin\java.exe" -jar "%~dp0StudioBridge-0.0.1-SNAPSHOT.jar" %* "%JAVA_HOME%\bin\java.exe" -jar "%~dp0StudioBridge-2.1.1.jar" %*