Push Notifications

Get notified about print events via multiple channels including WhatsApp, Telegram, Discord, Email, and more.

Supported Providers

Provider	Description	Setup Complexity
WhatsApp	Via CallMeBot service	Easy
ntfy	Self-hosted or ntfy.sh	Very Easy
Pushover	Dedicated push service	Easy
Telegram	Via Telegram Bot	Medium
Email	SMTP email	Medium
Discord	Channel webhooks	Easy
Webhook	Generic HTTP POST	Flexible

Adding a Notification Provider

Go to Settings > Notifications
Click Add Provider
Select provider type
Enter required configuration
Click Send Test to verify
Configure event triggers
Click Add

Provider Setup Guides

WhatsApp (CallMeBot)

Free WhatsApp notifications via CallMeBot:

Add CallMeBot to contacts: +34 644 51 95 23
Send via WhatsApp: I allow callmebot to send me messages
You'll receive an API key
In Bambuddy, enter:
- Phone Number: Your number with country code (e.g., +1234567890)
- API Key: The key from CallMeBot

ntfy

Simple topic-based notifications:

Choose a unique topic name (e.g., my-printer-xyz123)
Subscribe on your phone:
- Install ntfy app (Android / iOS)
- Subscribe to your topic
In Bambuddy, enter:
- Topic: Your chosen topic name
- Server: https://ntfy.sh (default) or your self-hosted server

No account needed for ntfy.sh public server!

Pushover

Professional push notification service:

Create account at pushover.net
Install Pushover app on your device
Create an Application in Pushover dashboard
In Bambuddy, enter:
- User Key: From your Pushover account
- API Token: From your Application

Via Telegram Bot:

Message @BotFather on Telegram
Send /newbot and follow prompts
Save the Bot Token provided
Message @userinfobot to get your Chat ID
In Bambuddy, enter:
- Bot Token: From BotFather
- Chat ID: Your user or group chat ID

For group notifications, add the bot to the group and use the group's chat ID.

Email (SMTP)

Send notifications via email:

Gather your SMTP server details
In Bambuddy, enter:
- SMTP Server: e.g., smtp.gmail.com
- Port: 587 (STARTTLS), 465 (SSL), or 25 (None)
- Security: STARTTLS, SSL, or None
- Username: Your email address
- Password: Your password or app password
- From Address: Sender email
- To Address: Recipient email

Gmail Setup

Enable 2-Factor Authentication on your Google account
Generate an App Password
Use the app password (not your regular password)
Server: smtp.gmail.com, Port: 587, Security: STARTTLS

Discord

Via channel webhooks:

In Discord, go to channel settings
Navigate to Integrations > Webhooks
Click New Webhook
Customize name/avatar if desired
Click Copy Webhook URL
In Bambuddy, paste the Webhook URL

Webhook (Generic)

For custom integrations (Home Assistant, IFTTT, etc.):

Enter your webhook URL
Optionally add custom headers (e.g., Authorization)

Bambuddy sends JSON payloads:

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

Event Triggers

Configure which events send notifications:

Event	Description
Print Started	When a print job begins
Print Completed	When a print finishes successfully
Print Failed	When a print fails or errors out
Print Stopped	When you manually cancel a print
Progress Milestones	At 25%, 50%, and 75% progress
Printer Offline	When a printer disconnects
Printer Error	When HMS errors are detected
Low Filament	When filament is running low

Enable/disable each event per provider.

Quiet Hours

Suppress notifications during sleep or focus time:

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

Notifications during quiet hours are silently skipped.

Per-Printer Filtering

Limit notifications to specific printers:

Open provider settings
Find Printer dropdown
Select a specific printer (or "All Printers")

Only events from the selected printer(s) trigger notifications.

Daily Digest

Batch notifications into a daily summary:

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

How It Works

Individual events are collected (not sent immediately)
At digest time, one summary notification is sent
Summary includes counts and details of all events

Example Digest

Daily Print Summary:
- 3 prints completed
- 1 print failed
- Total print time: 8h 45m
- Filament used: 245g

Message Templates

Customize notification messages using variables:

Accessing Templates

Go to Settings > Notifications
Click Templates tab
Click any event type to edit

Using Variables

Insert dynamic content using {variable} syntax:

Click variable buttons to insert
Preview with sample data
Save to apply changes

Available Variables

Print Start

{printer} - Printer name
{filename} - Print filename
{estimated_time} - Estimated duration

Print Complete

{printer}, {filename}
{duration} - Actual print time
{filament_grams} - Filament used

Print Failed

{printer}, {filename}, {duration}
{reason} - Failure reason

Print Progress

{printer}, {filename}
{progress} - Percentage complete
{remaining_time} - Time remaining

Printer Offline

{printer}

Printer Error

{printer}
{error_type} - HMS error type
{error_detail} - Error description

Filament Low

{printer}
{slot} - AMS slot number
{remaining_percent} - Filament remaining
{color} - Filament color

Common Variables (all events)

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

Reset to Default

Click the reset button on any template to restore the original message.

Testing Notifications

Before relying on notifications:

Configure your provider
Click Send Test
Verify you receive the test message
If it fails, check configuration and try again

Tips

Use ntfy for the simplest setup (no account needed)
Enable quiet hours to avoid middle-of-night alerts
Set up multiple providers for redundancy
Use progress milestones for long prints
Configure printer filtering if you have multiple printers
Customize templates to include only the info you need

Features-Notifications.md 6.9 KB History Raw