18th of November, 2026

Skybrush file formats are now officially published

Skybrush file formats are now officially published
Skybrush Team
Skybrush Team

The open side of Skybrush has grown again: we have published the official specification of the Skybrush file formats. From now on, everyone can read in detail how a Skybrush drone show is stored, from the show designed in Skybrush Studio all the way down to the binary mission file uploaded to each individual drone.

The documentation is available at our main documentation site as Skybrush file formats.

Why now? #

The Skybrush ecosystem keeps growing. More and more drone manufacturers, show operators and developers use Skybrush every day, and many of them build their own tools around it: show converters, validators, visualizers, custom firmware integrations and all kinds of in-house helper apps.

Over the past years we have received a steady stream of requests from these teams to share the details of our file formats. Until now, the honest answer was often “look at the source code” — which, in practice, meant reverse engineering the formats piece by piece.

In the age of AI, reverse engineering a file format has become easier than ever, but a format that is reconstructed from examples is still just a guess. Subtle details, such as time bases, units, scale factors or the handling of edge cases, are easy to get wrong and hard to notice until something unexpected happens in the air. Instead of leaving everyone to figure these out by themselves (or by their AI agents), we decided to publish our formats officially, as an authoritative reference that both humans and AI tools can rely on.

Two formats, two purposes #

The Skybrush toolchain works with two main show formats, each optimized for a different job.

Skybrush Compiled Format (.skyc) is the format of a complete drone show. It is the typical output of drone show design tools such as Skybrush Studio, and it is the format that Skybrush Live loads before a show. It contains the synchronized trajectories, light programs, optional yaw control setpoints, pyro events and pre-calculated return-to-home plans of all drones, together with show-level metadata. It is based on compressed JSON, so it is readable and easy to work with: you can inspect it, generate it and post-process it with standard tools in any programming language. The documentation also contains the full JSON schema of the format, along with the conventions of units, coordinate systems, etc.

Skybrush Binary Format (.skyb) is the format of the mission of a single drone. It is designed to be as compact as possible: trajectories are stored as scaled Bézier curves, light programs as compact bytecode, and all other content in a flexible system of typed blocks. The small file size keeps uploads fast even when a show has thousands of drones, and makes the format easy to parse on resource-constrained flight controllers. The documentation describes every block of the format byte by byte, including the rules that parsers must follow when they encounter unknown, reserved or malformed data.

Towards industry standards #

Both formats are the result of many years of real-world drone show experience, and they have been refined through countless shows flown with Skybrush worldwide. We believe that well-defined, openly documented formats are a key step towards common standards in the drone show industry, where interoperability between design tools, ground control stations and drone firmware is becoming more and more important.

By publishing our formats, we hope to make it easier for everyone to build on them, and to contribute to the emergence of industry standards in the field of drone shows.

Support open source #

Skybrush is an open-core ecosystem, and the publication of our file formats is another step on our open-source journey. We are truly grateful to all our partners who support us by purchasing our Professional license packages, which recognizes that open source can only thrive when its core team is supported.

Provide feedback #

If you find something unclear or missing in the documentation, or you have questions about implementing the formats in your own tools, let us know on our Discord server.

Community feedback significantly shapes the evolution of Skybrush. Thank you for contributing!

essential