allow setting value via API to update display; add readme content