Notifications¶

Get notified about print events via WhatsApp, Telegram, Discord, Email, Home Assistant, and more.

Supported Providers¶

Adding a Provider¶

1. Go to Settings > Notifications
2. Click Add Provider
3. Select provider type
4. Enter configuration
5. Click Send Test to verify
6. Configure event triggers
7. Click Add

Provider Setup Guides¶

ntfy (Easiest)¶

Simple topic-based notifications - no account needed!

1. Choose a unique topic name (e.g., my-printer-xyz123)

2. Subscribe on your phone:

3. Install ntfy app (Android / iOS)

4. Subscribe to your topic

5. In Bambuddy, enter:

WhatsApp (CallMeBot)¶

Free WhatsApp notifications:

1. Add CallMeBot to contacts: +34 644 51 95 23

2. Send via WhatsApp: I allow callmebot to send me messages

3. You'll receive an API key

4. In Bambuddy, enter:

Discord¶

Via channel webhooks:

1. In Discord, go to channel settings
2. Navigate to Integrations > Webhooks
3. Click New Webhook
4. Customize name/avatar
5. Click Copy Webhook URL
6. In Bambuddy, paste the URL

Pushover¶

Professional push notification service:

1. Create account at pushover.net
2. Install Pushover app on your device
3. Create an Application in dashboard
4. In Bambuddy, enter:

Telegram¶

Via Telegram Bot:

1. Message @BotFather
2. Send /newbot and follow prompts
3. Save the Bot Token
4. Message @userinfobot to get your Chat ID
5. In Bambuddy, enter:

Email (SMTP)¶

Send via email:

Gmail Setup¶

1. Enable 2-Factor Authentication
2. Generate an App Password
3. Use: smtp.gmail.com, Port 587, STARTTLS

Home Assistant¶

Zero-config notifications if Home Assistant is already connected:

1. Ensure HA is configured in Settings > Network > Home Assistant
2. Add a notification provider and select Home Assistant
3. No additional fields needed — click Send Test to verify

Notifications appear as persistent notifications in your HA dashboard.

Webhook (Custom)¶

For custom integrations:

Payload format:

{
  "event": "print_complete",
  "printer": "Workshop X1C",
  "filename": "benchy.3mf",
  "duration": "2h 15m",
  "filament_grams": "15.2",
  "filament_details": "PLA: 15.2g",
  "timestamp": "2024-01-15T14:30:00Z"
}

For failed/stopped prints, additional fields are included:

{
  "event": "print_failed",
  "printer": "Workshop X1C",
  "filename": "benchy.3mf",
  "duration": "0h 45m",
  "filament_grams": "7.6",
  "filament_details": "PLA: 7.6g",
  "progress": "50",
  "reason": "Filament runout",
  "timestamp": "2024-01-15T15:15:00Z"
}

When a camera snapshot is available (e.g. First Layer Complete, Print Started, Print Completed), the payload includes a base64-encoded JPEG image:

{
  "title": "First Layer Complete",
  "message": "Workshop X1C: benchy.3mf\nLayer 1/200 done",
  "timestamp": "2024-01-15T14:30:00Z",
  "source": "Bambuddy",
  "image": "/9j/4AAQSkZJRg..."
}

Event Triggers¶

Print Events¶

Printer Events¶

AMS Events¶

Print Queue Events¶

Enable/disable each event per provider.

Quiet Hours¶

Suppress notifications during sleep:

1. Enable Quiet Hours toggle
2. Set Start Time (e.g., 22:00)
3. Set End Time (e.g., 07:00)

Notifications during quiet hours are silently skipped.

Per-Printer Filtering¶

Limit notifications to specific printers:

1. Open provider settings
2. Find Printers section
3. Select specific printers or "All"

Only events from selected printers trigger notifications.

Daily Digest¶

Batch notifications into a summary:

1. Enable Daily Digest toggle
2. Set Digest Time (e.g., 08:00)

How It Works¶

• Events are collected (not sent immediately)
• At digest time, one summary is sent
• Includes counts and details

Example Digest¶

Daily Print Summary (Dec 14)

✅ 3 prints completed
❌ 1 print failed
⏱️ Total time: 8h 45m
🧵 Filament used: 245g

Details:
- Benchy (2h 15m) ✅
- Phone Stand (45m) ✅
- Cable Clip (15m) ✅
- Prototype v3 (3h 30m) ❌

Message Templates¶

Customize notification messages:

Accessing Templates¶

1. Go to Settings > Notifications
2. Click Templates tab
3. Select event type to edit

Variables¶

Insert dynamic content with {variable}:

Print Events:

• {printer} - Printer name
• {filename} - Print filename
• {duration} - Print time
• {filament_grams} - Total filament used in grams (scaled by progress for failed/stopped prints)
• {filament_details} - Per-filament breakdown (e.g., "PLA: 15.2g" or "PLA: 10.0g | PETG: 5.0g")
• {estimated_time} - Estimated duration (e.g., "1h 23m")
• {eta} - Wall-clock completion time (e.g., "15:53" or "3:53 PM"), respects your time format setting
• {progress} - Completion percentage (available for failed/stopped prints)
• {reason} - Failure reason
• {finish_photo_url} - Camera snapshot URL (print_complete, print_failed, print_stopped)

Printer Events:

• {printer} - Printer name
• {error_type} - HMS error type
• {error_detail} - Error description

First Layer Complete:

• {printer} - Printer name
• {filename} - Print filename
• {total_layers} - Total layer count

Bed Cooled:

• {printer} - Printer name
• {bed_temp} - Current bed temperature
• {threshold} - Configured threshold
• {filename} - Print filename

Missing Spool Assignment:

• {printer} - Printer name
• {missing_slots} - Comma-separated slot labels (e.g., "A1, A3")
• {missing_slot_details} - Per-slot breakdown with expected profile (e.g., "- A1: PLA Basic")

AMS Events:

• {printer} - Printer name
• {slot} - AMS slot
• {remaining_percent} - Filament left
• {humidity} - Humidity level

Common:

• {timestamp} - Event time
• {app_name} - "Bambuddy"

Reset to Default¶

Click reset to restore original template.

Finish Photo URL¶

Include a camera snapshot in notifications when prints complete:

1. Go to Settings > Network
2. Set External URL to your Bambuddy server's address (e.g., http://192.168.1.100:8000)
3. Edit your template to include {finish_photo_url}

Example template:

Print completed!
Printer: {printer}
File: {filename}
Filament: {filament_details}
Photo: {finish_photo_url}

Testing¶

Always test before relying on notifications:

1. Configure provider
2. Click Send Test
3. Verify you receive the message
4. Check message formatting

Quick Disable¶

Quickly disable all notifications:

1. Find the Quick Disable button
2. Click to toggle all notifications off
3. Click again to re-enable

Useful during maintenance or troubleshooting.

Tips¶

:material-account-bell: Per-User Email Notifications¶

When Advanced Authentication is enabled, individual users can receive email notifications for their own print jobs. This is separate from the provider-based notification system above — it sends emails directly to the user who submitted the print.

Requirements¶

• Advanced Authentication must be enabled
• SMTP must be configured
• "User Notifications" must be enabled in Settings → Notifications
• User must have an email address on their account
• User must have the notifications:user_email permission (Administrators and Operators by default)

Supported Events¶

Setup¶

1. Enable User Notifications in Settings → Notifications
2. Click Notifications in the sidebar
3. Toggle each event type on or off
4. Click Save

See Authentication → Per-User Email Notifications for full details.