Skip to content

Kinda like other 2MQTT packages but for CUPS, the UNIX printing system

License

Notifications You must be signed in to change notification settings

momentobooth/cups2mqtt

Repository files navigation

CUPS2MQTT

This is the repository for the CUPS2MQTT project. The goal of this project is to provide a way to monitor the status of a CUPS print server and its print queues/printers and send the status to an MQTT broker.

Additionally, this projects will provide the data to Home Assistant via the MQTT Discovery feature.

Status: Basic functionality in place, Docker image available on Docker Hub.

Current functionality

  • MQTT and CUPS connection details configurable
    • Allows secure connection to MQTT broker and CUPS server
    • Allows verification of TLS certificates through system CA store
    • Allows TLS without verification of server certificate
  • Name, description, state and job count of printqueues are sent to MQTT broker
    • Supports job details
  • Home Assistant MQTT Discovery support
    • Support for topology discovery
    • Online/Offline status (using LWT?)
  • Control of print queues via MQTT
    • Pause/Resume print queues
    • Cancel print jobs
    • Restart print jobs
    • Add print jobs
  • Ink or toner levels
  • Error reporting through Sentry
  • Handling disappeared print queues
  • MQTT LWT support
  • Application packaging
    • Docker image
    • Anything else, like Windows installer or perhaps a Homebrew package

Troubleshooting

Can't connect to a MQTT server by IP address with TLS enabled

This a limitation of webpki, as such rusttls can't create such connections at the moment, as such rumqttc can't create such connections.

Simply connect by hostname, if your server's hostname cannot be resolved using DNS, a workaround could be to add the hostname to your OS'es hosts file.

About

Kinda like other 2MQTT packages but for CUPS, the UNIX printing system

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published