Revamped event filtering

* Readme now documents interface
* Example updated