semvec/pypi-packages huggingface dataset:
djitellopy2 2.3
Tello drone library including support for video streaming, swarms, state packets and more
License: MIT
Requires Python: >=3.6
Keywords: tello,dji,drone,sdk,official sdk

# DJITelloPy
DJI Tello drone python interface using the official [Tello SDK](https://dl-cdn.ryzerobotics.com/downloads/tello/20180910/Tello%20SDK%20Documentation%20EN_1.3.pdf) and [Tello EDU SDK](https://dl-cdn.ryzerobotics.com/downloads/Tello/Tello%20SDK%202.0%20User%20Guide.pdf). This library has the following features:

- implementation of all tello commands
- easily retrieve a video stream
- receive and parse state packets
- control a swarm of drones
- support for python >= 3.6

Feel free to contribute!

## Install using pip
```
$ pip install djitellopy2
```

For Linux distributions with both python2 and python3 (e.g. Debian, Ubuntu, ...) you need to run
```
$ pip3 install djitellopy2
```

## Install in developer mode
Using the commands below you can install the repository in an _editable_ way. This allows you to modify the library and use the modified version as if you had installed it regularly.

```
$ git clone https://github.com/damiafuentes/DJITelloPy.git
$ cd DJITelloPy
$ pip install -e .
```

## Usage
### API Reference
See [djitellopy.readthedocs.io](https://djitellopy.readthedocs.io/en/latest/) for a full reference of all classes and methods available.

### Simple example
```python
from djitellopy import Tello

tello = Tello()

tello.connect()
tello.takeoff()

tello.move_left(100)
tello.rotate_counter_clockwise(90)
tello.move_forward(100)

tello.land()
```

### More examples
In the [examples](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/) directory there are some code examples:

- [taking a picture](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/take-picture.py)
- [recording a video](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/record-video.py)
- [flying a swarm (multiple Tellos at once)](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/simple-swarm.py)
- [simple controlling using your keyboard](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/manual-control-opencv.py)
- [mission pad detection](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/mission-pads.py)
- [fully featured manual control using pygame](https://github.com/damiafuentes/DJITelloPy/tree/master/examples/manual-control-pygame.py)

### Notes
- If you are using the ```streamon``` command and the response is ```Unknown command``` means you have to update the Tello firmware. That can be done through the Tello app.
- Mission pad detection and navigation is only supported by the Tello EDU.
- Bright environment is necessary for successful use of mission pads.
- Connecting to an existing wifi network is only supported by the Tello EDU.
- When connected to an existing wifi network video streaming is not available.

## Authors

* **Damià Fuentes Escoté**
* **Jakob Löw**
* [and more](https://github.com/damiafuentes/DJITelloPy/graphs/contributors)

## License

This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details