Documentation

Complete guide to installing, configuring and extending OpenWar Intelligence — the open source real-time military C4ISR dashboard.

Installation

OpenWar Intelligence is a single HTML file. No build tools, no package manager, no server-side dependencies. There are three ways to deploy it:

Option 1: Direct Download

The simplest method. Register and download the HTML file, then open it in your browser.

# Download the file
# Open monitor-guerra.html in any modern browser
# That's it — the dashboard is running

Option 2: Local HTTP Server (Recommended)

For the best experience with CORS proxy support, serve the file via a local HTTP server:

# Using Python (included batch file)
python -m http.server 8080

# Using Node.js
npx serve -p 8080

# Using PHP
php -S localhost:8080

# Then navigate to http://localhost:8080/monitor-guerra.html

Option 3: Git Clone

git clone https://github.com/openwar-intelligence/dashboard.git
cd dashboard
python -m http.server 8080

Quick Start (5 Minutes)

1. Register and download monitor-guerra.html
2. Place it in any folder on your computer
3. Open in Chrome, Firefox, Edge, or Safari
4. The dashboard loads with simulated data immediately
5. Real data begins streaming in after ~10 seconds (if CORS proxies are available)

System Requirements

Architecture Overview

OpenWar Intelligence follows a single-file architecture philosophy. Everything — HTML structure, CSS styling, JavaScript logic, data models, and SVG assets — lives in one .html file of approximately 4,000 lines.

File Structure

openwar-intelligence/
  ├── index.html              # Landing page
  ├── monitor-guerra.html     # Main C4ISR dashboard
  ├── download.html           # Registration & download
  ├── docs.html               # This documentation
  ├── openwar-logo.svg        # Full brand logo
  ├── openwar-icon.svg        # Icon/favicon
  ├── social-media-kit.html   # Social media assets
  ├── sitemap.xml             # SEO sitemap
  ├── robots.txt              # Crawling directives
  └── AVVIA-MONITOR.bat       # Windows launcher

Data Flow Architecture

The dashboard follows a multi-source data fusion pipeline:

External APIs (FR24, OpenSky, ADSB-X, NASA FIRMS)
    ↓ via CORS Proxy Chain (allorigins → corsproxy → codetabs)
    ↓ Graceful fallback to simulated data
    ↓
Data Parsing & Normalization
    ↓
Feature Groups (Leaflet.js FeatureGroups)
    ├── Aircraft Layer (117+ assets)
    ├── Ships Layer (49+ vessels)
    ├── Satellites Layer (15+ objects)
    ├── Conflict Zones (12 areas)
    ├── SIGINT Layer (A2/AD, GPS jamming)
    ├── Nuclear Layer (SSBNs, silos)
    ├── Maritime Layer (chokepoints)
    ├── FIRMS Layer (thermal hotspots)
    ├── Heatmap Layer (combat activity)
    └── Fusion Alert Layer (cross-correlation)
    ↓
Neural Network (12-24-1, online learning)
    ↓
Predictive Timeline (1h-24h)

Configuration

Data Sources

CORS Proxy Chain

Since the dashboard runs client-side, it uses a triple-fallback CORS proxy chain to access external APIs:

// Primary proxy
https://api.allorigins.win/raw?url=

// Fallback 1
https://corsproxy.io/?

// Fallback 2
https://api.codetabs.com/v1/proxy?quest=

// Final fallback: simulated data generation

Map Tile Layers

Neural Network Configuration

The prediction engine uses a 3-layer feedforward neural network implemented in pure JavaScript:

Architecture: 12 inputs → 24 hidden (sigmoid) → 1 output
Learning rate: 0.01
Training data: 37 historical conflict events
Online learning: Retrained every 60 seconds
Features: troop movements, air activity, naval presence,
          diplomatic signals, economic indicators, FIRMS data

Intelligence Modules Reference

Air Domain Module

Tracks military aircraft using multi-source data fusion. The module maintains a database of 117+ fallback aircraft across 27 nations with 33 callsign prefixes and 10 ICAO hex ranges for automatic military identification.

Aircraft are classified into 6 types with SVG silhouettes: fighter, bomber, transport, reconnaissance, tanker, helicopter. Technical specs are available for 50+ specific models including range, ceiling, payload, and crew.

SIGINT / ELINT Module

Full-spectrum electronic warfare monitoring: 29 A2/AD systems, 7 GPS jamming zones, 10 EW platforms, 9 radar emissions, 7 cyber warfare operations, and 9 EW spectrum bands. Visualizes denied-area environments with bubble overlays, frequency spectrum analysis, and real-time threat classification.

Nuclear Domain Module

Strategic nuclear force monitoring: 10 SSBN patrol zones with missile/warhead details, 12 ICBM silos with regiment data, 8 nuclear bombers (airborne/alert/ground status), 12 C3 command nodes, and 6 nuclear treaties with compliance status. Full posture assessment for 9 nuclear-armed nations with deployed/reserve/retired inventory and first-use doctrine.

Maritime Domain Module

Monitors 49+ naval vessels classified into 6 types: carrier, destroyer, cruiser, frigate, submarine, amphibious. Each type has an SVG silhouette and spec sheet. Tracks 9 global maritime chokepoints with width, depth, oil flow data, blockade risk analysis. Includes 9 naval deployments and 8 recent maritime incidents.

Economic Warfare Module

Monitors 8 sanctions regimes with SWIFT access and asset freeze tracking, 9 strategic commodities with price changes and war impact analysis, and 8 critical supply chains with vulnerability scoring and alternative source mapping. Weighted economic threat index integrates all indicators.

FIRMS / Thermal Intelligence Module

Integrates NASA FIRMS VIIRS satellite data to detect thermal anomalies that may indicate military activity (fires, explosions, artillery, rocket launches). Each hotspot includes direct links to satellite imagery providers:

• Sentinel Hub — High-resolution multispectral imagery
• Copernicus Browser — EU Earth observation data
• NASA FIRMS Map — Official thermal anomaly viewer
• Google Satellite — Commercial satellite imagery

Fusion Alert Engine

The cross-correlation engine monitors 9 signal types and generates alerts when multiple intelligence indicators converge on the same geographic area:

Alert levels: ELEVATED (3+ signals), HIGH (4+ signals), CRITICAL (5+ signals). Each alert is displayed as a sonar-pulse animated marker on the map.

API Reference

OpenWar Intelligence exposes several JavaScript functions for programmatic interaction:

Deployment Guide

GitHub Pages (Free)

1. Fork the repository on GitHub
2. Go to Settings → Pages
3. Select "main" branch, root directory
4. Your dashboard is live at username.github.io/dashboard/

Netlify (Free Tier)

1. Connect your GitHub repo to Netlify
2. No build command needed
3. Publish directory: /
4. Deploy — instant global CDN

Self-Hosted

# Nginx
server {
  listen 80;
  server_name openwar.yourdomain.com;
  root /var/www/openwar;
  index index.html;
  location / { try_files $uri $uri/ =404; }
}

# Apache
DocumentRoot "/var/www/openwar"
DirectoryIndex index.html

Contributing

OpenWar Intelligence is open source and welcomes contributions from developers, analysts, researchers, and OSINT specialists.

How to Contribute

1. Fork the repository on GitHub
2. Create a feature branch: git checkout -b feature/new-module
3. Make your changes
4. Test in multiple browsers
5. Submit a Pull Request with a clear description

Contribution Ideas

• Add new data sources (AIS providers, weather APIs, conflict databases)
• Expand aircraft/ship databases with more models and nations
• Improve neural network with additional training events
• Add new intelligence modules (cyber, space weather, economic)
• Translate the interface (currently English, Italian labels)
• Optimize performance for mobile devices
• Add unit tests for data parsing functions

Changelog

Version 5.0 — May 2026 (C4ISR EXPANDED)

• SIGINT expanded: 29 A2/AD systems, 7 GPS jamming zones, 10 EW platforms, 9 radar emissions, 7 cyber ops, 9 spectrum bands
• Nuclear monitor: 10 SSBN patrols, 12 ICBM silos, 8 nuclear bombers, 12 C3 nodes, 6 treaties
• Maritime chokepoints: 9 detailed profiles with blockade risk, 9 naval deployments, 8 incidents
• Economic warfare: 8 sanctions regimes, 9 commodities, 8 supply chains, weighted threat index
• Fusion Alert Engine expanded to 9 signal types (added NAVAL, CYBER, NUCLEAR)
• Full domain: openwarintelligence.org with landing page, docs, download portal
• SEO: structured data, FAQ schema, Open Graph, sitemap, robots.txt
• Social media launch: 5 platforms, 30-day editorial calendar

Version 2.0 — May 2026

• Expanded to 117 aircraft, 49 ships, 27 nations
• Added Fusion Alert Engine with sonar-pulse markers
• Integrated NASA FIRMS thermal intelligence
• Neural network prediction engine (12-24-1 architecture)
• Aircraft/ship model preview cards with SVG silhouettes
• Satellite imagery links (Sentinel Hub, Copernicus, Planet Labs)
• Combat heatmap layer
• Predictive timeline 1h/3h/9h/12h/24h
• 19 OSINT RSS feeds
• Click-to-map navigation from sidebar

Version 1.0 — March 2026

• Initial release with 55 aircraft, 24 ships
• Basic Leaflet map with military overlays
• RSS news aggregation
• Nuclear domain monitoring
• SIGINT/ELINT layer