Notifications¶

Get notified about print events via WhatsApp, Telegram, Discord, Email, 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

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
• {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

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¶