maziggy/bambuddy

당신의 프린터. 클라우드 없음. 당신의 규칙.

Bambu Lab을 위한 셀프 호스팅 (Self-hosted) 커맨드 센터 — 단 한 대의 A1부터 40대의 프린터 팜 (printer farm)까지.

🎮 라이브 데모 체험하기 •
기능 (Features) •
스크린샷 (Screenshots) •
빠른 시작 (Quick Start) •
문서 (Documentation) •
포럼 (Forum) •
Discord •
기여하기 (Contributing)

약 10초 만에 자신만의 프라이빗 Bambuddy를 실행하세요 — 설치도, 가입도 필요 없는 30분 세션.

"Bambuddy는 Bambu Lab이 첫날부터 만들었어야 했던 컴패니언 앱 (companion app)입니다."
— Adam Conway, XDA-Developers

두 곳의 주요 3D 프린팅 전문 매체는 Bambuddy의 기능 세트가 이미 Bambu 자체 클라우드를 능가한다고 독립적으로 결론지었습니다:

"기능들이 Bambu Lab 자체 클라우드에서 제공하는 것들을 능가하는 것으로 보입니다." — Fabbaloo

"기능 목록이 매우 광범위하여 Bambu Lab이 자체 클라우드에서 제공하는 범위를 넘어선 것으로 보입니다." — 3Druck.com

📄 모든 언론 보도 보기 →

📣 기여자 모집 — Bambuddy를 함께 만들어가세요

Bambuddy는 커뮤니티 주도 프로젝트이며, 저는 적극적으로 기여자를 찾고 있습니다 — 특히 제가 혼자서 감당할 수 없는 두 가지 분야에서 필요합니다:

• 📝
  문서 작성자 (Documentation writers) — 새로운 사용자들이 원활하게 온보딩 (onboarding)할 수 있도록 위키 (wiki), 가이드, 기능 문서를 개선하는 것을 도와주세요.
• ⚙️
  Discourse 관리자 (Discourse admin) — 우리의 Discourse 포럼이 현재 forum.bambuddy.cool에서 운영 중이지만, 여전히 구성, 테마 설정 및 튜닝(카테고리, 권한, SSO, 이메일, 플러그인, 백업)이 필요합니다. Discourse를 잘 알거나 깊이 파고들고 싶다면 여러분의 도움이 절실합니다.
• 💬
  포럼 중재자 (Forum moderators) — 새로운 구성원을 환영하고, 질문에 답하며, 새로운 포럼에서 건강한 토론이 유지되도록 도와주세요.

문서 작성이나 중재자 역할을 수행하기 위해 개발자일 필요는 없습니다. 글쓰기를 즐기거나, 다른 사람을 돕거나, 커뮤니티를 친근하게 유지하는 것을 좋아한다면 당신이 바로 우리가 찾고 있는 사람입니다.

연락처:

🌐 신규: 프록시 모드 (Proxy Mode)를 통한 원격 프린팅

전 세계 어디에서나 프린팅하세요 — Bambuddy의 새로운 프록시 모드 (Proxy Mode)는 슬라이서 (slicer)와 프린터 사이에서 보안 릴레이 (secure relay) 역할을 수행합니다:

• 🔒
  종단간 TLS 암호화 (End-to-end TLS encryption) — FTP, 파일 전송 및 카메라는 프린터의 실제 TLS 인증서를 통해 투명하게 프록시(proxied)됩니다.
• 🛡️
  선택적 Tailscale 통합 (Optional Tailscale integration) — 개별 VP 토글 + Docker 소켓 마운트를 통해 호스트의 Tailscale IP를 VP 카드에 노출하므로, tailnet을 통해 접근 가능한 가상 프린터를 원할 때(설정) 슬라이서(slicer)에 붙여넣을 100.x.x.x 주소를 알 수 있습니다. 슬라이서 측에서는 Bambuddy의 자체 서명된 CA(self-signed CA) 임포트가 여전히 필요합니다. Bambu Studio / OrcaSlicer의 printer-MQTT 신뢰 경로는 시스템 신뢰 저장소가 아닌 번들된 BBL CA를 사용하므로, 공개적으로 신뢰받는 인증서라도 도움이 되지 않습니다. Tailscale의 역할은 프라이빗 터널(어디서든 접근 가능, 포트 포워딩 불필요)을 제공하는 것이지, 인증서 임포트 과정을 없애는 것이 아닙니다.
• 🌍
  클라우드 의존성 없음 (No cloud dependency) — 자체 Bambuddy 서버를 통한 직접 연결
• 🔑
  프린터 액세스 코드 사용 (Uses printer's access code) — 추가 자격 증명 불필요
• ⚡
  풀스피드 프린팅 (Full-speed printing) — 투명한 TCP 프록시를 사용하며, IP 재작성(IP rewriting)을 위해 MQTT만 복호화됩니다.

원격 프린트 팜(print farms), 이동 중인 메이커(makers), 또는 직장에서 집의 프린터에 접속하려는 사용자에게 완벽합니다.

👉 설정 가이드 (Setup Guide) →

🍰 신규: 통합 슬라이싱 (Integrated Slicing) — 슬라이싱과 프린팅을 한 곳에서

데스크톱 슬라이서가 필요하지 않습니다. STL 또는 3MF 파일을 Bambuddy의 파일 관리자(File Manager)에 드롭하고, **슬라이스(Slice)**를 누르면 결과물이 동일한 폴더에 즉시 출력 가능한 .gcode.3mf 파일로 저장됩니다 — Bambu Studio나 Orca Slicer를 열 필요 없이 말이죠.

• 🍰
  원클릭 슬라이싱 (One-click slicing) — 모든 브라우저에서 슬라이싱 가능합니다. 작업은 작은 사이드카 컨테이너(sidecar container)에서 서버 측(server-side)으로 실행되며, 진행 상황은 토스트(toast) 알림으로 스트리밍되고, 완료되면 슬라이싱된 파일이 라이브러리에 나타납니다.
• 📱
  폰이나 태블릿에서 슬라이싱 (Slice from your phone or tablet) — Bambuddy의 PWA와 새로운 서버 측 슬라이서 덕분에, 모바일에서 STL을 드롭하고 데스크톱을 전혀 사용하지 않고도 프린팅 대기열에 추가할 수 있습니다.
• 🎒
  자신만의 프로필 가져오기 (Bring your own profiles) — Printer Preset Bundle을 임포트하세요 (.bbscfg

) Bambu Studio에서 내보낸 것): 슬라이스 (Slice) 대화 상자의 드롭다운에서 큐레이션된 프린터 + 프로세스 + 필라멘트 (printer + process + filament) 조합을 선택하세요. 더 이상 JSON 파일을 번거롭게 다룰 필요가 없습니다.

• 🔁
  Bambuddy의 나머지 기능과 동일한 디스패치 (dispatch) — 슬라이싱된 결과물이 기존의 큐 (queue) / 플레이트 선택기 (plate-picker) / AMS 매핑 경로로 흐르므로, 모든 일반적인 편의 기능 (멀티 프린터 디스패치, AMS 라우팅, 예약 출력)이 그대로 작동합니다.

선택 사항이지만 권장됨 — slicer-api/를 제거하세요.

Bambuddy 설치 경로 옆에 스택 (stack)을 구성하면 모든 곳에서 슬라이스 (Slice) 버튼이 활성화됩니다.

👉 슬라이서 통합 가이드 (Slicer Integration Guide) →

데이터 소유권 보장 — 모든 출력 이력은 로컬에 저장되며, 클라우드 의존성이 없습니다.
오프라인 작동 — 로컬 네트워크를 통한 직접적인 프린터 제어를 위해 개발자 모드 (Developer Mode)를 사용합니다.
완전 자동화 — 출력 예약, 자동 전원 종료, 완료 시 알림 수신.
멀티 프린터 지원 — 하나의 인터페이스에서 전체 프린트 팜 (print farm)을 관리합니다.

• 메타데이터를 포함한 자동 3MF 아카이빙

• 3D 모델 미리보기 (Three.js)

• 중복 감지 및 전체 텍스트 검색

• 사진 첨부 및 실패 분석

• 타임랩스 에디터 (트리밍, 속도, 음악) 및 P1 시리즈 프린터를 위한 자동 AVI-to-MP4 변환, 수동 업로드 및 제거 기능

• AMS 매핑을 통한 연결된 모든 프린터로 재출력 (자동 매칭 또는 수동 슬롯 선택, 멀티 플레이트 지원, 듀얼 노즐 H2D/H2D Pro를 위한 노즐 인식 매칭,
  필라멘트 트랙 스위치 (Filament Track Switch, FTS) 지원 — FTS 액세서리가 설치된 경우, FTS가 모든 AMS 슬롯을 익스트루더 (extruder)로 라우팅하므로 노즐별 필터가 억제됩니다)

• 멀티 플레이트 아카이브를 위한 플레이트 썸네일 브라우징 (마우스를 올려 플레이트 간 이동)

• 아카이브 비교 (사이드 바이 사이드 차이점 확인)

• 태그 관리 (모든 아카이브에 걸쳐 이름 변경/삭제)
  출력 로그 (Print Log) — 날짜/시간, 출력 이름, 프린터, 사용자, 상태, 소요 시간 및 필라멘트 열을 포함한 모든 출력 활동의 연대순 테이블 보기. 검색, 프린터, 사용자, 상태 및 날짜 범위로 필터링 가능. 구성 가능한 페이지 크기를 가진 페이지네이션 (Pagination). '지우기' 버튼은 아카이브에 영향을 주지 않고 로그 항목을 제거합니다.

• WebSocket을 통한 실시간 프린터 상태 확인

• 라이브 카메라 스트리밍 (MJPEG) 및 스냅샷과 멀티 뷰어 (multi-viewer) 지원 — 대부분의 Bambu 프린터는 하나의 업스트림 (upstream) 연결만 허용하므로, Bambuddy는 단일 공유 스트림을 모든 브라우저 탭 / 카드 / 오버레이로 팬아웃 (fan out) 합니다.
  Home Assistant / Frigate / 키오스크를 위한 장기 유지 카메라 토큰 (Long-lived camera tokens) — Settings → API Keys에서 토큰을 생성하고 한 번만 붙여넣으면 되며, 최대 365일로 제한되고 언제든 취소 가능합니다 (무한 토큰은 지원하지 않음 — 유출된 영구 토큰은 설계상 안전하지 않기 때문입니다).
  OBS용 스트리밍 오버레이 (Streaming overlay for OBS) - 라이브 스트리밍을 위한 카메라 + 상태 정보가 포함된 임베드 가능한 페이지 (/overlay/:printerId), 설정 가능한 FPS (?fps=30), 상태 전용 모드 (?camera=false)

• 외부 카메라 지원 (MJPEG, RTSP, HTTP 스냅샷, USB/V4L2) 및 레이어 기반 타임랩스 (timelapse)
  빌드 플레이트 (Build plate) 비어 있음 감지 - 플레이트에서 물체가 감지되면 출력 자동 일시 중지 (다중 참조 보정, ROI 조정)

• 팬 (Fan) 상태 모니터링 (부품 냉각 팬, 보조 팬, 챔버 팬)

• 프린터 제어 (중지, 일시 중지, 재개, 챔버 조명, 출력 속도, P2S/H2를 위한 에어덕트 (airduct) 모드, Studio 스타일의 홈 위치 미설정 (not-homed) 경고가 포함된 빌드 플레이트 Z-조그 (build-plate Z-jog))
  프린터 카드 상의 상태 배지 (Status badges): SD 카드 (녹색 / 적색), 인클로저 도어 (녹색 / 황색 — X1/P1S/P2S/H2), 에어덕트 모드 (냉각 / 가열)
  강제 새로고침 (Force Refresh) 메뉴 항목 — 재연결 없이 프린터로부터 전체 상태 푸시 (push) 요청

• 일괄 프린터 작업 (여러 카드 선택 후 모두 중지/일시 중지/재개/지우기 — 상태 또는 위치별 선택 가능)

• 프린터 검색 및 필터 — 이름/모델/위치/시리얼을 통한 실시간 검색 및 상태와 위치 드롭다운 필터 (WebSocket 반응형, 모바일 친화적)

• 크기 조절 가능한 프린터 카드 (S/M/L/XL)

• 출력 중 물체 건너뛰기 (Skip objects)

• AMS 슬롯 RFID 재읽기
  프린터 카드에서 AMS 슬롯 로드 / 언로드 (Load / Unload) — 모든 AMS 슬롯 또는 외부 스풀에 마우스를 올리고 메뉴 버튼을 클릭하면, 터치스크린으로 이동하지 않고도 해당 트레이를 로드하거나 현재 로드된 트레이를 언로드할 수 있습니다; 듀얼 압출기 H2D (Ext-L / Ext-R이 각자의 노즐을 구동)를 지원합니다.

• AMS 슬롯 설정 (모델 필터링된 프리셋, K 프로필, 컬러 피커, 설정된 슬롯에 대한 사전 채우기)

• AMS 정보 카드 (호버 시 시리얼 번호, 펌웨어 버전 표시) 및 프린터 간에 유지되는 사용자 정의 친화적 이름 지원
  AMS 원격 건조 (AMS remote drying) — AMS 2 Pro 및 AMS-HT를 위해 프린터 페이지에서 직접 건조 세션을 시작, 모니터링 및 중지할 수 있으며, 필라멘트 기반의 온도/시간 프리셋 및 선택적 스풀 회전을 지원합니다. 또한 자동 PSU 감지 및 HMS 전원 오류 보고 기능을 제공합니다.
  큐 자동 건조 (Queue auto-drying) — 습도가 임계값을 초과할 경우 예정된 출력 사이에 필라멘트를 자동으로 건조합니다. 필라멘트 유형별로 설정 가능한 프리셋과 선택적인 차단 모드(blocking mode)를 지원합니다.
  주변 건조 (Ambient drying) — 출력 대기열 여부와 관계없이, 유휴 상태(idle)인 프린터에서 습도에 따라 필라멘트를 자동으로 건조한 상태로 유지합니다.

• 필라멘트 유형별 설정 가능한 건조 프리셋 (AMS 2 Pro 및 AMS-HT를 위한 온도 및 시간)

• H2D를 위한 듀얼 외부 스풀 지원 (Ext-L / Ext-R)

• 이력 관리 및 오류 삭제 기능이 포함된 HMS 오류 모니터링

• 출력 성공률 및 트렌드

• 필라멘트 사용량 추적

• 비용 분석 및 실패 분석
  AI 출력 실패 감지 (AI print-failure detection) — 자체 호스팅되는 Obico ML API와의 선택적 통합을 지원합니다. 실행 중인 각 출력의 카메라 피드를 감시하고, 시간에 따라 점수를 부드럽게 처리하며(30프레임 워밍업 + EWM + 이동 평균), 출력당 한 번씩 설정된 동작(알림 / 일시 정지 / 일시 정지 후 전원 끄기)을 실행합니다.

• 사용자별 통계 필터링 (관리자 권한으로 제한)

• CSV/Excel 내보내기

⏰ 스케줄링 및 자동화 (Scheduling & Automation)

백그라운드 출력 명령 (Background print dispatch) — FTP 업로드 및 출력 시작 명령이 백그라운드에서 실행되며, 실시간 WebSocket 진행 상황 토스트 알림(작업별 업로드 바, 상태 배지, 취소 버튼)을 제공합니다.

• 드래그 앤 드롭 및 타임라인 스케줄 뷰를 지원하는 출력 대기열

• 멀티 프린터 선택 (여러 프린터로 동시에 전송)

• 배치 출력 수량 (여러 개 복사 출력 — 출력/스케줄 대화 상자에서 수량 설정, 첫 번째 복사본은 즉시 출력되고 나머지는 대기열에 추가됨)

• 시차를 둔 배치 시작 (Staggered batch start) (전력 급증을 방지하기 위해 설정 가능한 간격으로 프린터를 그룹별로 시작 — Print 및 Queue 대화 상자 모두에서 작동)

• 설정 가능한 기본 출력 옵션 (Configurable default print options) (Settings → Workflow에서 베드 레벨링 (bed levelling), 유량/진동 보정 (flow/vibration calibration), 첫 번째 레이어 검사 (first layer inspection), 타임랩스 (timelapse) 설정 가능)

• 모델 기반 대기열 할당 (Model-based queue assignment) (부하 분산을 위해 "any X1C"로 전송) 및 위치 필터링 포함

• 모델 기반 대기열을 위한 필라멘트 오버라이드 (Filament override for model-based queue) (스케줄링 전 필라멘트 색상/유형 교체)

• 필라멘트 검증 (Filament validation) (필요한 필라멘트가 있는 프린터에만 할당)

• 잔량 적은 필라멘트 우선 사용 (Prefer lowest remaining filament) (여러 개가 일치할 경우 부분적인 스풀을 먼저 소모)

• 프린터별 AMS 매핑 (Per-printer AMS mapping) (프린트 팜 (print farms)을 위한 개별 슬롯 구성)

• 예약 출력 (Scheduled prints) (날짜/시간)

• 최단 작업 우선 스케줄링 (Shortest Job First scheduling) (SJF) (Queue 페이지의 SJF 토글 — 스케줄러가 더 짧은 출력을 먼저 선택하며, 기아 현상 방지 (starvation guard) 기능 포함)

• 대기열 전용 모드 (Queue Only mode) (자동 시작 없이 스테이징)

• 대기열 출력 간 플레이트 비움 확인 (Clear plate confirmation between queued prints) (팜 워크플로우를 위해 설정에서 비활성화 가능)

• 자동 출력 G-code 주입 (Auto-print G-code injection) (Farmloop, SwapMod, AutoClear, Printflow 3D를 위한 모델별 시작/종료 스니펫 — 대기열 항목별로 토글 가능)

• 스마트 플러그 통합 (Smart plug integration) (Tasmota, Home Assistant, MQTT, REST/Webhook)

• REST 스마트 플러그: HTTP API를 통해 모든 장치 제어 (openHAB, ioBroker, FHEM, Node-RED) (별도의 전력/에너지 URL 및 단위 승수 사용)