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
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
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
Use feet for distances
Use meters for distances
Display console (Windows specific)
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.
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
Aircraft
Select an aircraft profile as defined by a top level <name>-set.xml
Print a list of the currently available aircraft types
Allows you to define a minimum status level (=development status) for all listed aircraft
Select an vehicle profile as defined by a top level <name>-set.xml
Select aircraft livery
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.
Aircraft model directory (UIUC FDM ONLY)
Initial Position and Orientation
Specify starting position relative to an airport
Specify parking position at an airport (must also specify an airport)
Specify starting position on an AI carrier
Start on downwind abeam the selected carrier (must also specify a carrier)
Specify which starting position on an AI carrier (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 (statute 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)
Audio Options
Disable sound effects
Enable sound effects
Show a list of available audio device
Explicitly specify the audio device to use
Rendering Options
Enable Rembrandt rendering
Disable Rembrandt rendering
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
Specify initial visibility in miles
Maximum frame rate in Hz.
Hud Options
Hud displays number of triangles rendered
Hud displays percentage of triangles culled
Time Options
Specify a time of day
Specify the startup season
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
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
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 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 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
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.