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"
}

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

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¶