Ryze Tello SDK

Node.js SDK for the Ryze Tello Drone.
Provides a fluent Promise-based API for drone commands, live telemetry, and video streaming.

Prerequisites

Your computer must be connected to the Tello's Wi-Fi network (TELLO-XXXXXX). The drone creates its own access point - connect to it like any other Wi-Fi network.

Install

npm install @giwisoft/ryze-tello-sdk

Once connected to the Tello's Wi-Fi:

import { Tello } from '@giwisoft/ryze-tello-sdk';

const tello = new Tello();

(async () => {
  await tello.start();
  await tello.takeoff();
  await tello.up(50);
  await tello.flip('f');
  await tello.forward(50);
  console.log('Battery:', (await tello.get('bat')).value, '%');
  await tello.land();
  await tello.stop();
})();

Telemetry dashboard

Start the telemetry server to view real-time OSD data in your browser:

await tello.startTelemetry({
  withMqtt: false,
  withWarp10: false
});

This opens a live dashboard at http://localhost:3000/telemetry.html with charts for height, speed, temperature, acceleration, and rotation. Data is pushed via WebSocket.

Telemetry forwarders

Optionally forward telemetry to external services. See the dedicated tutorials for setup:

Mock server

Test your code without a physical drone:

npm run mock

Then use the SDK in mock mode:

const tello = new Tello();
tello.mock().start().then(() => tello.takeoff());

The mock server echoes commands and responses over WebSocket. Open http://localhost:3000/mockServer.html to watch the traffic.

Video stream

Requires mplayer installed on your system.

await tello.startStream(); // starts H.264 video → mplayer
await tello.wait(10000);
await tello.stopStream();

Flight vars / OSD fields

API docs

Full API documentation: https://giwi.github.io/ryze-tello-sdk