Installation

Requirements

  • Python 3.5 or newer version
  • Visual Studio 2015 community edition (only Windows)

How to install

Windows

This instructions guides you to install Explorepy API with all its dependencies on Windows.

  1. Install Python 3 on your computer. It is recommended to install Anaconda Python package. Download and install Anaconda Python 3.7 Windows installer from here.
  2. Download and install MS Visual Studio Community Edition 2015 from this link. You may need to sign in to your Microsoft account to be able to download it. During the installation, select custom installation and in the features list make sure you check Common tools for Visual C++ 2015 under Visual C++ section and Python tools for Visual Studio (January 2017).
  3. We recommend using a virtual environment.
  • In Conda command prompt: conda create -n myenv python=3.6
  • Activate the virtual environment: conda activate myenv
  1. Upgrade your pip: python -m pip install --upgrade pip
  2. To install explorepy from PyPI run: pip install explorepy

Ubuntu

  1. Install Bluetooth header files using sudo apt-get install libbluetooth-dev
  2. It is recommended to install Anaconda Python package. Download and install Anaconda Python 3.7 Ubuntu installer from here.
  3. We recommend using a virtual environment in Conda.
  • In Conda command prompt: conda create -n myenv python=3.6
  • Activate the virtual environment: conda activate myenv
  1. Upgrade your pip: python -m pip install --upgrade pip
  2. To install explorepy from PyPI run: pip install explorepy

Mac

  1. Install XCode from Mac App store. An upgrade to the latest version of MacOS might be required for installation of XCode. For older versions of MacOS, you can find compatible versions of XCode in this page. All old Xcode versions are available here.
  2. Accept the license agreement: sudo xcodebuild -license
  3. It is recommended to install Anaconda Python package. Download and install Anaconda Python 3.7 Mac installer from here. For older versions of MacOS, compatible version of Anaconda can be found in this table and can be downloaded from here.
  4. We recommend using a virtual environment in Conda.
  • In Conda command prompt: conda create -n myenv python=3.6
  • Activate the virtual environment: conda activate myenv
  1. Upgrade your pip: python -m pip install --upgrade pip
  2. To install explorepy from PyPI run: pip install explorepy

Quick test

  • Open Conda command prompt
  • Activate the virtual environment: conda activate myenv
  • explorepy visualize -n <YOUR-DEVICE-NAME> -c 4 (Change the number of channels if needed)
  • To stop visualization press Ctrl+c