Skip to content

HallyAus/homeassistant-bambu-blueprints

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

50 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Bambu Printer Notification Blueprint for Home Assistant

Buy Me A Coffee Home Assistant License

A powerful Home Assistant blueprint that sends mobile notifications with camera snapshots when your Bambu printer finishes or encounters a fault. Packed with features for the ultimate 3D printing notification experience.

Notification Example


✨ Features

Feature Description
πŸ“Έ Smart Snapshots Captures a photo at ~99% progress before the bed drops
πŸ’‘ Snapshot Lighting Optionally turn on a light before capture for better photos
πŸ“± Mobile Notifications Rich notifications with images to iOS/Android
πŸ”Š TTS Announcements Voice announcements on your smart speakers
🚨 Critical Alerts Optional critical notifications that bypass Do Not Disturb
⚑ Custom Actions Run any automation on success or fault
πŸŒ™ Quiet Hours Suppress TTS during sleeping hours
⏱️ Cooldown Prevent notification spam
πŸ”” Persistent Alerts Fault notifications stay until acknowledged

πŸ“‹ Requirements

  • Home Assistant 2024.6.0 or newer
  • Bambu Lab integration installed and configured
  • A camera entity for your printer
  • (Optional) Mobile app for push notifications
  • (Optional) Media player for TTS announcements

πŸš€ Installation

Method 1: Manual Installation

  1. Download bambu_printer_notify_v4.yaml
  2. Copy to your Home Assistant config:
    /config/blueprints/automation/custom/bambu_printer_notify_v4.yaml
    
  3. Restart Home Assistant or reload automations

Method 2: Import via URL

  1. Go to Settings β†’ Automations & Scenes β†’ Blueprints
  2. Click Import Blueprint
  3. Paste the raw GitHub URL - https://raw.githubusercontent.com/HallyAus/homeassistant-bambu-blueprints/refs/heads/main/blueprints/automation/danielhall/bambu_print_notify.yaml
  4. Click Preview then Import

βš™οΈ Configuration

Required Inputs

Input Description
Print status sensor Sensor with states: running, finish, failed
Print error binary sensor Binary sensor that turns ON on error
Current stage sensor Enum sensor for printer stage
Progress sensor Print progress percentage
Printer name sensor Your printer's name
Task name sensor Current print job name
Print weight sensor Print weight in grams
Camera Your printer's camera entity
Notifications enabled input_boolean to enable/disable

Snapshot Settings

Input Default Description
Snapshot light none Light to turn on before capture
Light brightness 100% Brightness for snapshot light
Snapshot delay 1 sec Delay for light warmup / camera adjustment

TTS Settings

Input Default Description
Enable TTS Off Enable voice announcements
TTS service tts.speak Your TTS service (google, cloud, piper, etc.)
Media player none Speaker(s) for announcements
Volume 0 (current) Announcement volume (1-100%)
Success message "{{printer_name}} has finished printing {{task_name}}" Customizable template
Fault message "Warning! {{printer_name}} has encountered a fault..." Customizable template
Quiet hours Off Suppress TTS during specified times

Notification Settings

Input Default Description
Notify device empty Your mobile_app_* service name
Success type Normal Normal, Critical, or Never Critical
Fault type Critical Normal, Critical, or Never Critical
Critical sound default iOS sound name
Critical volume 1.0 Alert volume (0.0-1.0)

Custom Actions

You can run any Home Assistant actions on print success or fault:

Success action examples:

  • Turn on a green "print done" light
  • Power on a cooling fan via smart plug
  • Send a message to Discord/Slack
  • Turn off the printer after a delay

Fault action examples:

  • Turn on a red warning light
  • Flash lights to get attention
  • Pause other printers in your farm
  • Send urgent alerts to multiple services

πŸ“ Template Variables

Use these in your TTS messages:

Variable Description Example
{{ printer_name }} Printer name "X1 Carbon"
{{ task_name }} Print job name "benchy.3mf"
{{ print_weight }} Weight in grams "15"
{{ progress }} Progress percentage "100"
{{ status }} Current status "finish"

πŸ’‘ Tips & Tricks

Capture Better Snapshots

  1. Set progress threshold to 98-99% to capture before the bed drops
  2. Add a snapshot light for consistent lighting
  3. Use a 1-2 second delay to let the camera adjust

Critical Notifications

  • Set time windows to only get critical alerts during certain hours
  • Set start and end to the same time to completely disable critical alerts
  • Use "Never Critical" option to always get normal notifications

Quiet Hours for TTS

Perfect for overnight prints:

  • TTS quiet hours: 22:00 β†’ 07:00
  • You'll still get mobile notifications, just no voice announcements

Multiple Printers

Create a separate automation from this blueprint for each printer. Use different:

  • Notification tags (automatic based on printer name)
  • Snapshot lights
  • TTS messages

πŸ› Troubleshooting

"Source not found" when importing

This happens when trying to reimport from a URL. Instead:

  1. Download the YAML file manually
  2. Place it in /config/blueprints/automation/custom/
  3. Restart Home Assistant

Snapshots not saving

  1. Ensure /config/www/snapshots/ directory exists
  2. Check Home Assistant has write permissions
  3. Verify your camera entity is working

TTS not working

  1. Verify your TTS service name is correct
  2. Test your media player with Developer Tools β†’ Services
  3. Check you're not in quiet hours

Notifications not arriving

  1. Verify notify.mobile_app_* service exists
  2. Check the notifications enabled boolean is ON
  3. Review cooldown settings

πŸ“œ Changelog

v4

  • ✨ Added TTS announcements with customizable messages
  • ✨ Added TTS quiet hours
  • ✨ Support for multiple TTS services

v3

  • ✨ Added custom actions on success/fault
  • 🎨 Organized inputs into collapsible sections

v2

  • ✨ Added optional snapshot light with brightness control
  • πŸ› Fixed critical notifications (now truly optional)
  • πŸ› Fixed snapshot delay (positive values only)
  • πŸ› Fixed time window handling (00:00-00:00 = disabled)

v1

  • πŸŽ‰ Initial release

🀝 Contributing

Found a bug? Have a feature request? Feel free to:

  1. Open an issue
  2. Submit a pull request
  3. Share your custom configurations

Contributors


β˜• Support

If this blueprint has helped you, consider buying me a coffee!

Buy Me A Coffee

Your support helps me create more useful Home Assistant blueprints and integrations.


πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❀️ for the Home Assistant and 3D printing community

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors