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.