Quick start
- Add your Flight Simulator step.Choose MSFS 2024 or MSFS 2020 from Add Flight Simulator.
- Add companion applications.Use Add application for vPilot, FSUIPC, MobiFlight, AutoFPS or any other utility.
- Choose when each step may continue.For example: process running, SimConnect connected, flight loaded, a TCP connection or a fixed delay.
- Add Watchers for event-driven automation.Watchers can react independently when a condition changes and can run one or multiple executions.
- Save the profile and run it.Your sequence and Watchers are stored together in the profile.
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.
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.
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 + WatcherStarts 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.exewith processvPilot.exe.
Open webpage
Sequence + WatcherOpens 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 + WatcherStarts 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 onlyPerforms 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 + WatcherFinds 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 + WatcherActivates 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 + WatcherClicks 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,0is top-left;50,50is 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 presetAdds 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 onlyStops 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 onlyShows a message from MSFS Startup Manager when a Watcher triggers.
- Value
- The message text to display.
- Example
vPilot connection detected — GSI is ready.
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.
Wait a number of seconds
Sequence onlyBecomes true after the specified number of seconds has passed since the step started.
- Value
- Seconds, for example
10or2.5. - Use
- Add a minimum settling time after launching an application or interaction.
Wait for me to click Continue
Sequence onlyPauses 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 onlyChecks 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 onlyBecomes 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 + WatcherChecks Windows for a running executable with the configured process name.
- Value
- Executable name, for example
NavigraphSimlink.exeorvPilot.exe.
A process is not running
Sequence + WatcherTrue 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 + WatcherSearches 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 + WatcherTrue 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 onlyTrue 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 onlyTracks 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 + WatcherChecks 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 + WatcherAttempts a TCP connection to the specified host and port. It is true when the connection can be opened.
- Value
host:port, for examplelocalhost: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 + WatcherRuns 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 + WatcherTrue when either MSFS 2024 or MSFS 2020 is detected.
- Processes
FlightSimulator2024.exeorFlightSimulator.exe.
Microsoft Flight Simulator is not running
Sequence + WatcherTrue only when neither supported Flight Simulator process is running.
- Watcher use
- Useful for shutdown/cleanup actions after the simulator closes.
SimConnect is connected
Sequence + WatcherTrue 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 + WatcherUses 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 + WatcherTrue 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 + WatcherTrue 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 + WatcherCase-insensitive substring match against the aircraft title reported by SimConnect.
- Value
- Text such as
A320,PMDGor another distinctive part of the aircraft title.
Aircraft is on the ground
Sequence + WatcherTrue when SimConnect reports SIM ON GROUND as true.
- Use
- Trigger ground-only tools or actions after landing.
Aircraft is airborne
Sequence + WatcherTrue 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 + WatcherChecks the combustion state for engines 1 through 4 and becomes true when at least one engine is running.
- Requires
- SimConnect.
Simulator is paused
Sequence + WatcherTrue while the connected simulator reports a paused state.
- Requires
- SimConnect.
Simulator is not paused
Sequence + WatcherTrue when SimConnect is connected and the simulator is not paused.
- Use
- Delay an action until the flight has resumed.
Advanced SimConnect variable comparison
Sequence + WatcherReads a SimConnect variable and compares it with a value using a simple expression.
- Format
VARIABLE | OPERATOR | VALUE- Operators
==,!=,>,>=,<,<=,contains- Examples
AIRSPEED INDICATED | > | 30AUTOPILOT MASTER | == | 1TITLE | contains | A320
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
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.
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.
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
Administrator-required applications
Application launches can use one of three privilege modes: Normal, Administrator - ask with UAC, or Administrator - no prompt (pre-authorized).
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.
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.
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.
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.