updated documentation and player API