Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Monitoring Jabber Bot

Project description

Monitoring Jabber Bot with Zabbix support, completely written in Python.


  • Simple and modular design

  • Alerts from Zabbix

  • Multi-User Chat (XEP-0045)

  • Colorful messages (XEP-0071)

  • Attention (XEP-0224)

  • Avatars (XEP-0084)

  • Roster management and ACL configuration

  • Webhooks and cron jobs

  • Plugins and commands:

    * ludolph.plugins.zabbix
        * ack - acknowledge event with optional note
        * alerts - show a list of current or previous zabbix alerts
        * duty - show a list of users in duty user group
        * groups - show a list of host groups
        * hosts - show a list of hosts
        * outage - show, create or delete maintenance periods
        * zabbix-version - show version of Zabbix API
    * ludolph.plugins.base
        * about - details about this project
        * at - list, add, or delete jobs for later execution
        * attention - send XMPP attention to user/room
        * avatar - list available avatars or set an avatar for Ludolph (admin only)
        * broadcast - sent private message to every user in roster (admin only)
        * help - show this help
        * message - send new XMPP message to user/room
        * remind - list, add, or delete reminders
        * roster - list and manage users on Ludolph's roster (admin only)
        * status - set Ludolph's status (admin only)
        * uptime - show Ludolph uptime
        * version - display version of Ludolph or registered plugin
    * ludolph.plugins.muc
        * invite - invite user or yourself to multi-user chat room (room admin only)
        * kick - kick user from multi-user chat room (room admin only)
        * motd - show, set or remove message of the day
        * topic - set room subject (room admin only)
    * ludolph.plugins.commands
        * os-uptime - display system uptime


  • Install the latest released version using pip:

    pip install ludolph
  • Or install the latest development version:

    pip install
  • Make sure all dependencies (listed below) are installed (done automatically when installing via pip)

  • Create and edit the configuration file:

    cp /usr/lib/python2.7/site-packages/ludolph/ludolph.cfg.example /etc/ludolph.cfg
  • The ludolph command should be installed somewhere in your PATH.

  • Init scripts for Debian and RHEL based distributions are also available:

See the complete install guide and Zabbix integration guide for more info.



For more information see the LICENSE file.

Avatars have been designed by

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ludolph-1.0.1.tar.gz (173.4 kB) Copy SHA256 hash SHA256 Source None Jul 20, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page