Notifications plugin for Printoid (Android app for OctoPrint)

This is the official plugin made for the Printoid for OctoPrint application.

It aims to send you push notifications to your device(s) on specific events on your OctoPrint server. This plugin has been inspired by the great plugin made by the developer of OctoPod for iOS. He plugin (the original one) can be found here. If you like the Printoid Plugin, then please support the developer of the OctoPod plugin, because he did an amazing work!

The Printoid Plugin communicates with Firebase Cloud Messaging server over a Google Cloud Function, located at the following URL:

https://us-central1-firebase-printoid.cloudfunctions.net/printoidPluginGateway

Prerequisites

Printoid v15.01 (at least) should be available and installed on your phone

What CAN this plugin do for you?

This plugin sends immediate push notifications to your Android devices running Printoid for OctoPrint when:

  • The state of your printer is changing (to PRINTING, to PAUSED, to ERROR, and back to OPERATIONAL, for example)
  • The print job reached a certain progress (every 10%, every 25% or at 50% only)
  • Your print is now complete (progress = 100%)
  • Your print reached specified layers (requires plugin DisplayLayerProgress plugin to be installed too)
  • Your heated bed reached a specific temperature (useful to know when you can easily remove your prints from the bed, or when you can get smooth first layer)
  • Your extruder cooled down below a specific temperature (useful to be informed when you can safely turn off your printer)
  • Your printer has been paused because it requires a user action (out of filament, or manual multi color printing or M600 detection)
  • Palette 2 / Pro encountered a problem while printing
  • MMU requires user assistance (it requires Prusa firmware)
  • Firmware errors (get security alerts like thermal runaway, probing failed, min temp error, max temp error…)

This plugin does not need your phone to be connected to the same network as your OctoPrint server to send the notifications. You will be able to receive the notifications even if you are out of your home and/or connected to the cellular network (3G/4G/5G) for example.

This plugin does not need your network to be opened to the Internet. You do not need to do port forwarding, and you do not need to setup a VPN ;)

Printoid does not need to be opened on your device to receive the notifications from the plugin. The app can be killed and your phone can be sleeping, you will receive the notifications whatever happens!

What CAN’T this plugin do for you?

This plugin is not a plugin to control your 3D printer remotely. Please be nice, don’t yell at me because this was what you expected… May be this will be possible in the future, but for the moment it would require me too much work.

This plugin only sends push to your device in order to show you notifications on your device for specific events. This way it will not update the information contained in the app (at least for the moment).

Setup

Install the plugin via the bundled Plugin Manager or manually using this URL:

https://github.com/anthonyst91/OctoPrint-Printoid/archive/master.zip

Configuration

Once the plugin has been installed:

  1. Open the Settings panel of OctoPrint
  2. Navigate to the Plugins section and select Printoid Notifications
  3. Open the Printoid application on your phone, and connect it to your OctoPrint server
  4. Wait few seconds for the app to be fully refreshed
  5. From the OctoPrint interface, click on the Send test notification button
  6. Check on your phone, you should receive your first notification!
  7. The Printoid app is now paired with the Printoid plugin, you will receive notifications!

Pictures

Notification on print progress
Notification on print completed
Notification on temperature alert