Webhook Listener /

Filename Size Date modified Message
25 B
Initial commit
1.6 KB
Initial commit
559 B
changed license, improved readme
114 B
Initial commit
1.8 KB
changed license, improved readme
3.0 KB
Fixes minor lint issues
39 B
Renames REQUIREMENTS.txt as requirements.txt
24 B
Initial commit

This repository sets up a simple Flask server to receive Bitbucket webhooks and notifies you via Mac OS X Notification Center


  • Mac OS X 10.8+
  • Python
  • Pip
  • ngrok (Note: brew install ngrok installs an old version. Use latest ngrok download instead.)
  • virtualenv (optional)


  1. Clone this repository and set it as the current working directory.
  2. (Optional, but good practice) Create a virtual environment. mkvirtualenv webhook-listener Once created, use workon webhook-listener to restore the virtual environment.
  3. pip install -r REQUIREMENTS.txt loads required libraries.
  4. Edit .env for a ngrok subdomain of your choosing. If you are using a free ngrok account, just rm .env.
  5. honcho start to start the ngrok tunnel and Flask server (python listener.py to start without ngrok)
  6. Configure your webhook (default: http://bbwebhook.ngrok.io/webhook) on your repo in Bitbucket. If you are using a free ngrok account, you can find an assigned URL on the ngrok dashboard under the Tunnels Online section. If you copy from the dashboard, be sure to add /webhook to the end when you paste into Bitbucket.



This repo uses:

  • Microframework: Flask
  • Python Foreman clone: Honcho
  • Python wrapper for Mac OS 10.8 Notification Center: pync
  • Secure tunneling to localhost: ngrok