InteractiveChecklists
Companion and standalone Android app for DCS-World Flightsimulator with map-based route planning and navigation, marker management, interactive Markdown/PDF checklists, annotations, notes, tab support, and live telemetry display (DataPad). Implemented using Jetpack Compose.
Install / Use
/learn @arn-c0de/InteractiveChecklistsREADME
<strong>APP</strong> <img src="https://img.shields.io/badge/version-1.0-blue.svg" alt="Version" /> <img src="https://img.shields.io/badge/platform-Android-green.svg" alt="Platform: Android" /> <img src="https://img.shields.io/badge/built_with-Jetpack%20Compose-orange.svg" alt="Jetpack Compose" />
<br/><strong>PYTHON TOOLS</strong> <img src="https://img.shields.io/badge/platform-Windows-0078D6?logo=windows&logoColor=white" alt="Platform: Windows" /> <img src="https://img.shields.io/badge/language-Python-3776AB?logo=python&logoColor=white" alt="Python" />
</p><div align="center"> <a href="README.md">English</a> | <a href="/docs/ZH/README_zh.md">Chinese (Simplified)</a> </div> <div align="center"> <a href="CHANGELOG.md">Changelog</a> | <a href="docs/EN/docnavigation.md">Documentation</a> | <a href="docs/EN/planning/roadmap.md">Roadmap</a> | <a href="SECURITY.md">Security Policy</a> | <a href="LICENSE">License</a> | <a href="CONTRIBUTING.md">Contributing</a> <a href="COLLABORATORS.md">Collaborators</a> </div> <div align="center"> <a href="THIRD_PARTY_LICENSES.md">Third-Party Licenses</a> </div> <p align="center"> <a href="#screenshots">Screenshots</a> • <a href="#demo-videos">Demo Videos</a> </p>Current Development Status – Aviation Map & DataPad Features
(February 2026)I'm currently not actively working on the Aviation Map, live DataPad / telemetry, or tactical units features, because I do not have DCS World installed right now and cannot verify / test > whether changes still work or break functionality.
The topic will definitely be continued in the future once I have a proper DCS test environment again.
If anyone is interested in actively contributing, testing, or submitting pull requests in the meantime → very welcome!
I will happily look at everything, review code / changes, and give feedback in English.Thanks for your understanding and patience 🙏
o7
InteractiveChecklists
InteractiveChecklists is an Android application for viewing and interacting with Markdown and PDF checklists. It is built with Jetpack Compose and follows an MVVM-style architecture. It is designed to be extensible with an interactive aviation map featuring live DCS data integration, tactical markers, and dynamic route and pattern calculation. Runway heading–based approach visualization and real-time map updates enable enhanced situational awareness during flight operations.
Development status: This repository is a development version and not an official release. The app is functional but under active development and may contain experimental features.
Note: A preview APK for version 1.1 is planned. If you are not familiar with Android Studio or building apps from source, please wait for the official preview release to test the app.
Table of Contents
- Features
- Screenshots
- Demo Videos
- Installation
- System Requirements
- How to Build & Run
- Key Components
- Contributing
- Support & Contact
- FAQ
- Acknowledgements & Credits
- License
Features
-
Unified File System: Manage files from bundled assets and internal storage in a single hierarchical view.
-
Multilanguage Support: The app supports English, Spanish and German. You can switch the language in the Settings menu. All UI text is available in English.
-
Multi-Tab System: Open multiple documents (MD/PDF) with a scrollable tab bar, quick tab switcher, swipe navigation, and tab persistence.
-
PDF Viewer: PDF viewer with annotations (draw/highlight/erase), pinch-to-zoom, page snapping, and color inversion.
-
Interactive Markdown Checklists: Stateful checkboxes and collapsible sections for interactive checklists.
-
Tagging System: Assign tags to files for filtering and organization.
-
QuickNotes: Persistent notes powered by Room, with search, autosave, and markdown support.
-
Data Persistence: Stores user preferences, annotations, shortcuts, tags, and open tabs locally.
-
Aviation Map (experimental): OpenStreetMap-based map viewer with live aircraft position tracking from the DataPad stream. Adds a
MapViewertab showing aircraft position, heading, altitude and basic overlays — see docs/EN/features/AVIATION_MAP_FEATURE.md for details and configuration. -
DataPad (experimental): Live flight telemetry display (UDP) for DCS World. Streams aircraft telemetry to the app for realtime status and popup details — see docs/EN/features/DATAPAD_FEATURE.md for full details and setup instructions.
-
Tactical Units Tracking (experimental): Live tactical unit markers (aircraft, helicopter, ground, ship) on the map with real-time updates. Marker popups include "Last seen" timestamps and refresh snippets with speed/altitude. A "Live Units Only" filter (shows units seen in the last 10s) is synchronized between the list and the map. See docs/EN/features/TACTICAL_UNITS_TRACKING.md and scripts/DCS-SCRIPTS-FOLDER-Experimental/README_ENTITY_TRACKING.md for setup and details.
-
MapDatabaseTools (Python): A collection of Python utilities for receiving, decrypting (AES-GCM), and visualizing DCS flight telemetry. Includes a PySide6 GUI with an embedded OpenStreetMap/Leaflet map for live aircraft tracking, a marker database, and helper scripts to manage map assets. See
scripts/MapDatabaseTools/README.mdfor usage and configuration. -
Supported maps (marker DB):
| Map | Status | Notes | | --- | --- | --- | | Caucasus | Supported | Marker set available in DB | | Marianas | Supported | Marker set available in DB | | Germany (CW) | Mostly Supported | Marker addition in progress |
Roadmap
Planned features and long-term improvements are tracked in the Roadmap document.
Quick Start – Windows (Recommended & Easiest)
Install the DCS Export Script (Automatic via GUI Installer)
The GUI installer now automatically installs Export.lua to your DCS Scripts folder during the setup wizard.
Features:
- Auto-detection of DCS Saved Games folder
- Version detection - Shows current and new version
- Backup creation - Automatically backs up existing Export.lua
- Version comparison - Prompts before overwriting if Export.lua already exists
- Optional skip - Can skip installation if you prefer manual installation
Manual Installation (Alternative):
If you prefer to install manually or skipped the wizard step:
- Copy
Export.luafromscripts/DCS-SCRIPTS-FOLDER-Experimental - Paste into your DCS Scripts folder:
%USERPROFILE%\Saved Games\DCS\Scripts\
This script enables DCS to write entity batches and player telemetry files into a subfolder that the Python forwarder reads.
After installation (automatic or manual):
- Start or reload your mission, or
- Restart DCS
to activate the export script.
Important Note – Python Requirement
The Python forwarder (DataPad Server) requires a local Python installation.
-
On Windows, installing Python via the Microsoft Store (Python 3.12+) is recommended for simplicity.
-
The GUI installer (run_installer.bat) automatically:
- Creates a virtual environment (venv) if not present
- Installs all required Python packages into that environment
- Detects your DCS installation and Saved Games folder
- Configures network settings and firewall rules (optional) This keeps dependencies isolated and clean.
-
To update packages: re-run
run_installer.bat -
To remove everything: delete the created
venvfolder
Initial Setup (GUI Installer)
-
Navigate to the folder:
/scripts/DCS-SCRIPTS-FOLDER-Experimental -
Start the GUI installer – double-click:
run_installer.bat→ The GUI will automatically install dependencies and open the installer window (first run takes 1–2 minutes to install packages)
-
First-Time Setup Wizard (appears on first run):
- The wizard will guide you through:
- DCS Installation Detection – Auto-detects your DCS installation
- Export.lua Installation – Automatically copies Export.lua to DCS Scripts folder with version detection
- Dependency Installation – Installs required Python packages
- Server Configuration – Configure network settings (bind IP, ports, etc.)
- Firewall Setup (optional) – Add Windows Firewall rules for server ports
- The wizard will guide you through:
-
After setup is complete, the main installer window opens with tabs:
- Dashboard – Server status and control (Start/Stop server)
- Device Management – Manage authorized devices and generate QR codes
- Server Configuration – Network and security settings
- Installation Settings – DCS paths and file locations
- Health Checks – System diagnostics and firewall configuration
- Logs – Real-time server log viewer
