An open API service indexing awesome lists of open source software.

https://github.com/simplezes/stripcol

Flight strip manager for Vatsim Colombia
https://github.com/simplezes/stripcol

electron flight-management flight-strips javascript nodejs vatsim vatsim-colombia webapp

Last synced: 3 months ago
JSON representation

Flight strip manager for Vatsim Colombia

Awesome Lists containing this project

README

          

# 🛫 StripCol — VATSIM Colombia Strip Hub

![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey?style=for-the-badge)
![Target](https://img.shields.io/badge/VATSIM-Colombia-yellow?style=for-the-badge)

**StripCol** is a high-performance, electronic flight strip management ecosystem custom-built for **VATSIM Colombia (VATCOL)**. It bridges the gap between traditional EuroScope operations and modern web-based interfaces, providing Air Traffic Controllers with a sleek, responsive, and highly functional workspace.

![StripCol Interface](screenshot.png)

## 🏛️ Architecture

StripCol is designed as a modular **three-tier ecosystem** (located in the `src/` directory):

1. **.🔌 EuroScope Plugin (C++)**:
* Direct integration with the EuroScope SDK.
* Exposes real-time flight data via a localized TCP server.
* Handles low-level ATC commands and telemetry.
2. **🌌 Gateway Hub (Node.js)**:
* A central orchestration server (Express & WebSocket).
* Supports session-based pairing via unique **Link Codes**.
* Features a live web console for real-time server monitoring and logs.
3. **🖥️ Desktop Client (Electron)**:
* A professional, high-fidelity UI built for multi-monitor ATC setups.
* Features dynamic panels, custom tooltips, and terminal-style configuration.

---

## ✨ Key Features

* **⚡ Real-Time Synchronization**: Instantaneous updates of aircraft state, altitude, and coordination status.
* **📂 Precision Management**:
* Interactive flight plan modifications (Altitude, Heading, Speed).
* Direct-to point routing and STAR/SID assignments.
* Seamless automated handoffs and frequency transfers.
* **🎨 Pro-Grade UI**:
* Custom-floating tooltips for rapid data inspection.
* Dark-mode optimized for reduced eye strain during long sessions.
* Modular panel layout to fit any sector configuration.
* **📋 Advanced Diagnostics**: Built-in live log viewer at `/api/logs.html` for real-time debugging.

---

## 🚀 Quick Start

### 1. Requirements
* **Node.js** (Latest LTS)
* **EuroScope** v3.2 or later
* **Visual Studio** (if building the plugin from source)

### 2. Installation
```bash
# Clone the repository
git clone https://github.com/Simplezes/StripCol.git

# Install dependencies
npm install
```

### 3. Execution
1. **Launch EuroScope** and load the `StripCol.dll`.
2. **Start the Gateway & Client**:
```bash
npm start
```
3. Enter your **Link Code** in the client settings to pair and start controlling.

---

## 🛠️ Technology Stack

* **Back-End**: Node.js, Express, `ws` (WebSockets)
* **Front-End**: Vanilla JavaScript, CSS3 (Glassmorphism), Bootstrap 5
* **Platform**: Electron
* **Plugin**: C++ (EuroScope SDK)

---

# How do I get a buddy to connect to my session?

StripCol works in a simple **host + client** model.

One computer runs the StripCol server.
The other connects to it.

---

## Step 1 - Choose the Host (Computer A)

Computer A will act as the server.

1. Open the application.
2. Ensure it is running and listening *(seeing if the box in the top left shows "System: Online").*
3. Connect to a position in EuroScope.

*If Computer A wishes to change the gateway IP used by EuroScope...*
```
.stripset 29.94.160.171
```

4. Join your session normally.

Computer A’s local IP (example: `29.94.160.171`) is the address other computers must use.

You can find this by running:

```
ipconfig
```

Look for the IPv4 address.

---

## Step 2 - Configure Computer B

Computer B will connect to Computer A.

1. Open the application.
2. Open Settings → Network and set the gateway IP to Computer A’s IP address.
3. Verify the connection is correct seeing if the box in the top left shows "System: Online".
4. Insert the StripCol session code generated by Computer A.

Now both computers are connected to the same StripCol instance.

---

## Network Requirements

For this to work:

* Both computers must be on the same network
**or**
* The host computer must have its port forwarded if over the internet (Port 3000)
* Windows Firewall must allow StripCol traffic

If connection fails, check:

* Firewall rules
* Correct IP address
* That StripCol is running on Computer A

---

## 📄 License

Distributed under the MIT License.

---

### 🌟 Acknowledgements
* **Author**: Simplezes
* **Organization**: [VATSIM Colombia](https://vatcol.org)
* **Copyright**: © 2026 StripCol Project

---