documentation and example for LiveInput