The Crazyflie PC client enables flashing and controlling the Crazyflie. It implements the user interface and high-level control (for example gamepad handling). The communication with Crazyflie and the implementation of the CRTP protocol to control the Crazflie is handled by the cflib project.

For more info see our documentation.

The client can be installed and run with snap, it can be found on snapcraft (ie. search Crazyflie in Ubuntu software) or installed from command line:

snap install --edge cfclient
snap connect cfclient:raw-usb    # Required to access the Crazyradio
snap connect cfclient:joystick   # Required to access gamepads

The only build available right now is the latest commit from github (edge), the next version will be pushed in the snapcraft stable channel.

It is still required to set the udev permission with the snap, see the last section of this page.

A windows installer is automatically built for each git commit in appveyor.

For each release, the release built is available in the github release page.

To use Crazyradio you will have to install the drivers.

Each release of the client is pushed to the pypi repository. If you have python >= 3.5, it can be installed with pip:

python3 -m pip install cfclient

Mac and windows will also need the SDL2 library to be installed (see bellow)

The Crazyflie client requires Python >= 3.5. The followind instruction describe hot to install it from source.

It is good to work within a python venv, this way you are not installing dependencies in your main python instance.

At the very least you should never run pip in sudo, this would install dependencies system wide and could cause compatiblity problems with already installed application. If the pip of python3 -m pip command request the administrator password, you should run the command with --user (for example python3 -m pip install --user -e .). This should not be required on modern python distribution though since the --user flag seems to be the default behaviour.

All dependencies on linux are handled by pip so to install an editable copy simply run:

$ python3 -m pip install -e .

The client can now be runned using cfclient if the local pip bin directory is in the path (it should be in a venv or after a reboot), or with python3 -m cfclient.gui.

Running from source on Windows is tested using the official python build from python.org. The client works with python version >= 3.5. The procedure is tested with 32bit python. It will work with 64bit python but since it is not tested.

To run the client you should install python, make sure to check the "add to path" checkbox during install. You should also have git installed and in your path. Use git to clone the crazyflie client project.

Open a command line window and move to the crazyflie clients folder (the exact command depends of where the project is cloned):

cd crazyflie-clients-python

Download the SDL2.dll windows library:

python3 tools\build\prep_windows

Install the client in development mode:

pip3 install -e .[dev]

You can now run the clients with the following commands:

cfclient
cfheadless
cfloader
cfzmq

NOTE: To use Crazyradio you will have to install the drivers

Building the windows installer currently only works with python 3.6. This is due to a bug in CX_freeze, see issue #441 for update about this problem.

To build the windows installer you need to install the dev dependencies

pip install -e .[dev]

First build the executable

python setup.py build

Now you can run the client with build\exe.win32-3.6\cfclient.exe.

To generate the installer you need nsis installed and in the path. If you are a user of chocolatey you can install it with choco install nsis.portable -version 2.50, otherwise you can just download it and install it manually.

To create the installer:

python win32install\generate_nsis.py
makensis win32install\cfclient.nsi

The supported way to run on Mac is by using the Homebrew distribution of python3.

Python3 and required libs can be installed with brew:

brew install python3 sdl2 libusb

To install the client in edit mode:

pip3 install -e .

The client can now be started with cfclient or python3 -m cfclient.gui.

you can edit the .ui files for the GUI with QtCreator. For Windows and Mac You can the Qt development kit from the Qt website. On linux QtCreator is usually available as package, for example on Ubuntu it can be installed with sudo apt install qtcreator.

Using Crazyradio on Linux requires that you set udev permissions. See the cflib readme for more information.