Skip to main content

Mopidy extension that sends webhook notifications to a remote server

Project description

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

Mopidy-Webhooks is a frontend extension for mopidy that sends webhook requests (regular JSON over HTTP POST requests) to a remote server. Mopidy-Webhooks sends a webhook any time mopidy core triggers an event, and also periodically sends player status updates to the remote server.

This is very much a work in progress. Please treat it as such and file issues where appropriate.

Installation

Install by running:

pip install Mopidy-Webhooks

Configuration

Before starting Mopidy, you must add configuration for Mopidy-Webhooks to your Mopidy configuration file:

[webhooks]
api_key = my-api-key                              ; optional
api_key_header_name = X-MOPIDY-WEBHOOKS-API-KEY   ; optional
status_update_interval = 5                        ; optional
webhook_url = http://localhost:8080/api/webhooks/ ; required

api_key if present, will be sent as a HTTP header using the key X-API-KEY. If you’d rather use a different header name, this can be customised with the configuration value api_key_header_name.

status_update_interval controls the interval between the sending of status update webhooks (in milliseconds). Set to 0 to disable the sending of periodic status updates. If you want continuous status updates, just use a very very small value.

webhook_url should be a URL (accessible to the mopidy client). The provided URL should accept HTTP POST requests, the body of which will contain JSON data. Requests will contain either periodic status updates (currently active track, playback state and time position) or JSON serialised event data emitted by Mopidy core.

Changelog

v0.2.0

  • General refactoring
  • Small docs improvements

v0.1.0

  • Initial release.

Project details


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
Mopidy-Webhooks-0.2.0.tar.gz (9.2 kB) Copy SHA256 hash SHA256 Source None Nov 3, 2014

Supported by

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