Send any MakerWorld print profile to your Bambuddy instance in one click, exactly as if you used the built-in Import from MakerWorld feature inside Bambuddy.
- Open Chrome and navigate to
chrome://extensions/ - Enable Developer mode (top-right toggle)
- Click Load unpacked and select this folder
- The Bambuddy icon will appear in your toolbar (pin it via the puzzle-piece menu for easy access)
Click the extension icon and then the gear (⚙) button, or right-click the icon → Options.
Enter the base URL of your Bambuddy instance:
| Setup | Example URL |
|---|---|
| Local network | http://192.168.1.100:8000 |
| Docker on same machine | http://localhost:8000 |
| Reverse-proxied with HTTPS | https://bambuddy.example.com |
Create a dedicated key in Bambuddy:
- Settings → API Keys → Create API Key
- Give it a descriptive name (e.g. Chrome Extension)
- Enable Manage Library — covers saving files and importing from MakerWorld
- Enable Allow cloud access — required for Bambuddy to use your Bambu Cloud token when downloading from MakerWorld
- Make sure a Bambu Cloud account is linked under Settings → Bambu Cloud
- Copy the key (it's shown only once) and paste it into the extension
Click Test Connection to verify everything works before saving. The test runs three checks in order:
GET /health— unauthenticated, confirms the URL is reachableGET /api/v1/system/info— confirms the API key is valid, shows Bambuddy versionGET /api/v1/makerworld/status— best-effort, reports whether the Bambu Cloud token is present
- Browse makerworld.com and open any model page
- Optionally, click the specific print profile you want so the URL includes
#profileId-XXXXX— the extension will pre-select it - Click the Bambuddy icon in the toolbar
- The popup resolves the model and shows all available print profiles
- Select the profile you want (it is pre-selected from the URL if you clicked one)
- Click Send to Bambuddy — the 3MF is downloaded into your Bambuddy library just like a manual import
Profiles already in your library appear with a ✓ and an "Already in library" badge.
The extension uses <all_urls> host permissions so it can reach your Bambuddy instance at any IP/hostname. For a personal self-hosted tool this is fine. If you want to tighten this, edit manifest.json and add your specific Bambuddy URL as a host permission, then handle the chrome.permissions.request flow in options.js.
The key needs Manage Library and Allow cloud access — both are required. If imports return "Downloading files from MakerWorld requires a Bambu Cloud login" even with valid credentials, make sure Allow cloud access is checked on the key.
Bambu Cloud tokens are valid for ~90 days. If imports start failing after a long period, re-authenticate under Settings → Bambu Cloud in Bambuddy to refresh the token.
The popup shows all plates/profiles for a model in the dropdown. Use Bambuddy's built-in Import all plates feature for bulk import; this extension is designed for single-profile one-click imports.
The popup loads the model thumbnail through Bambuddy's own proxy endpoint (/api/v1/makerworld/thumbnail) — your IP is never exposed to MakerWorld's CDN directly (mirrors Bambuddy's own behavior).
├── manifest.json MV3 manifest
├── background.js Service worker — handles all Bambuddy API calls
├── popup.html/js/css Toolbar popup — resolve + import UI
├── options.html/js/css Settings page — URL, API key, test connection
└── icons/ Extension icons (16, 48, 128 px)
| Symptom | Likely cause |
|---|---|
| "Bambuddy not configured" | Open Settings and enter your URL + API key |
| Test connection: "not reachable" | Wrong IP/port, or Bambuddy isn't running. Default port is 8000. |
| Test connection: HTTP 401 | API key is invalid or wasn't saved yet |
| Test connection: HTTP 403 | API key doesn't have the required permissions — check Manage Library and Allow cloud access |
| "Could not resolve model" | Network issue, or the MakerWorld feature isn't enabled on your build |
| "requires a Bambu Cloud login" | API key missing Allow cloud access, or Bambu Cloud token expired |
| Thumbnail doesn't load | Bambuddy's thumbnail proxy may not be available on older builds; the extension falls back to the direct CDN URL |
| Profile list is empty | The model page returned no profiles from the resolve endpoint; try re-opening the popup |