= Instructions to install Pepper software =

* find out the credentials in case you are installing at FI MU
* otherwise, you may download the tools from Softbank - for [https://developer.softbankrobotics.com/pepper-naoqi-25-downloads-linux Linux],
  [https://developer.softbankrobotics.com/pepper-2-5/downloads/pepper-naoqi-25-downloads-mac Mac] (supports [https://www.bartneck.de/2020/11/10/softbank-robotics-choregraphe-software-incompatible-with-mac-os-x-10-15-catalina/ OS X 10.11 only]), 
  or [https://developer.softbankrobotics.com/pepper-2-5/downloads/pepper-naoqi-25-downloads-windows Windows]
* install Choregraphe:
 * copy  `choregraphe-suite-2.5.10.7-linux64-setup.run`
 * run 
   {{{
   chmod +x choregraphe-suite-2.5.10.7-linux64-setup.run
   sudo ./choregraphe-suite-2.5.10.7-linux64-setup.run
   }}}
 * do the default installation to `/opt`
 * try to run
   {{{
   "/opt/Softbank Robotics/Choregraphe Suite 2.5/bin/choregraphe_launcher"
   }}}
   in case of error
   {{{
   /opt/Softbank Robotics/Choregraphe Suite 2.5/bin/../lib/../lib/../lib/libz.so.1: 
   version `ZLIB_1.2.9' not found (required by /usr/lib/x86_64-linux-gnu/libpng16.so.16)
   }}}
   run
   {{{
   cd "/opt/Softbank Robotics/Choregraphe Suite 2.5/lib/"
   sudo mv libz.so.1 libz.so.1.old
   sudo ln -s /lib/x86_64-linux-gnu/libz.so.1
   }}}
* install Python SDK:
 * install `qttools5-dev-tools`/`qt5-linguist` or `qt4-linguist-tools`
 * copy `pynaoqi-python2.7-2.5.7.1-linux64.tar.gz`
 * run
   {{{
   cd /usr/local/lib/python2.7/dist-packages
   sudo tar xvfz <where_the_package_is>/pynaoqi-python2.7-2.5.7.1-linux64.tar.gz
   sudo bash -c "echo /usr/local/lib/python2.7/dist-packages/pynaoqi-python2.7-2.5.7.1-linux64/lib/python2.7/site-packages \
        > pynaoqi-python2.7.pth"
   }}}
 * test with (note that `python` must be old Python 2.7)
   {{{
   python -c 'import qi'
   }}}
 * if something goes wrong, check that:
   * `python -c 'import sys;print "\n".join(sys.path)'` includes `/usr/local/lib/python2.7/dist-packages/pynaoqi-python2.7-2.5.7.1-linux64/lib/python2.7/site-packages`
   * the current user has ''read access'' to the files and subdirectories in this directory. You may need 
     {{{
sudo chmod 755 /usr/local/lib/python2.7/dist-packages/pynaoqi-python2.7-2.5.7.1-linux64/lib/python2.7/site-packages/
}}}
* install [http://doc.aldebaran.com/qibuild/beginner/getting_started.html qiBuild] (again for Python 2.7):
  {{{
  sudo pip install qibuild paramiko
  }}}