Skip to content

Installation

HanskiJay edited this page Mar 27, 2026 · 2 revisions

🧰 Installation & Initialization Guide (Backend - Middleware)

This section will guide you through downloading, installing, and initializing the backend (middleware) for OwO! FlightAssistant.


1️⃣ Download & Installation

On the project’s GitHub homepage, locate the Releases tab on the right-hand side and click to enter.

On the Releases page:

  • Find the version marked with the green “Latest” label
  • Download all zip archives listed under that release

⚠️ Note:
Do NOT download the following files:

  • source code.zip
  • source code.tar.gz

📦 Extraction Steps

Please follow these steps in order:

  1. Extract OwO! FlightAssistant_vxxxxxx.zip to any location on your computer
  2. After extraction, move the archive OwO! FlightAssistant Middleware_vxxxxxx.zip into the extracted folder
  3. Then extract OwO! FlightAssistant Middleware_vxxxxxx.zip

Once completed, you will see: OwO! FlightAssistant Middleware.exe

👉 Double-click to launch the program and enter the backend initialization process

📌 Note:
xxxxxx represents the version number (here shown as a placeholder)


2️⃣ Initialize Backend Program (Middleware)

After launching OwO! FlightAssistant Middleware.exe, you will see the initialization wizard:

init

Follow the on-screen instructions step by step to complete the setup.

2.1 🖥️ Interface & Controls

The backend program uses a BIOS-style interaction design:

  • Operated via keyboard (arrow keys + Enter)
  • A help panel at the bottom shows available key actions

👉 Even first-time users can quickly get familiar with it

2.2 ⚙️ Configuration Process

2.2.1 🌐 Language Settings

First, select the interface language:

lang

How to operate:

  • Select your preferred language
  • Press Enter to confirm
  • The interface will switch instantly

Once confirmed, move to "Next"

2.2.2 🧾 Logger Settings

It is recommended to keep the default settings and proceed.

If you do not want log files to be generated, you may disable this option here.

2.2.3 📂 Simulator Path Detection

The program will automatically scan for:

  • Steam-installed X-Plane 11 / 12
  • Steam-installed MSFS 2020 / 2024

Example of successful detection:

path

⚠️ If X-Plane or MSFS is not detected (especially Microsoft Store version)

You will need to manually input the installation path.
Also, make sure the installation path contains no non-ASCII characters (e.g., Chinese characters) — this is very important!

(Please search online for how to locate installation paths if needed)

📌 Navigation Database (Very Important)

This program does not require Little Navmap itself, but it does require its navigation database:

👉 If you are using MSFS:

  • Download the database from Navigraph:
    https://navigraph.com/downloads
  • File name: little_navmap_navigraph.sqlite
  • Extract it into the backend root directory
  • In the simulator path configuration step:
    • Move the cursor to LittleNavmapDB
    • Press E to enter edit mode
    • Paste (or manually enter) the file path of little_navmap_navigraph.sqlite

👉 If you are using X-Plane:

  • ✅ You can directly use X-Plane’s built-in navigation data (no extra steps needed)

📌 Explanation:

  • X-Plane: navigation data can be read directly
  • MSFS: no public parsing method available → requires Little Navmap database

Illustration:

navdb

2.2.4 🗺️ Navigation Data Source

Select the default airport data source:

source

Recommendation:

  • X-Plane users: choose the corresponding version
  • MSFS users: must complete Little Navmap database setup first, otherwise airport queries will not work

2.2.5 🌐 HTTP API Gateway

This step configures: 👉 Communication between the frontend (App) and backend

Follow the instructions shown in the interface:

api

In most cases:

  • Default settings are sufficient
  • For cross-device access (e.g., mobile), configure your LAN IP

2.2.6 📡 X-Plane Data Listening (X-Plane Only)

udp

Make sure:

  • The backend listening port
  • Matches the UDP port configured in X-Plane

👉 Otherwise, flight data cannot be received

2.2.7 ✅ Setup Complete

After completing all steps, initialization is finished 🎉

The system will:

  • Automatically initialize database cache
  • This may take a few minutes

done1
done2


2.2.8 🚀 Enter Main Interface

After the first initialization is complete, you will see the main interface:

main

2.2.9 🧪 Testing

Now, you can enter any valid ICAO airport code to perform a search.
The backend supports fuzzy matching to help you quickly find your target airport.

test1 test2

Example result (VHHH - Hong Kong International Airport):

test3 test4 test5

👉 At this point, you are ready to start using OwO! FlightAssistant!

🎉 Done!

Congratulations on completing the installation and setup!
You can now launch your simulator, connect the client, and enjoy your flight ✈️

Next Step: Client Configuration

Please visit here.