Skip to content

Spearhead2/OpenACMI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenACMI

Free, open-source ACMI flight recording viewer and real-time telemetry monitor.

A community-built alternative to Tacview - replay your flights, analyse engagements, and monitor live telemetry from any simulator or data source that speaks the ACMI 2.x protocol.


Why OpenACMI?

Tacview is excellent software - but it's closed-source, expensive at the Advanced tier, and gives you little control over how your data is processed or displayed. OpenACMI aims to change that.

  • Free, forever. No subscriptions, no feature tiers.
  • Open source. Understand exactly what happens to your data. Extend it, fork it, contribute back.
  • Cross-platform. Runs on Windows, Linux, and macOS.
  • Full ACMI 2.x support. Any simulator that can export to Tacview can export to OpenACMI - DCS World, Falcon BMS, IL-2, X-Plane, FSX, and more.
  • Real-time streaming. Connect directly to a live telemetry server and watch engagements unfold as they happen.
  • Built on the Godot Game Engine. Free Open Source game engine in a great state to serve the purpose of this task.

Features

3D Globe Visualisation

  • Photorealistic Earth sphere with real-world country borders and lat/lon grid
  • Accurate object placement and orientation using geodetic coordinate math
  • Automatic projection of flat simulated worlds to the 3D globe
  • Smart model scaling - objects remain visible at any zoom level

ACMI 2.x Parser

  • Full implementation of the ACMI 2.2 specification
  • Supports all object types: aircraft, helicopters, ground vehicles, ships, weapons, projectiles, navaids, static objects
  • Parses all documented properties - radar, engagement ranges, G-forces, fuel, control surfaces, pilot biometrics, and more
  • Delta-state handling - omitted fields correctly carry forward from previous frames
  • Loads plain .acmi, ZIP-compressed .acmi.zip, and auto-detects format from file contents

Real-Time Telemetry

  • Connects to any Tacview-compatible real-time telemetry server
  • Full handshake protocol implementation
  • Displays live data as it streams and saves it to file
  • Seamlessly transitions between live and recorded playback

Timeline & Playback

  • Scrub through any recording with a timeline slider
  • Smooth interpolation between snapshots for fluid playback
  • Frame-step forward and backward
  • All object visibility correctly driven by spawn/removal times - missiles appear when fired and disappear on impact

3D Models

  • Automatic model resolution: exact name matching, variant suffix stripping, type-tag fallback
  • Coalition-aware object coloring - blue, red, neutral forces are visually distinct at a glance
  • Bring your own .obj models - drop them in Data/Meshes/ and they're picked up automatically

Camera Modes

  • Global orbit - rotate around the Earth freely
  • Tracking - follow any object from behind with adjustable offset
  • Cockpit - ride inside the selected aircraft with full pitch and roll
  • Free flight - fly through the scene with WASD controls

Telemetry Panel

  • Data grid showing all available telemetry: position, altitude, heading, speed, G-force, AOA, turn rate, vertical speed, Mach, and more
  • Derived values where direct telemetry is unavailable - G-force from turn rate and airspeed, TAS from IAS and altitude, etc.
  • All information panels support docking / undocking from main window

Getting Started

More information will become available along with the initial source release.


Supported Simulators

OpenACMI aims to support any simulator with a Tacview exporter that works out of the box or with :

Simulator Export Method
DCS World DCS2ACMI
Falcon BMS Built-in ACMI export
IL-2 Sturmovik Built-in ACMI export
X-Plane Tacview plugin
MSFS / FSX Tacview plugin
Any source Any server speaking the real-time telemetry protocol

Key files

File Purpose
ACMI_Parser.gd Full ACMI 2.x parser
WorldManager.gd Session state, typed object dictionaries
cBaseObject.gd Base class for all tracked objects
cAircraftObject.gd Aircraft with full aerodynamic properties
cWeaponObject.gd cGroundObject.gd etc. Typed subclasses
cEventObject.gd Event log entries
Display3D.gd Main 3D viewport - globe, objects, camera
MeshLibrary.gd Resolves and caches 3D models by name and type
ClientBase.gd Real-time telemetry TCP client
FileManager.gd Basic file operations (loading/saving, recent files)
Config.gd All user preferences with change signals
ObjectTag.gd ACMI type tag constants

General Roadmap

  • Windows, Linux, macOS release builds
  • Exports of object telemetry to .csv
  • Support for flat world non-real terrains for sims like Nuclear Option
  • Charting of object telemetry
  • Performance Improvements
  • Save live data to file
  • Enhanced 2D plan view
  • Display of radar locks
  • Events Log and visualization
  • Weapons employment log and shot analysis
  • Localization
  • Tile map support - stream satellite or terrain imagery from NASA, Maptiler, Stadia, or any XYZ tile provider
  • Use local game terrain heightmaps for enhanced 3D visualization
  • Multi-session overlay (compare two recordings)
  • Plugin API for custom data sources
  • Database XML support (Tacview-compatible object definitions)
  • Screenshot / video export
  • Connection to ADS-B Data
  • Multiplayer debrief mode (shared session over LAN)
  • Multiplayer live controller mode (Custom display for live feeds)
  • Implementation for *.oacm (OpenACMI File Pack) for more functionality
  • File editing (Adding objects, changing parameters, etc.)
  • Attachmet of cockpit display recordings to the recording (Part of *.oacm file)

Have another idea? Post it in an issue!


Contributing

Contributions of all kinds are welcome - code, bug reports, 3D models, simulator-specific testing, documentation.
More information will become available along with the initial source release.


License

MIT License - see LICENSE for details.

You are free to use, modify, and distribute OpenACMI for any purpose, including commercial applications.


Acknowledgements

  • Tacview by Frantz 'Vyrtuoz' Raia - for the inspiration and ACMI format specification that makes this possible.
  • The Falcon BMS, DCS World, and IL-2 communities - for years of ACMI tooling, exporters, and feedback
  • Natural Earth - country border data
  • NASA Earthdata / GIBS - satellite imagery

OpenACMI is an independent open-source project and is not affiliated with Tacview or RaiaSoftware.
© Amir "Spearhead" Levy & Contributors

About

Open Source ACMI (Advanced Combat Maneuvering Instrumentation) Visualizer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors