# tello-ctrl a python package to control your Tello drone
This is a package to control your Tello Drone. A significant part of the code is from the TelloPy package
from Hanyazou and the original GOBOT project (https://gobot.io/blog/2018/04/20/hello-tello-hacking-drones-with-go)
<p align="center">
<img src="/images/telloDrone.jpg" width="25%">
</p>
Compared with the existing package, tello-ctrl:
+ has a nice documentation
+ allows logging data in background
+ allows recording video files (mkv) in background
+ allows reading all the drone sensors using the so-called "low level protocol"
+ can be used with Matlab thanks to the companion Matlab toolbox
## Installation
You can clone the github repo or use the code or you can install the package using pip.
```
$ pip install tello-ctrl
```
## Documentation
You can find the doc on the [readthedocs website](https://tello-ctrl.readthedocs.io/en/latest/).
## Examples
The documentation includes various examples in the ["Getting started"](https://tello-ctrl.readthedocs.io/en/latest/getting_started.html) examples.
```
from tello_ctrl import *
import time
drone = tello_ctrl()
drone.connect()
# request video stream and record a video file
drone.start_receiving_video(video_format='bgr24')
drone.start_recording_video_to_file('demo.mkv')
# log all the data into a csv file
drone.start_data_logging('demo.csv',sampling_time=0.5)
# let's fly
drone.takeoff()
drone.move_forward(15)
time.sleep(0.5)
drone.move_counter_clockwise(15)
time.sleep(0.5)
drone.land()
# stop recording to file and close video
drone.start_recording_video_to_file()
drone.start_receiving_video()
# stop data logging
drone.stop__data_logging()
# clean up
drone.quit()
```
Raw data
{
"_id": null,
"home_page": null,
"name": "tello-ctrl",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "tello, drone, Control, low level protocol, dji",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/43/e7/c40369de3eef29b3d5020531f1f0566768e5146196152047470019128bcd/tello-ctrl-1.0.6.tar.gz",
"platform": null,
"description": "# tello-ctrl a python package to control your Tello drone\r\n\r\nThis is a package to control your Tello Drone. A significant part of the code is from the TelloPy package \r\nfrom Hanyazou and the original GOBOT project (https://gobot.io/blog/2018/04/20/hello-tello-hacking-drones-with-go)\r\n\r\n<p align=\"center\">\r\n<img src=\"/images/telloDrone.jpg\" width=\"25%\">\r\n</p>\r\n\r\nCompared with the existing package, tello-ctrl:\r\n\r\n+ has a nice documentation\r\n+ allows logging data in background\r\n+ allows recording video files (mkv) in background\r\n+ allows reading all the drone sensors using the so-called \"low level protocol\"\r\n+ can be used with Matlab thanks to the companion Matlab toolbox\r\n\r\n## Installation\r\nYou can clone the github repo or use the code or you can install the package using pip.\r\n\r\n```\r\n$ pip install tello-ctrl\r\n```\r\n\r\n## Documentation\r\nYou can find the doc on the [readthedocs website](https://tello-ctrl.readthedocs.io/en/latest/).\r\n\r\n## Examples\r\nThe documentation includes various examples in the [\"Getting started\"](https://tello-ctrl.readthedocs.io/en/latest/getting_started.html) examples.\r\n\r\n```\r\nfrom tello_ctrl import *\r\nimport time\r\n\r\ndrone = tello_ctrl()\r\ndrone.connect()\r\n\r\n# request video stream and record a video file\r\ndrone.start_receiving_video(video_format='bgr24')\r\ndrone.start_recording_video_to_file('demo.mkv')\r\n\r\n# log all the data into a csv file\r\ndrone.start_data_logging('demo.csv',sampling_time=0.5)\r\n\r\n# let's fly\r\ndrone.takeoff()\r\ndrone.move_forward(15)\r\ntime.sleep(0.5)\r\ndrone.move_counter_clockwise(15)\r\ntime.sleep(0.5)\r\n\r\ndrone.land()\r\n\r\n# stop recording to file and close video\r\ndrone.start_recording_video_to_file()\r\ndrone.start_receiving_video()\r\n\r\n# stop data logging\r\ndrone.stop__data_logging()\r\n\r\n# clean up\r\ndrone.quit()\r\n```\r\n",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "1.0.6",
"project_urls": {
"Issues": "https://github.com/sebdelp/tello-control/issues",
"Repository": "https://github.com/sebdelp/tello-control"
},
"split_keywords": [
"tello",
" drone",
" control",
" low level protocol",
" dji"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ffce7da28e0b71f0c81f9643c6cc3f0b711d9fd13761c3661ba9bcb30dd91014",
"md5": "1f1d66855d50a403313d4474a9adc9bd",
"sha256": "d774c097a00b1f99db865e0a8c949b8aa1e00db8cf600696afe4736dbf3ddcc4"
},
"downloads": -1,
"filename": "tello_ctrl-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1f1d66855d50a403313d4474a9adc9bd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 16157,
"upload_time": "2024-04-03T22:14:38",
"upload_time_iso_8601": "2024-04-03T22:14:38.354489Z",
"url": "https://files.pythonhosted.org/packages/ff/ce/7da28e0b71f0c81f9643c6cc3f0b711d9fd13761c3661ba9bcb30dd91014/tello_ctrl-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "43e7c40369de3eef29b3d5020531f1f0566768e5146196152047470019128bcd",
"md5": "b20f1db08a91b05483a70193bdad8cd6",
"sha256": "0e0c5d8ad05c8b12f61c6a08f05f25ece964a5110c6b23bd65ab93879d6c326a"
},
"downloads": -1,
"filename": "tello-ctrl-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "b20f1db08a91b05483a70193bdad8cd6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 16116,
"upload_time": "2024-04-03T22:14:40",
"upload_time_iso_8601": "2024-04-03T22:14:40.263634Z",
"url": "https://files.pythonhosted.org/packages/43/e7/c40369de3eef29b3d5020531f1f0566768e5146196152047470019128bcd/tello-ctrl-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-03 22:14:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sebdelp",
"github_project": "tello-control",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "av",
"specs": [
[
"==",
"12.0.0"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.4"
]
]
},
{
"name": "opencv-python",
"specs": [
[
"==",
"4.9.0.80"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"10.2.0"
]
]
}
],
"lcname": "tello-ctrl"
}
JSON
