User manual · v0.6.1

Build, automate and troubleshoot your setup.

This guide explains the complete end-user workflow, including every action and condition available in the application.

01

Quick start

  1. Add your Flight Simulator step.Choose MSFS 2024 or MSFS 2020 from Add Flight Simulator.
  2. Add companion applications.Use Add application for vPilot, FSUIPC, MobiFlight, AutoFPS or any other utility.
  3. Choose when each step may continue.For example: process running, SimConnect connected, flight loaded, a TCP connection or a fixed delay.
  4. Add Watchers for event-driven automation.Watchers can react independently when a condition changes and can run one or multiple executions.
  5. Save the profile and run it.Your sequence and Watchers are stored together in the profile.
02

Startup sequence

The Startup Orchestrator runs strictly from top to bottom. For each step, it first performs the action and then waits until its continue condition or conditions are satisfied. Only then does the next step begin.

ALL versus ANYWith all, every configured condition must be true. With any, one true condition is enough to continue.

Phase labels such as Pre-flight, Simulator, After SimConnect, After flight loaded and Other are for organization only. The actual row order controls execution.

Timeout and errors

Each sequence step has a timeout. A timeout of 0 means wait indefinitely. You can choose whether a timeout stops the sequence or continues to the next step. Application/action launch failures can also be configured to either stop or continue.

03

Actions reference

Actions describe what MSFS Startup Manager should do. Most actions can be used both as a sequence step and as a Watcher execution. Availability is shown on each item.

Start application

Sequence + Watcher

Starts a Windows application or shortcut. Supported targets include .exe, .bat, .cmd and .lnk.

Main fields
Application/shortcut, optional arguments, working directory and process name to watch.
Useful options
Skip if already running and choose Normal, UAC, or pre-authorized no-prompt administrator launch.
Sequence extras
Close the app when MSFS exits, or restart it if it closes while MSFS is still running.
Example
F:\vpilot\vPilot.exe with process vPilot.exe.

Open webpage

Sequence + Watcher

Opens a URL in the default Windows browser. If no scheme is entered, the application assumes HTTPS.

Value
A webpage URL.
Example
https://charts.navigraph.com/

Run command

Sequence + Watcher

Starts a Windows shell command. This is useful for scripts, command-line utilities and one-off system commands.

Value
The full command exactly as Windows should execute it.
Example
"C:\Tools\MultiMonitorTool.exe" /LoadConfig "C:\Configs\MSFS.cfg"

Wait / checkpoint only

Sequence only

Performs no launch action. The step exists purely to wait for one or more conditions before the sequence continues.

Typical uses
Wait 10 seconds, wait for SimConnect, wait for a file, or pause until you click Continue.
Tip
Use this when you need a synchronization point without starting another program.

Press UI control (Windows UI Automation)

Sequence + Watcher

Finds a visible application window and invokes a Windows UI Automation control such as a button, checkbox or menu item.

Target
Window title text and/or the target process name.
Control
Control name and/or Automation ID, plus the control type.
Picker
Pick control... lets you hover a control and press F8 to fill in the detected details without clicking it.
Example
Find the GSI window and invoke the button named START.

Send keyboard shortcut

Sequence + Watcher

Activates a visible target window and sends a key or key combination to it.

Target
Window title text and/or process name.
Shortcut
Examples: Ctrl+Shift+C, Alt+S, F5, Enter, Win+1.
Supported keys
Ctrl, Shift, Alt, Win, Enter, Space, Tab, Esc, Backspace, Delete, Insert, Home, End, PageUp/PageDown, arrows, F1–F24 and single letters/numbers.

Click relative position in window

Sequence + Watcher

Clicks a position inside the client area of a visible application window. This is the fallback for interfaces that do not expose useful UI Automation controls.

Target
Window title text and/or process name.
Position
X and Y as percentages from 0 to 100. 0,0 is top-left; 50,50 is the center.
Behavior
The target window is activated, the click is sent, and the mouse cursor is restored afterwards.

Add Flight Simulator — MSFS 2024 / MSFS 2020

Sequence preset

Adds a preconfigured Flight Simulator application step. This is the preferred way to start Microsoft Store/Xbox installations because it avoids trying to open the protected WindowsApps executable directly.

MSFS 2024 process
FlightSimulator2024.exe
MSFS 2020 process
FlightSimulator.exe
Default continue condition
SimConnect connected, with a 300-second timeout.

Stop a process

Watcher only

Stops a running process by executable name, including its process tree where applicable.

Value
The process executable name.
Example
vPilot.exe
Use case
Close a helper program automatically when a Watcher condition becomes true.

Show message

Watcher only

Shows a message from MSFS Startup Manager when a Watcher triggers.

Value
The message text to display.
Example
vPilot connection detected — GSI is ready.
04

Conditions reference

Conditions decide when a sequence step may continue or when a Watcher should trigger. Sequence conditions are checked roughly every 0.75 seconds while a step is waiting. Watchers use their configured check interval.

Watcher availabilityWatchers deliberately do not include sequence-specific conditions such as a fixed step delay, manual Continue, or “the application launched by this step”. They do include a special file-change trigger.

Wait a number of seconds

Sequence only

Becomes true after the specified number of seconds has passed since the step started.

Value
Seconds, for example 10 or 2.5.
Use
Add a minimum settling time after launching an application or interaction.

Wait for me to click Continue

Sequence only

Pauses the sequence until you click the Continue button in the main window.

Value
None.
Use
Manual checkpoints such as “finish aircraft setup before starting the remaining tools”.

Application launched by this step is running

Sequence only

Checks that the application started by the current sequence step is running. If the launch was skipped because the application was already open, the configured process name is used.

Value
None; it uses the current step’s launch information.

Application launched by this step has exited

Sequence only

Becomes true after the process started by the current step has closed.

Value
None.
Use
Run a short helper or script and continue only after it finishes.

A process is running

Sequence + Watcher

Checks Windows for a running executable with the configured process name.

Value
Executable name, for example NavigraphSimlink.exe or vPilot.exe.

A process is not running

Sequence + Watcher

True when the configured executable is not currently running.

Value
Executable name, for example Fenix.exe.
Watcher use
Useful for reacting when an application closes.

A window title contains text

Sequence + Watcher

Searches visible top-level Windows application windows for a title containing the entered text. Matching is case-insensitive.

Value
Part of the title, for example vPilot.

A file exists

Sequence + Watcher

True when the specified file path exists. Windows environment variables are supported.

Value
Full path, for example %TEMP%\addon-ready.txt.

A file was created/modified after this step started

Sequence only

True when the file exists and its modification time is at or after the current step’s start time.

Value
Full path to the file.
Use
Wait for another program or script to create/update a ready marker.

A file is created or changes

Watcher only

Tracks a file’s modification time. An existing unchanged file does not trigger immediately; creating it or changing its modification time produces the trigger.

Value
Full path to the file.
Use
React to log files, marker files or configuration exports being updated.

A URL responds

Sequence + Watcher

Checks whether a web address responds. The application tries a lightweight HEAD request first and falls back to GET. HTTP responses below server-error status are considered reachable.

Value
URL, for example http://localhost:8080/health.
Use
Wait for a local web dashboard or service to become available.

A TCP port is open

Sequence + Watcher

Attempts a TCP connection to the specified host and port. It is true when the connection can be opened.

Value
host:port, for example localhost:8080.
Important
This proves that the endpoint accepts a connection; it does not prove that a particular local process owns a connection to that port.

A custom command returns exit code 0

Sequence + Watcher

Runs a Windows shell command. Exit code 0 means true; any other exit code, an error or a timeout means false. Each check may run for up to about 7 seconds.

Value
A command or PowerShell command line.
Example
powershell.exe -NoProfile -Command "if (Test-Path 'C:\ready.txt') { exit 0 } else { exit 1 }"
Watcher note
The command is rerun on each Watcher check interval until its trigger logic fires.

Microsoft Flight Simulator is running

Sequence + Watcher

True when either MSFS 2024 or MSFS 2020 is detected.

Processes
FlightSimulator2024.exe or FlightSimulator.exe.

Microsoft Flight Simulator is not running

Sequence + Watcher

True only when neither supported Flight Simulator process is running.

Watcher use
Useful for shutdown/cleanup actions after the simulator closes.

SimConnect is connected

Sequence + Watcher

True after MSFS Startup Manager has established its SimConnect client connection to the simulator.

Requires
SimConnect support in the application build and a running simulator.

Simulator is active / user is in control

Sequence + Watcher

Uses the simulator’s active SimStart/SimStop state. It is intended to distinguish being in an active simulation from navigating simulator UI/loading states.

Requires
SimConnect.

A flight is loaded and active

Sequence + Watcher

True when SimConnect is connected, the simulation is active, and aircraft information including the aircraft title is available.

Use
A strong general-purpose trigger for “the flight is ready”.

Aircraft data is available

Sequence + Watcher

True when SimConnect is connected and aircraft data, including an aircraft title, has been received.

Use
Continue once a specific aircraft session exists, even if you do not need the flight-loaded state.

Aircraft title contains text

Sequence + Watcher

Case-insensitive substring match against the aircraft title reported by SimConnect.

Value
Text such as A320, PMDG or another distinctive part of the aircraft title.

Aircraft is on the ground

Sequence + Watcher

True when SimConnect reports SIM ON GROUND as true.

Use
Trigger ground-only tools or actions after landing.

Aircraft is airborne

Sequence + Watcher

True when SimConnect is connected and SIM ON GROUND is false.

Use
Trigger in-flight actions after takeoff.

At least one aircraft engine is running

Sequence + Watcher

Checks the combustion state for engines 1 through 4 and becomes true when at least one engine is running.

Requires
SimConnect.

Simulator is paused

Sequence + Watcher

True while the connected simulator reports a paused state.

Requires
SimConnect.

Simulator is not paused

Sequence + Watcher

True when SimConnect is connected and the simulator is not paused.

Use
Delay an action until the flight has resumed.

Advanced SimConnect variable comparison

Sequence + Watcher

Reads a SimConnect variable and compares it with a value using a simple expression.

Format
VARIABLE | OPERATOR | VALUE
Operators
==, !=, >, >=, <, <=, contains
Examples
AIRSPEED INDICATED | > | 30
AUTOPILOT MASTER | == | 1
TITLE | contains | A320
05

Watchers

Watchers run independently in the background while MSFS Startup Manager is open. They do not block the startup sequence. Each Watcher has one or more conditions and one or more ordered executions.

Trigger behavior

When condition becomes trueFires on a false → true transition. After the condition becomes false again, it can fire on the next transition.
Once per app sessionFires once until the manager is restarted or the Watcher is manually re-armed.
Repeat while condition stays trueCan fire repeatedly while the condition remains true, using the configured cooldown.

Trigger if already true when armed

Enable this if a Watcher should run immediately when its condition is already true at startup or after re-arming. Leave it disabled when you specifically want to wait for a new false → true transition.

Check interval

Controls how often conditions are evaluated. The minimum is 0.25 seconds and the default is 1 second. A custom-command condition is executed again on every check.

Cooldown

Prevents a Watcher from firing again too quickly. This is most important for Repeat while condition stays true.

Action start delay

Waits the configured number of seconds after the trigger before the execution list starts. The Watcher Manager shows a live countdown. A value of 0 starts immediately. Re-arm, disable or edit the Watcher to cancel a pending countdown.

Multiple executions

Use + Add execution to add more actions. They run sequentially from top to bottom after the shared trigger and optional start delay. Use Move up and Move down to control the order. If one execution fails, the remaining executions are not run and the Watcher shows an action error.

Run action now is for testing: it runs the complete execution list immediately and ignores the Watcher start delay.

06

Third-party application interaction

For desktop automation, target a visible window by title text, process name, or both. When both are supplied they must identify the same visible application window.

Press UI control

Use UI Automation whenever the target application exposes a proper button or control. It is generally the most reliable method because it targets the control rather than screen coordinates.

Send keyboard shortcut

Useful when the application already provides a keyboard shortcut. The manager activates the target window before sending the keys.

Click relative position

Use this as a fallback for custom graphical interfaces. Coordinates are relative to the application’s client area, so the action is less dependent on the window’s desktop position.

Recommended reliability orderWindows UI Automation → keyboard shortcut → relative mouse click.
07

SimConnect

SimConnect is optional for general Windows automation but required for simulator-aware conditions. When available, the manager connects/reconnects automatically and displays current simulator, aircraft, ground and engine state at the top of the main window.

Advanced comparison examples:

AIRSPEED INDICATED | > | 30
AUTOPILOT MASTER | == | 1
SIM ON GROUND | == | 0
TITLE | contains | A320
GENERAL ENG COMBUSTION:1 | == | 1
08

Administrator-required applications

Application launches can use one of three privilege modes: Normal, Administrator - ask with UAC, or Administrator - no prompt (pre-authorized).

NormalStarts the application normally as the current user.
Administrator - ask with UACWindows asks for elevation each time the application is launched.
Administrator - no promptAfter one setup approval, a private Windows Scheduled Task launches that specific application elevated without another per-flight UAC prompt.

The no-prompt task runs only as your current logged-in user. No password is stored and it is not run as SYSTEM. If the application, arguments or working directory are changed, run Set up / update no-prompt launch again.

Use Elevated launches in the main window to review or remove created tasks.

09

Profile shortcuts

Create shortcut saves the current profile and creates a Windows .lnk. Opening that shortcut launches MSFS Startup Manager, loads that exact profile and automatically starts its sequence.

The shortcut stays linked to the JSON profile, so later saved changes are picked up automatically. You can create different desktop shortcuts for different aircraft or flight setups.

10

Data and logs

Your user data is stored outside the application:

%USERPROFILE%\MSFS Startup Manager\
    settings.json
    profiles\
    logs\
    elevated_tasks.json

profiles contains your saved sequence/Watcher profiles. logs contains diagnostic history. elevated_tasks.json tracks the pre-authorized administrator launches created by the application.

11

Troubleshooting

An application reports Windows error 740.

The application requires elevation. Edit the application step or Watcher execution and choose Administrator - ask with UAC, or set up Administrator - no prompt.

A Browse window appears stuck.

Click Browse again to be offered the option to close the current picker. A picker is also automatically terminated after 10 minutes if Windows never returns from it.

UI Automation cannot press an elevated app.

Windows can prevent a normal application from controlling an elevated one. Keep both applications at the same privilege level where possible, or use a keyboard shortcut/other integration.

A Watcher condition is already true but does not fire.

Enable Trigger if already true when this watcher is armed if it should fire immediately. Otherwise the default edge behavior waits for the condition to become false and then true again.

A custom-command Watcher never triggers.

Test the command manually and verify that it really returns exit code 0 for the true state and a non-zero code for the false state. Remember that the command is executed by the Windows shell on every Watcher check.

MSFS Store/Xbox executable says access denied.

Do not browse directly to FlightSimulator2024.exe inside WindowsApps. Use the built-in Add Flight Simulator action instead.