converted helper scripts into Python
tagged wip features
documenting error handling