Skip to content
Branch: master
Find file History
Pull request Compare This branch is 6 commits behind dji-sdk:master.
Latest commit 5b0b819 Nov 15, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
h264decoder Tello-Python SampleCode v1.0.0 Nov 12, 2018
img add the 'img'file Nov 15, 2018
install add the .gitattributes Nov 15, 2018 Tello-Python SampleCode v1.0.0 Nov 12, 2018 Tello-Python SampleCode v1.0.0 Nov 12, 2018 Tello-Python SampleCode v1.0.0 Nov 12, 2018 Tello-Python SampleCode v1.0.0 Nov 12, 2018


This is an example using the Tello SDK v1.3.0.0 and above to receive video stream from Tello camera,decode the video stream and show the image by GUI.

  • Written in Python 2.7
  • Tello SDK v1.3.0.0 and above(with h.264 video streaming)
  • This example includes a simple UI build with Tkinter to interact with Tello
  • Interactive control of Tello based on human movement is achieved via body pose recognition module.



In order to facilitate you to install python2.7 and various dependencies, we have written a one-click installation script for windows, Linux and macos. You can choose to run this script for the one-click installation, or you can download python2.7 and related libraries and dependencies online. If you have questions about the actions that the script performs, you can open the script with an editor and look up the comments for each instruction in the script. In addition, we have additionally written an uninstall script that cleans and restores all downloaded and configured content from the one-click installation script.

  • Windows

    Go to the "install\Windows" folder,select and run the correct "windows_install.bat" according to your computer operating system bits.

  • Linux (Ubuntu 14.04 and above)

    Go to the "install\Linux" folder in command line, run

    chmod +x
  • Mac

    1. Make sure you have the latest Xcode command line tools installed. If not, you might need to update your OS X and XCode to the latest version in order to compile the h264 decoder module
    2. Go to the "install\Mac" folder folder in command line, run
       chmod a+x ./

    If you see no errors during installation, you are good to go!

Run the project

  • Step1. Turn on Tello and connect your computer device to Tello via wifi.

  • Step2. Open project folder in terminal. Run:

  • Step3. A UI will show up, you can now:

    • Watch live video stream from the Tello camera;
    • Take snapshot and save jpg to local folder;
    • Open Command Panel, which allows you to:
      • Take Off
      • Land
      • Flip (in forward, backward, left and right direction)
      • Control Tello using keyboard inputs:
        • [key-Up] move forward 20cm
        • [key-Down] move backward 20cm
        • [key-Left] move left 20 cm
        • [key-Right] move right 20 cm
        • [key-w] move up 20cm
        • [key-s] move down 20cm
        • [key-a] rotate counter-clockwise by 30 degree
        • [key-d] rotate clockwise by 30 degree
      • You can also adjust the distance and degree via the trackbar and hit the "reset distance" or "reset degree" button to customize your own control.

Project Description - class Tello

Wrapper class to interact with Tello drone. Modified from

The object starts 2 threads:

  1. thread for receiving command response from Tello
  2. thread for receiving video stream

You can use read() to read the last frame from Tello camera, and pause the video by setting video_freeze(is_freeze=True). - class TelloUI

Modified from:

Build with Tkinter. Display video, control video play/pause and control Tello using buttons and arrow keys.

h264decoder - class libh264decoder


A c++ based class that decodes raw h264 data. This module interacts with python language via python-libboost library, and its decoding functionality is based on ffmpeg library.

After compilation, a or libh264decoder.pyd file will be placed in the working directory so that the main python file can reference it.

If you have to compile it from source,with Linux or Mac,you can:

cd h264decoder
mkdir build
cd build
cmake ..
cp ../../

With Windows,you can create a project through visual studio, add files in h264decoder and dependencies such as ffmpeg and libboost, compile the project and generate a libh264decoder.pyd file.We have generated a libh264decoder.pyd and put it in the "\h264decoder\Windows"foleder so that you can copy put it to "python/site-package".

##Contact Information

If you have any questions about this sample code and the installation, please feel free to contact me. You can communicate with me by sending e-mail to

You can’t perform that action at this time.