readme update, convert terminal script into def