open-dronelog

OPEN DRONELOG

        

A high-performance application for analyzing drone flight logs (DJI and Litchi CSV formats). Available as a Tauri v2 desktop app or a Docker-deployable web app. Built with DuckDB and React.

> [!IMPORTANT] > *DJI is a registered trademark of SZ DJI Technology Co., Ltd. DroneLogbook® is a registered trademark of DroneAnalytics Inc. Litchi is a trademark of VC Technology Ltd. Airdata or Airdata UAV is a trademark of Airdata UAV, Inc. This project is independent and is not affiliated with, sponsored by, authorized by, or endorsed by SZ DJI Technology Co., Ltd., DroneAnalytics Inc., VC Technology Ltd., Airdata UAV, Inc., or their affiliates.* > [!NOTE] > This project repository is dynamically mirrored in [Codeberg](https://codeberg.org/arpanghosh8453/open-dronelog) as a backup. An alternative docker image is available at [codeberg.org/arpanghosh8453/open-dronelog](https://codeberg.org/arpanghosh8453/-/packages/container/open-dronelog). ## Contents - [Features](#features) - [Accessing flight log files](#accessing-flight-log-files) - [Automated Sync Bridge](#automated-sync-windowsmac) - [Manual Log Collection](#manual-log-collection) - [Airdata Exports](#airdata-exports) - [Setup and installation (Windows/MacOS/Android)](#setup-and-installation-windowsmacos) - [Try the Webapp First](#try-the-webapp-first-no-installation-required) - [Hosting Open Drone Log for Teams](#hosting-open-drone-log-for-teams) - [macOS Users: "Damaged File" Error Fix](#macos-users-damaged-file-error-fix) - [Usage](#usage) - [Building from source (Linux users)](#building-from-source-linux-users) - [Docker deployment (Self-hosted Web)](#docker-deployment-self-hosted-web) - [Profiles and Password Protection](#profiles-and-password-protection) - [Security Warning (Web/Docker)](#security-warning-webdocker) - [Configuration](#configuration) - [Context Management](#context-management) - [Tech Stack](#tech-stack) - [Project Structure](#project-structure) - [How to obtain your own DJI Developer API key](#how-to-obtain-your-own-dji-developer-api-key) - [Contribution Guidelines](#contribution-guidelines) - [Socials and Support](#socials-and-support) - [Love this project?](#love-this-project) - [License](#license) - [Acknowledgments](#acknowledgments)

## Features - **High-Performance Analytics**: DuckDB-powered queries with automatic downsampling for large datasets. Free, open source, no subscription required. - **Multi-Format Support**: Import DJI logs (.txt), Litchi CSV, and Airdata CSV exports with automatic unit detection. Third-party apps (Dronelink, DroneDeploy) supported. Optional external parser plugins can be configured via `parsers.json`. - **Smart Deduplication**: Prevents duplicate imports based on drone serial, battery serial, and start time. - **Interactive Flight Maps**: 3D terrain, map-type selection (Satellite, Topographic, OpenStreetMap), flight replay with speed control (0.5x-16x), live telemetry overlay, and RC joystick visualization. - **Telemetry Charts**: Height, speed, battery, cell voltages, attitude, RC signal, GPS, distance-to-home, velocity, battery full capacity, and battery remaining capacity with synchronized drag-to-zoom, per-profile telemetry color customization, and collapsible panel controls. - **Local-First Storage**: All data in a local DuckDB database. No cloud upload required (except DJI key fetch during first import). - **Smart Tags**: Auto-tagging (Night Flight, High Speed, Low Battery, etc.) and offline reverse geocoding for location tags. Manual tags and bulk operations supported.on. - **Filters & Search**: Date range (calendar + typed `YYYY-MM-DD` start/end quick entry), drone/battery/controller/color filters, duration/altitude/distance sliders, tag filter, map area filter, and filter inversion. - **Overview Dashboard**: Aggregate stats, activity heatmap, pie charts by drone/battery/duration, time-of-day radial chart, cluster map with optional heatmap layer, and top-flight highlights. - **Battery Health**: Per-battery health bars with cycle count tracking, serial renaming, per-minute usage history with zoom, and battery capacity history chart with multi-select battery dropdown showing full-charge capacity trends over time. - **Maintenance Tracking**: Configurable thresholds with color-coded progress bars and date-based maintenance recording. - **Exports**: CSV, JSON, GPX, KML, and Summary CSV export. FlyCard generator for shareable 1080x1080 social media images. - **HTML Report**: Generate a configurable, print-ready flight regulation report (A4 layout) with selectable field groups, weather data, and day-by-day grouping. Can be printed as PDF via Ctrl+P. Pilot name and field preferences can be customized and will persist across sessions. - **Manual Flight Entry**: Record flights without log files with optional coordinates and metadata. - **Multi-Language Support**: Full internationalization with 11 language locales (English, German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Chinese) and locale-aware number and date formatting. - **Progressive Web App (PWA)**: Optionally install the application directly from the browser for a native-like experience on desktop and mobile. - **Backup & Restore**: Export/import full database across desktop and Docker instances. - **Profile System**: Create multiple profiles to separate flight data by pilot, drone fleet, or purpose. Each profile has its own database, config, uploads, and sync folder.Optionally lock any profile (including the default) with a password. ## Accessing flight log files You first need to collect the supported flight log files that you can import to this application. ### Automated Sync (Windows/Mac) You can sync your DJI flight logs directly from the mobile (Android/iPhone) or RC/RC-2/RC-Pro directly and seamlessly using the `Litchi Hub Bridge` companion app on your Windows/Mac desktop or laptop. This is a free application that lets you sync your flight logs from the phone's DJI Fly app or the RC devices directly to a local folder. #### Download Here - [Windows](https://apps.microsoft.com/detail/9mz7gp4zqlhj) | [MacOS](https://litchi-apks.s3.us-east-1.amazonaws.com/Litchi-Hub-Bridge-mac.dmg) After installation, run it and check the tray menu (it usually gets minimizedto tray after start) - Right click on tray icon and pick settings - Check the `Start with Windows` in `General` tab and go to `Flight Logs Sync` tab to pick a local folder where the logs will be synced. Select the `Auto-sync when a device connects` for a seamless experience. After this setup, as soon as you plug in your RC or Android/iPhone (should be unlocked and mounted to your desktop/laptop) which you use to fly your drones, it will automatically search for the relevant folders and copy the .txt logs from there to your selected local folder. > [!TIP] > After you set up Open Drone Log, you will have an option to pick a Sync folder from where the application (Open Drone Log) syncs files on startup for new log files. If you select the same log folder for both application, you will not have to find or copy new logs manually anymore - it syncs automatically with your Oopen Drone Log application! ### Manual Log collection This project supports modern DJI log files in the `.txt` format. For DJI fly apps on Android or RC remotes, they are usually in `Internal Storage > Android > data > dji.go.v5 > files > FlightRecord`. For iOS, Connect your iPhone/iPad to a computer, open iTunes/Finder, select the device, go to the "File Sharing" tab, select the DJI app, and copy the "Logs" folder. If you are already using other online sync applications, you can download the original logs files directly from there too. You can find more details resources from this simple [google search](https://www.google.com/search?q=where+can+i+find+the+DJI+log+files&oq=where+can+i+find+the+DJI+log+files) Litchi flight logs can be exported as CSV files from the Litchi app. Litchi-imported flights are automatically tagged with "Litchi" for easy filtering. ### Airdata Exports If you use Airdata to sync your flight logs, you can export the original DJI log files directly from the Airdata website: 1. Go to your [Airdata flight logs](https://app.airdata.com/) and click on `my account` 2. In the left sidebar, under `My Data` secction, pick `Download my data` 3. Click **Request Export** and wait for their email with zip containing the `.txt` files These exported log files can then be imported directly into Open DroneLog. ## Setup and installation (Windows/MacOS) There is no installation step if you want to use the standalone binary builds, just visit the latest [release page](https://github.com/arpanghosh8453/open-dronelog/releases), and download the appropriate binary for Windows or MacOS and run them. > [!WARNING] > For macOS, there are [additional steps](#macos-users-damaged-file-error-fix) required before you can use the application. > [!IMPORTANT] > When you are copying from RC or mobile device, you can NOT directly drag and drop the files to the interface. This is because these external devices are mounted differently and only accessible to the file manager. Please copy the files to a local folder or the device sync folder before trying to upload or sync. > [!TIP] > Explore the [full manual](/docs/manual.md) if you want to have a comprehensive overview of all the available options and features inside the app. ### Windows (64-bit) * **`Open.DroneLog_(version)_x64-setup.exe`**: Standard installer. **Best for most users.** * **`Open.DroneLog_(version)_x64_en-US.msi`**: Enterprise installer. For IT admins deploying to multiple PCs. ### macOS *(Files available for both `aarch64` / Apple Silicon and `x64` / Intel)* * **`...dmg`**: Standard disk image. **Best for most users** (drag and drop to Applications). * **`...app.tar.gz`**: Compressed app bundle. A quick, alternative way to download the app without mounting a drive. * **`open-dronelog_darwin_...`**: Command-line binary. For advanced terminal users only. ### Linux (64-bit) * **`Open.DroneLog_(version)_amd64.deb`**: Package for **Ubuntu, Mint, and Debian** systems. * **`Open.DroneLog-(version).x86_64.rpm`**: Package for **Fedora, CentOS, and Red Hat** systems. * **`Open.DroneLog_(version)_amd64.AppImage`**: Universal portable app. Runs on any Linux distro without installing. * **`open-dronelog_linux_x86_64`**: Command-line binary. For advanced terminal users only. ### Android APK Releases Recommended for most users: * **`open-dronelog_(version)_android-universal.apk`**: Universal APK that works on most Android devices. Advanced / smaller download option: * **`open-dronelog_(version)_arm64-v8a_android.apk`**: Modern 64-bit ARM phones/tablets (most current Android devices). * **`open-dronelog_(version)_armeabi-v7a_android.apk`**: Older 32-bit ARM devices. * **`open-dronelog_(version)_x86_64_android.apk`**: 64-bit x86 devices/emulators. * **`open-dronelog_(version)_x86_android.apk`**: 32-bit x86 devices/emulators. If you are unsure which one to use, i