organized and improved API methods
transition time is now a config option