Getting Started
===============

~ `Github <https://github.com/afg984/pyardrone>`_ ~
`PyPI <https://pypi.python.org/pypi/pyardrone>`_ ~
`Online Docs <https://afq984.github.io/pyardrone/>`_ ~

Requirements
------------

* Python 3.4 or later
* opencv 3.0 or later (for video support)

Installation
------------

.. code-block:: bash

    pip install pyardrone

Basic Usage
-----------

.. code-block:: python3

    import time
    from pyardrone import ARDrone
    drone = ARDrone()
    drone.navdata_ready.wait()  # wait until NavData is ready
    while not drone.state.fly_mask:
        drone.takeoff()
    time.sleep(20)              # hover for a while
    while drone.state.fly_mask:
        drone.land()


To move forward:

.. code-block:: python3

    while True:
        drone.move(forward=1)   # move forward at full speed


.. seealso::

    *   :ref:`ardrone`
    *   `ARDrone Developer Guide from Parrot
        <https://github.com/afg984/pyardrone/raw/dev-resources/ARDrone_Developer_Guide.pdf>`_ (mirrored)