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
Use GUI launcher
Enable CompositeViewer (extra view windows)
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.
Encode video while replaying tape specified by --load-tape
Set fixed-dt mode while replaying tape specified by --load-tape
Disable splash screen
Enable splash screen
Reset all user settings to their defaults (rendering options etc)
Don't save preferences upon program exit
Allow saving preferences at program exit
Disable extra mouse pointer
Enable extra mouse pointer
(i.e. for full screen Voodoo based cards)
Exclude random scenery objects
Include random scenery objects
Exclude random vegetation objects
Include random vegetation objects
Exclude random buildings objects
Include random buildings objects
Disable METAR based real weather fetching
Enable METAR based real weather fetching (this requires an open internet connection)
Pass a METAR string to set up static weather (this implies --disable-real-weather-fetch)
(buildings, etc.)
Deprecated option (disable internal AI subsystem)
Enable AI subsystem (required for multi-player, AI traffic and many other animations)
Disable artificial traffic.
Enable artificial traffic.
Add and enable a new scenario. Multiple options are allowed.
Start in a running state
Start in a frozen state
Fuel is consumed normally
Fuel tank quantity forced to remain constant
Clock advances normally
Do not advance clock
Enable auto coordination
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.
Load additional properties from path
Do not load 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.
Make $FG_HOME read-only
Ignore 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
Print 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 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
Disable Heads Up Display (HUD)
Enable Heads Up Display (HUD)
Disable instrument panel
Enable instrument panel
Disable anti-aliased HUD
Enable anti-aliased HUD
Disable 3D HUD
Enable 3D HUD
Disable VR
Enable VR
Open Launcher automatically 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
Do NOT attempt to trim the model
(only with fdm=jsbsim)
Trim the model
(only with fdm=jsbsim)
Start at ground level (default)
Start 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)
Disable the move to hold short position for multiplayer
Audio Options
Disable sound effects
Enable 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
Disable celestial body growth illusion near the horizon
Enable celestial body growth illusion near the horizon
Disable enhanced runway lighting
Enable enhanced runway lighting
Disable runway light distance attenuation
Enable runway light distance attenuation
Disable specular reflections on textured objects
Enable specular reflections on textured objects
Enable 2D (flat) cloud layers
Disable 2D (flat) cloud layers
Enable 3D (volumetric) cloud layers
Disable 3D (volumetric) cloud layers
Specify field of view angle
Specify a multiplier for the aspect ratio.
Disable fullscreen mode
Enable fullscreen mode
Enable flat shading
Enable smooth shading
Disable textures
Enable textures
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
Disable wireframe drawing mode
Enable 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.
Disable texture cache (DDS)
Enable 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)
Disable automatic scenery downloads/updates
Enable automatic scenery downloads/updates
Set target directory for scenery downloads
Enable FGCom built-in
Disable FGCom built-in
Remove security flag, which 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).
Disable crash and error reports from being sent to the development team for analysis
Enable crash and error reports to be 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
Display console (Windows specific)
Enable developer mode
Abort 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