Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

10 stars

Watchers

1 watching

Forks

Repository files navigation

Bambuddy mobile

An unofficial, open-source mobile app (Flutter, Android + Wear OS) for bambuddy — a self-hosted, cloud-free manager for Bambu Lab 3D printers.

This is NOT an official Bambu Lab app and is not affiliated with or endorsed by Bambu Lab. "Bambu Lab" and "Bambu" are trademarks of their respective owner.

It requires your own running bambuddy server. The app does not connect to Bambu Lab cloud on its own — without a server to point it at, it won't work.

The bambuddy server

This app is a companion to the bambuddy server — get and set it up here first:

Distribution

Moved from Codeberg (July 2026). Obtainium installs that still track the old codeberg.org/DoYouHost/bambuddy-mobile releases will not see updates — re-add the app from the GitHub URL above.

Phone and watch share one applicationId (a single Play listing) and differ only by flavor (mobile / wear).

Version codes. A release is (major*10000 + minor*100 + patch) * 20 + 2_000_000, so 0.13.1 → 2026020; the watch APK adds 1_000_000_000 (Play needs a distinct code per APK in one listing). The * 20 opens 19 dev slots under each release: X.Y.Z-dev.N takes code(X.Y.Z) - 20 + N, landing every dev build above the last release and below the one it is heading for. The + 2_000_000 clears the codes published up to 0.13.0 under the earlier * 1000 scheme, which the narrower multiplier would otherwise undercut. N counts the dev builds of that target, so the first one is dev.1; it is read off the existing tags rather than stored anywhere. A dev build never touches pubspec.yaml — the version is passed to flutter build and the release points at the commit.

Demo user

Point the app at the magic demo server and sign in with the credentials below to explore without your own bambuddy server.

Field Value
URL demo
User demo
Password demo1234

Features

Monitor

  • Live printer status: state, progress, layer, ETA and temperatures (WebSocket + REST polling)
  • Persistent print-progress notification via a foreground service, even when the app is in the background
  • Configurable alerts for print events and hardware (HMS) errors

Control

  • Pause, resume and stop prints
  • Clear the plate and start the next job in the queue
  • Manage the queue (reordering, AMS mapping) and slice files via the server's slicer

Filament & hardware

  • Track your spool inventory and assign spools to AMS slots
  • Scan spool QR codes with the camera
  • Smart-plug control and power monitoring
  • Maintenance tracker with reminders

More

  • Print archive and statistics, projects (plates/parts), MakerWorld import
  • Home-screen widget (status + a quick spool-scan shortcut)
  • Wear OS companion: check status and control prints from your watch (relay through the phone + REST fallback)
  • Demo mode (the magic demo server) to explore without your own server

Screenshots

Dashboard Print queue Filament inventory Statistics

Wear OS:

Watch — printing Watch — idle Watch — stop confirmation

More in docs/store-assets/screenshots (phone, 7"/10" tablet, Wear OS).

Privacy

The app talks only to the bambuddy server you configure. There is no analytics, no advertising and no cloud service. Credentials are stored in encrypted, Android Keystore-backed storage (flutter_secure_storage) and are only ever sent to your own server.

Authentication

Three modes, detected automatically (GET /api/v1/auth/status): disabled / username+password (JWT) / API key (X-API-Key). API keys are recommended — they don't expire and are scoped.

Server compatibility

Built and tested against bambuddy with the /api/v1 API. The server API is young and moves fast — newer versions should work but without guarantees; parsing is defensive (unknown fields are ignored, missing ones don't crash the app).

Build

Requires Flutter (stable) and the Android SDK.

flutter pub get
dart run build_runner build --delete-conflicting-outputs
flutter run --flavor mobile                 # phone on a connected device

Release builds and releases go through just (see justfile):

just build            # phone release APK (mobile flavor) -> build/dist/
just build-wear       # watch release APK (wear flavor)   -> build/dist/
just build-aab        # phone Play bundle (Google Play)   -> build/dist/
just build-wear-aab   # watch Play bundle (Google Play)   -> build/dist/
just ship X.Y.Z       # full pipeline: bump + test + build + GitHub release

Tests and lint:

flutter analyze
flutter test

License

AGPL-3.0 — consistent with bambuddy. The app contains no code from other projects; it is architecturally inspired by, among others, Mobileraker and BamPocket.

About

No description, website, or topics provided.

Resources

Contributing

Stars

10 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages