Warning, /utilities/kirogi/README.md is written in an unsupported language. File is not indexed.

0001 # Kirogi
0002 
0003 Kirogi is a ground control application for drones. Take to the skies, open source-style.
0004 
0005 [![Flatpak](https://binary-factory.kde.org/buildStatus/icon?job=Kirogi_x86_64_flatpak&subject=Flatpak)](https://binary-factory.kde.org/view/Android/job/Kirogi_x86_64_flatpak/lastBuild)
0006 [![Android](https://binary-factory.kde.org/buildStatus/icon?job=Kirogi_android&subject=Android)](https://binary-factory.kde.org/view/Android/job/Kirogi_android/lastBuild)
0007 
0008 ### Screenshot
0009 
0010 ![A screenshot of Kirogi's in-flight UI](https://kirogi.org/assets/img/kirogi.png "Kirogi's in-flight UI")
0011 
0012 ### Features
0013 
0014 * Direct flight controls
0015 * Fly by touch on a Navigation Map
0016 * Trigger vehicle actions (e.g. flips, trim)
0017 * Gamepad/joypad support
0018 * Live video
0019 * Configure flight parameters (speed, altitude limits)
0020 * Support for Parrot (Anafi, Bebop 2) and Ryze Tello drones (more planned)
0021 
0022 ## FAQ
0023 
0024 ### How is Kirogi different from other ground control applications?
0025 
0026 Created from scratch in February 2019, Kirogi benefits from a lot of prior art. It aims to provide the following unique combination of features:
0027 
0028 * **End-user focus.** As a [KDE application](https://manifesto.kde.org/), Kirogi aims to be a polished experience that is fun and easy to use for novices and experts alike, with special emphasis on a premium direct control experience.
0029 
0030 * **Multi-vendor.** Kirogi aims to have wide out-of-the-box support for many vehicles by different manufacturers. Users should be able to use different vehicles without needing to switch ground control software.
0031 
0032 * **Highly portable.** Kirogi aims to support many different mobile and desktop platforms. Users should be able to switch platforms without needing to switch ground control software.
0033 
0034 * **Freedom.** Kirogi will always be freely-licensed. Users should have control over and be able to extend and modify their ground control on their own.
0035 
0036 * **Open governance.** Created and maintained by the [KDE community](https://manifesto.kde.org/), an organization with more than two decades of experience in hosting free software projects.
0037 
0038 ### Will Kirogi support my drone?
0039 
0040 The Kirogi project is currently in its early stages. For now it supports the following drones:
0041 
0042 * Parrot Anafi
0043 * Parrot Bebop 2
0044 * Ryze Tello
0045 
0046 Additionally, support for the [MAVLink](https://en.wikipedia.org/wiki/MAVLink) protocol is in early development, enabling control of many drones natively speaking this protocol. To build with MAVLink support, the upstream library needs to be installed or the `MAVLINK_INCLUDE_DIR` environment variable defined.
0047 
0048 Support for additional vehicles, also by other manufacturers, is very much a goal. If your vehicle is not on the list yet, check back later!
0049 
0050 Vehicle support is subject to availability for development and testing. If you are a manufacturer and would like to see Kirogi support your hardware, please [contact the board of directors of KDE e.V.](https://ev.kde.org/contact.php) for this and any other business inquiries.
0051 
0052 ### Can Kirogi download photos and videos from my drone?
0053 
0054 Not yet. This feature is considered high priority and will be added before version 1.0.
0055 
0056 ### Does Kirogi support mission planning and upload?
0057 
0058 Not yet. A mission planning mode is a future goal.
0059 
0060 ### Do I need a touchscreen to use Kirogi?
0061 
0062 A touchscreen is not required to use Kirogi. It has basic support for two-stick gamepad/joypad controllers (it was tested with an Xbox One controller).
0063 
0064 ### Does Kirogi support the Parrot Skycontroller peripherals?
0065 
0066 Not yet. There is basic support for two-stick gamepad/joypad controllers, however.
0067 
0068 ### What does the name mean?
0069 
0070 The Kirogi project was started in South Korea. Kirogi (written "기러기" in the native writing system) is the Korean word for wild geese.
0071 
0072 _Wild_ geese are known as expert flyers. Kirogi's mascot is a farm goose with an adventurous spirit, who flies just as well thanks to the use of superior technology.
0073 
0074 ## Technology and License
0075 
0076 ### Does Kirogi support [MAVLink](https://en.wikipedia.org/wiki/MAVLink)?
0077 
0078 Support for the [MAVLink](https://en.wikipedia.org/wiki/MAVLink) protocol is in early development, enabling control of many drones natively speaking this protocol. To build with MAVLink support, the upstream library needs to be installed or the `MAVLINK_INCLUDE_DIR` environment variable defined.
0079 
0080 ### What technology does Kirogi use?
0081 
0082 Kirogi is written in C++14 and QML. It uses the [Kirigami](https://www.kde.org/products/kirigami/) UI toolkit (part of [KDE Frameworks](https://www.kde.org/products/frameworks/)) and Qt Quick, supported on a diverse array of mobile and desktop platforms.
0083 
0084 ### What is the license?
0085 
0086 Kirogi's library in src/lib/ and bundled vehicle support plugins in src/plugins/ are licensed under LGPL v2.1 (or later), see COPYING.LIB.
0087 
0088 The frontend (UI and other business logic) is licensed under GPL v2 (or later), see COPYING.
0089 
0090 The app icon in data/icons/ is licensed under LGPL v2.1 (or later), see COPYING.LIB.
0091 
0092 The mascot artwork in src/ui/assets/ is licensed under CC-BY-SA 4.0, see COPYING.MASCOT.
0093 
0094 ### I have a supported Parrot drone. Do I need the Parrot SDK to use Kirogi?
0095 
0096 The Parrot SDK is not required to use Kirogi. It contains its own implementation of the protocol used to operate Parrot brand drones.