Usage: fgfs [ option ... ]
For a complete list of options use --help --verbose
General Options
Show the most relevant command line options
Show all command line options when combined with --help or -h
Enable/Disable GUI launcher
Enable/Disable CompositeViewer (extra view windows)
Enable/Disable display the current FlightGear version
Specify the root data path
Specify the scenery path(s);
Defaults to $FG_ROOT/Scenery
Specify additional aircraft directory path(s) (alternatively, you can use --aircraft-dir to target a specific aircraft in a given directory)
Base directory to use for aircraft and scenery downloads (the TerraSync scenery directory may be specifically set with --terrasync-dir)
Select the language for this session
Load recording of earlier FlightGear session. For <name>, if <name> ends with .fgdata it is treated as the local path of the recording file; otherwise we form the local path by prepending <name> with the tape directory and appending ".fgtape". For <url> (starting with http:// or https://) we download the remote recording (which must be a Continuous recording) in the background to a url-dependent filename while replaying it; if the url-dependent filename already exists it is assumed to be a truncated download and we only download any remaining data.
Enable/Disable encode video while replaying tape specified by --load-tape
Set fixed-dt mode while replaying tape specified by --load-tape
Enable/Disable splash screen
Enable/Disable resetting all user settings to their defaults (rendering options etc.)
Enable/Disable saving preferences at program exit
Enable/Disable extra mouse pointer
(i.e. for full screen Voodoo based cards)
Enable/Disable random scenery objects (buildings, etc.)
Enable/Disable random vegetation objects
Enable/Disable random buildings objects
Enable/Disable METAR based real weather fetching
Pass a METAR string to set up static weather (this implies --disable-real-weather-fetch)
Enable/Disable AI subsystem (required for multi-player, AI traffic and many other animations.) Disabling it is deprecated.
Enable/Disable artificial traffic.
Add and enable a new scenario. Multiple options are allowed.
Enable/Disable start in a frozen state
Enable/Disable fuel consumption freeze
Enable/Disable clock freeze
Enable/Disable auto coordination
Specify path to your web browser
Set property <name> to <value>. <type> can be one of string, double, float, long, int, or bool
After starting the simulator, immediately open the properties dialog with the given property
Load additional properties from path
Enable/Disable not loading any default configuration files (like .fgfsrc) unless explicitly specified with --config
Allow Nasal scripts to read files from directories listed as path (separate multiple paths with a semicolon (Windows) or a colon (UNIX)). By default, for security reasons, Nasal scripts can only read data from certain directories, such as $FG_ROOT, $FG_HOME, etc.
Enable/Disable $FG_HOME read-only
Enable/Disable ignoring the autosave file, i.e. the settings saved in this file will not be loaded during startup, nor will the settings be saved to this file when closing the simulator
Use feet for distances
Use meters for distances
Enable/Disable printing a report in JSON format on the standard output, giving information such as the FlightGear version, $FG_ROOT, $FG_HOME, aircraft and scenery paths, etc.
Enable/Disable GUI (disabling GUI enables headless mode)
Log JSBSim properties in a CSV file. An output directives file contains an <output type="CSV"></output> element, within which should be specified the parameters or parameter groups that should be logged.
Specify an additional base data directory (FGData), before the $FG_ROOT directory
Specify a path to addon;
Environment Options
Features
Enable/Disable Heads Up Display (HUD)
Enable/Disable instrument panel
Enable/Disable anti-aliased HUD
Enable/Disable 3D HUD
Enable/Disable virtual reality
Enable/Disable automatic opening of the Launcher when exiting FlightGear
Aircraft
Select an aircraft profile as defined by a top level <name>-set.xml
Same as the --aircraft option
Print a list of the currently available aircraft types
Allows you to define a minimum status level (=development status) for all listed aircraft
Select aircraft livery
Specify the initial state of the aircraft to the given value
Flight Model
Select the core flight dynamics model
Can be one of jsb, larcsim, yasim, magic, balloon, ada, external, or null
Select aircraft aerodynamics model to load
Run the FDM this rate (iterations per second)
Run the FDM 'n' times faster than real time
Enable/Disable not attempting to trim the model
(only with --fdm=jsbsim)
Enable/Disable trim the model
(only with --fdm=jsbsim)
Enable/Disable starting at ground level (default enabled)
Enable/Disable starting in air (implied when using --altitude)
Specify wind coming from DIR (degrees) at SPEED (knots)
Set up random wind direction and speed
Specify turbulence from 0.0 (calm) to 1.0 (severe)
Create an overcast ceiling, optionally with a specific thickness (defaults to 2000 ft).
Specify the exact directory to use for the aircraft (normally not required, but may be useful). Interpreted relatively to the current directory. Causes the <path-cache> from autosave_X_Y.xml, as well as --fg-aircraft and the FG_AIRCRAFT environment variable to be bypassed.
Initial Position and Orientation
Specify starting position relative to an airport
Specify parking position at an airport (must also specify an airport)
Same as the --parking-id option
Specify starting position on an AI carrier
Specify a starting position relative to the carrier where you can use the predefined abeam (start on downwind abeam) or FLOLS (start on final approach) values, or specify the name of the carrier's parking position. Must also specify a carrier.
Specify starting position relative to a VOR
Specify the frequency of the VOR. Use with --vor=ID
Specify starting position relative to an NDB
Specify the frequency of the NDB. Use with --ndb=ID
Specify starting position relative to a fix
Specify starting runway (must also specify an airport)
Specify distance to reference point (nautical miles)
Specify heading to reference point
Starting longitude (west = -)
Starting latitude (south = -)
Starting altitude
Specify heading (yaw) angle (Psi)
Specify roll angle (Phi)
Specify pitch angle (Theta)
Specify velocity along the body X axis
Specify velocity along the body Y axis
Specify velocity along the body Z axis
Specify velocity along a South-North axis
Specify velocity along a West-East axis
Specify velocity along a vertical axis
Specify initial airspeed
Specify initial mach number
Specify flight path angle (can be positive)
Specify initial climb rate (can be negative)
Enable/Disable the move to hold short position for multiplayer
Audio Options
Enable/Disable sound effects
Show a list of available audio device
Explicitly specify the audio device to use
Rendering Options
Set graphic options from one of the presets
Specify the path to XML file for multi-pass rendering. The path is relative to $FG_ROOT (defaults to Compositor/default.xml).
Specify the bits per pixel
Disable fog/haze
Enable fastest fog/haze
Enable nicest fog/haze
Enable/Disable celestial body growth illusion near the horizon
Enable/Disable runway light distance attenuation
Enable/Disable specular reflections on textured objects
Enable/Disable 2D (flat) cloud layers
Enable/Disable 3D (volumetric) cloud layers
Specify field of view angle
Specify a multiplier for the aspect ratio.
Enable/Disable fullscreen mode
Enable flat shading
Enable smooth shading
Specify the materials file used to render the scenery (default: Materials/regions/materials.xml)
Anisotropic Texture Filtering: values should be 1 (default), 2, 4, 8 or 16
Enable/Disable wireframe drawing mode
Specify window geometry (640x480, etc)
Specify the default forward view direction as an offset from straight ahead. Allowable values are LEFT, RIGHT, CENTER, or a specific number in degrees
Specify initial visibility in meters
Specify initial visibility in statute miles
Maximum frame rate in Hz.
Enable/Disable texture cache (DDS)
Specify the DDS texture cache directory to be different than the default location
Specify the terrain engine you want to use: tilecache or pagedLOD
Specify the detail levels, where levels are a space-separated numeric list of levels. The default is "1 3 5 7 9".
Specify the resolution of the terrain grid. Defaults is 1.
Specify the method of texturing the terrain. The default is bluemarble.
Specify the range multiplier (point from low to fine detail). Defaults is 2.
Use with --terrain-engine=pagedLOD
Hud Options
Hud displays number of triangles rendered
Hud displays percentage of triangles culled
Time Options
Specify a time of day
Add this time offset
Synchronize time with real-world time
Synchronize time with local real-world time
Specify a starting date/time with respect to
system time
GMT
local aircraft time
Network Options
Enable http server on the specified address. Specify the port or address:port to bind to.
Specify which proxy server (and port) to use. The username and password are optional and should be MD5 encoded already. This option is only useful when used in conjunction with the real-weather-fetch option.
Enable telnet server on the specified port
Enable screen shot http server on the specified port (replaced by --httpd)
Enable/Disable automatic scenery downloads/updates
Set target directory for scenery downloads
Enable/Disable FGCom built-in
Enable/Disable security flag. Enable means that network connections will be allowed full access to the simulator including running arbitrary scripts. Ensure you have adequate security (such as a firewall which blocks external connections).
Enable/Disable crash and error reports from being sent to the development team for analysis
MultiPlayer Options
Specify multipilot communication settings;
Assign a unique name to a player
Route/Way Point Options
Specify a waypoint for the GC autopilot;
Read all waypoints from a file
IO Options
Emit the Garmin AV400 protocol required to drive a Garmin 196/296 series GPS
Emit the set of AV400 strings required to drive a Garmin 400-series GPS from FlightGear
Open connection for "A" channel using Garmin WAAS GPS protocol
Open connection for "B" channel using Garmin WAAS GPS protocol
Open connection using the Atlas protocol
Open connection using the ATC sim protocol (atc610x)
Open connection using the Flarm protocol, which includes NMEA/GPS and traffic reporting messages
Open connection using the Garmin GPS protocol
Open connection using the International Gliding Commission protocol
Open connection to an Agwagon joystick
Open connection to a remote joystick
Open connection using the FG Native Controls protocol
Open connection using the FG Native FDM protocol
Open connection using the FG Native GUI protocol
Open connection using the FG Native protocol
Open connection using the NMEA protocol
Open connection using a predefined communication interface and a preselected communication protocol
Open connection using the OpenGC protocol
Open connection using the interactive property manager
Open connection using the PVE protocol
Open connection using the Ray Woodworth motion chair protocol
Open connection using the RUL protocol
Avionics Options
Set the COM1 radio frequency
Set the COM2 radio frequency
Set the NAV1 radio frequency, optionally preceded by a radial.
Set the NAV2 radio frequency, optionally preceded by a radial.
Set the ADF1 radio frequency, optionally preceded by a card rotation.
Set the ADF2 radio frequency, optionally preceded by a card rotation.
Slave the DME to one of the NAV radios, or set its internal frequency.
Situation Options
Fail the pitot, static, vacuum, or electrical system (repeat the option for multiple system failures).
Debugging Options
Enable/Disable displaying console (Windows specific)
Enable/Disable developer mode
Enable/Disable aborting on encountering a floating point exception
Use a model viewer rather than load the entire simulator
Trace the reads for a property;
Trace the writes for a property;
Specify which logging level to use
Specify which logging class(es) to use
Log to directory DIR. The special value 'desktop' causes logging to the desktop (OS-dependent location). This option may be given several times, using a different value each time. Inside the specified directory, the written log file is named FlightGear_YYYY-MM-DD_<num>.log, where <num> takes the values 0, 1, 2, etc.
Remove $FG_HOME directory. For Windows, it additionally removes TerraSync, Aircraft and TextureCache directories from download directory.
multiple instances can be used