Command line options: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
(→‎Rendering Options: alignment with other options)
 
(135 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{note|This article presents the current command line options, including the development version. To check the options for '''FlightGear version 2020.3.x''', see the [[Command line options 2020.3]] article.}}
'''Command line options''' are a common way to tell applications what to do/how to act on startup. With [[FlightGear]] they are used for many things, from simple ones like selecting an aircraft up to complex stuff like network traffic and weather parameters.
'''Command line options''' are a common way to tell applications what to do/how to act on startup. With [[FlightGear]] they are used for many things, from simple ones like selecting an aircraft up to complex stuff like network traffic and weather parameters.


The easiest way to handle those options for FlightGear is using a tool with a graphical user interface like the [[FlightGear Qt launcher]]. This way one doesn't have to bother about them at all.
The easiest way to handle those options for FlightGear is using a tool with a graphical user interface like the [[FlightGear Qt launcher]]. This way one doesn't have to bother about them at all.


However, there are users who don't want or are not able to run a GUI and therefore are interested in this. Those who need them or just want to learn more about FlightGear, but have no idea what we are talking about, may read the wiki page on the general usage of the [[command line]].
However, there are users who don't want or are not able to run a GUI and therefore are interested in this. Those who need them or just want to learn more about FlightGear, but have no idea what we are talking about, may read the wiki page on the general usage of the [[command line]]. The launcher GUI works by setting command-line options for the options you choose. Try different options and see what the launcher sets from menu in Qt launcher <code>*** > View command-line</code> or by use {{Key press|Ctrl|L}} keyboard shortcut.


A good place to store the personal options is a file called [[fgfsrc]]. This file is read by FlightGear on each startup.
A good place to store the personal options is a file called [[fgfsrc]]. This file is read by FlightGear on each startup.
Line 13: Line 15:
The file [[$FG_ROOT]]/options.xml is used to generate the output for <code>fgfs --help [--verbose]</code>. That's the reason why <code>--fg-root=[path]</code> has to be added to this, if it is not set as environmental variable or as option in fgfsrc.
The file [[$FG_ROOT]]/options.xml is used to generate the output for <code>fgfs --help [--verbose]</code>. That's the reason why <code>--fg-root=[path]</code> has to be added to this, if it is not set as environmental variable or as option in fgfsrc.


Usage in terminal: <code>fgfs [OPTION [OPTION ...]]</code>
The way to use options by [[FlightGear Qt launcher|Qt Launcher]]: go to the "Settings" tab and in the "Additional Settings" section enter the following options, each on a new line. The options entered there take precedence over those defined by Qt Launcher. To see the entire list of command line options used by Qt Launcher, use the keyboard shortcut {{Key press|Ctrl|L}} or select "View command-line" from the Launcher menu.
= Legend how to read the following options =
# <code>--option1</code> (<code>--option2</code>) - in this case <code>--option2</code> is the aliast for <code>--option1</code> which is exactly the same as <code>--option1</code>.
# <code>--option1</code><br/><code>--option2</code> - two different options, mutually exclusive. They cannot be used simultaneously, but are connected due to a common description.
# <code>--option1</code>, <code>--option2</code> - two different options that can be used simultaneously and are connected due to a common description.
= Values for options =
Some options do not require a value, such as <code>--help</code>, but there are options for which we must specify a value, such as <code>--fg-root</code>, as well as there are options for which we can optionally specify a value, such as for <code>--launcher</code>. We can separate the value from the option with either the <code>=</code> sign or a space, such as:
    --fg-root=/path/to/fgdata
    --fg-root /path/to/fgdata
Options that act like an enable/disable switch take optional values as <code>true</code>, <code>1</code>, <code>yes</code> (enable) or <code>false</code>, <code>0</code>, <code>no</code> (disable). If we don't specify any value next to such an option, it will work by default as if we passed <code>true</code>, <code>1</code> or <code>yes</code>, i.e. enabled it, e.g:
    --launcher
will enable Launcher, which is equivalent to:
    --launcher=yes
On the other hand, we can also pass a value that disables the option, e.g.:
    --launcher=no
which will cause Launcher not to be launched. In addition, most of such options have two additional versions without a value, but preceded by the prefix <code>enable-</code> and <code>disable-</code>, e.g.:
    --enable-launcher
will also enable Launcher.
= General Options =
<code>--help</code> (<code>-h</code>)
::Show the most relevant command line options.
<code>--verbose</code> (<code>-v</code>)
::Show all command line options when combined with <code>--help</code> or <code>-h</code>.
<code>--version[={true|false|1|0|yes|no}]</code>
::Display the current FlightGear version.
<code>--fg-root=path</code>
::Specify the root data path.
<code>--fg-scenery=path[:path...]</code>
::Specify the base scenery path. Defaults to [[$FG_ROOT]]/Scenery.
<code>--fg-aircraft=path</code>
::Specify additional aircraft directory path(s) (alternatively, you can use <code>--aircraft-dir</code> to target a specific aircraft in a given directory).
<code>--addon=path</code>
::Specify a path to addon. Multiple instances can be used.
<code>--download-dir=path</code>
::Store aircraft and scenery downloaded via the simulator in path. The TerraSync directory may be specifically set with the <code>--terrasync-dir</code> option.
<code>--data=path</code>
::Specify an additional base data directory (FGData), before the [[$FG_ROOT]] directory.
<code>--terrasync[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-terrasync</code><br/>
<code>--disable-terrasync</code>
::Enable/disable automatic scenery downloads/updates.
<code>--terrasync-dir=path</code>
::Specify the [[TerraSync]] scenery path. Defaults to [[$FG_HOME]]/TerraSync.
<code>--language=code</code>
::Select the language for this session. Available codes: <tt>ca</tt>, <tt>de</tt>, <tt>en</tt>, <tt>es</tt>, <tt>fr</tt>, <tt>it</tt>, <tt>nl</tt>, <tt>pl</tt>, <tt>pt</tt>, <tt>ru</tt>, <tt>tr</tt>, <tt>sk</tt>, <tt>zh</tt>.
<code>--launcher[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-launcher</code><br/>
<code>--disable-launcher</code>
::Enable/disable [[FlightGear Qt launcher|Qt Launcher]]. Without this option or with enabled it, it will immediately start the simulator in the default configuration or in the configuration read from the [[Fgfsrc|fgfsrc]] file - if it exists.
<code>--splash-screen[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-splash-screen</code><br/>
<code>--disable-splash-screen</code>
::Enable/disable splash screen.
<code>--mouse-pointer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-mouse-pointer</code><br/>
<code>--disable-mouse-pointer</code>
::Enable/disable extra mouse pointer (i.e. for full screen Voodoo based cards).
<code>--browser-app=path</code>
::Specify path to your web browser.


Usage: <code>fgfs [OPTION [OPTION ...]]</code>
<code>--prop:[type:]property=value</code>
::Set the given property to the given value. Type can be one of <tt>string</tt>, <tt>double</tt>, <tt>float</tt>, <tt>long</tt>, <tt>int</tt>, or <tt>bool</tt>.


==== General Options ====
<code>--prop:browser=property</code>
::After starting the simulator, open the properties dialog immediately on the given property. If you need more windows, just add more browser indexes like <tt>browser[1]</tt>, <tt>browser[2]</tt> etc., for example:
  --prop:browser=/sim/presets
  --prop:browser[1]=/devices/status/keyboard/event
::which will open two dialogs with the given properties.


--help, -h                  Show the most relevant command line options
<code>--config=path</code>
--verbose, -v                Show all command line options when combined with --help or -h
::Load additional properties from path.
--fg-root=path               Specify the root data path
--fg-scenery=path[:path...]  Specify the base scenery path;
                                Defaults to [[$FG_ROOT]]/Scenery
--language=code             Select the language for this session
--launcher                  Enable Qt launcher
--disable-fullscreen        Disable full-screen game mode
--enable-fullscreen          Enable full-screen game mode
--disable-splash-screen      Disable splash screen
--enable-splash-screen      Enable splash screen
--disable-mouse-pointer      Disable extra mouse pointer
--enable-mouse-pointer      Enable extra mouse pointer
                                (i.e. for full screen Voodoo based cards)
--disable-random-objects    Exclude random scenery objects
                                (buildings, etc.)
--enable-random-objects      Include random scenery objects
                                (buildings, etc.)
--disable-ai-models          Disable the AI subsystem.
                                (This also disables showing the models of other
                                multiplayer aircraft)
--enable-ai-models          Enable the AI subsystem.
--disable-ai-traffic        Disable the autogenerated traffic subsystem.
--enable-ai-traffic          Enable the autogenerated traffic subsystem.
--disable-freeze            Start in a running state
--enable-freeze              Start in a frozen state
--disable-fuel-freeze        Fuel is consumed normally
--enable-fuel-freeze        Fuel tank quantity forced to remain constant
--disable-clock-freeze      Clock advances normally
--enable-clock-freeze        Do not advance clock
--enable-auto-coordination  Enable auto coordination - rudder and
                              ailerons will be controlled together
--disable-auto-coordination  Disable auto coordination (default)
--browser-app=path          Specify path to your web browser
--prop:name=value            Set property  to
--config=path                Load additional properties from path
--units-feet                Use feet for distances
--units-meters              Use meters for distances


==== Features ====
<code>--no-default-config[={true|false|1|0|yes|no}]</code>
::Enable/Disable not loading any default configuration files (like [[Fgfsrc|fgfsrc]]) unless explicitly specified with <code>--config</code>.


--disable-panel              Disable instrument panel
<code>--units-feet</code><br/>
--enable-panel              Enable instrument panel
<code>--units-meters</code>
--disable-sound              Disable sound effects
::Use feets (default) or meters for distances.
--enable-sound              Enable sound effects
--disable-hud                Disable Heads Up Display (HUD)
--enable-hud                Enable Heads Up Display (HUD)
--disable-anti-alias-hud    Disable anti-aliased HUD
--enable-anti-alias-hud      Enable anti-aliased HUD
--disable-hud-3d            Disable 3D HUD
--enable-hud-3d              Enable 3D HUD
--ai-scenario=scenario      Add and enable a new scenario. Multiple options
                              are allowed. Scenarios are in /[[$FG_ROOT]]/AI/.


==== Aircraft ====
<code>--allow-nasal-read=path[:path...]</code>
::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.


--aircraft=name              Select an aircraft profile as defined by a top
<code>--read-only[={true|false|1|0|yes|no}]</code><br/>
                              level -set.xml
<code>--enable-read-only</code><br/>
--aircraft-dir=path          Specify the exact directory to use for the
<code>--disable-read-only</code>
                              aircraft (normally not required, but may be
::Enable/disable folder [[$FG_HOME]] read-only.
                              useful). Interpreted relatively to the
                              current directory. Causes the <path-cache>
                              from autosave_X_Y.xml, as well as
                              --fg-aircraft options and the FG_AIRCRAFT
                              environment variable to be bypassed.
--show-aircraft              Print a list of the currently available
                              aircraft types


==== Flight Model ====
<code>--ignore-autosave[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ignore-autosave</code><br/>
<code>--disable-ignore-autosave</code>
::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.


--fdm=name                  Select the core flight dynamics model
<code>--save-on-exit[={true|false|1|0|yes|no}]</code><br/>
                              Can be one of jsb, larcsim, yasim, magic,
<code>--enable-save-on-exit</code><br/>
                              balloon, ada, external, or null
<code>--disable-save-on-exit</code>
--aero=name                  Select aircraft aerodynamics model to load
::Enable/Disable saving preferences at program exit.
--model-hz=n                Run the FDM this rate (iterations per second)
--speed=n                    Run the FDM 'n' times faster than real time
--notrim                    Do NOT attempt to trim the model
                              (only with fdm=jsbsim)
--on-ground                  Start at ground level (default)
--in-air                    Start in air (implied when using --altitude)
--wind=DIR@SPEED            Specify wind coming from DIR (degrees) at SPEED
                              (knots)
--turbulence=0.0 to 1.0      Specify turbulence from 0.0 (calm) to 1.0
                              (severe)
--ceiling=FT_ASL[:THICKNESS_FT]
                              Create an overcast ceiling, optionally with a
                              specific thickness (defaults to 2000 ft).


==== Initial Position and Orientation ====
<code>--restore-defaults[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-restore-defaults</code><br/>
<code>--disable-restore-defaults</code>
::Enable/Disable resetting all user settings to their defaults (rendering options etc.)


--airport=ID                Specify airport (e.g. KOAK)
<code>--gui[={true|false|1|0|yes|no}]</code><br/>
--runway=rwy_no              Specify starting runway (must also specify an
<code>--enable-gui</code><br/>
                              airport)
<code>--disable-gui</code>
--vor=ID                    Specify starting position relative to a VOR
::Enable/Disable GUI (disabling GUI enables headless mode.)
--ndb=ID                    Specify starting position relative to an NDB
--fix=ID                    Specify starting position relative to a fix
--parkpos=NAME              Specify a gate at the airport (e.g. 747d11)
--offset-distance=nm        Specify distance to reference point (statute
                              miles)
--offset-azimuth=degrees    Specify heading to reference point
--lon=degrees                Starting longitude (west = -)
--lat=degrees                Starting latitude (south = -)
--altitude=value            Starting altitude
                              (in feet unless --units-meters specified)
--heading=degrees            Specify heading (yaw) angle (Psi)
--roll=degrees              Specify roll angle (Phi)
--pitch=degrees              Specify pitch angle (Theta)
--uBody=units_per_sec        Specify velocity along the body X axis
                              (in feet unless --units-meters specified)
--vBody=units_per_sec        Specify velocity along the body Y axis
                              (in feet unless --units-meters specified)
--wBody=units_per_sec        Specify velocity along the body Z axis
                              (in feet unless --units-meters specified)
--vc=knots                  Specify initial airspeed
--mach=num                  Specify initial mach number
--glideslope=degrees        Specify flight path angle (can be positive)
--roc=fpm                    Specify initial climb rate (can be negative)


==== Rendering Options ====
<code>--jsbsim-output-directive-file=file</code>
::Log JSBSim properties. An output directives file contains an <code><output></code> element, within which should be specified the parameters or parameter groups that should be logged. See [[JSBSim Logging]].


--bpp=depth                  Specify the bits per pixel
= Features =
--fog-disable                Disable fog/haze
--fog-fastest                Enable fastest fog/haze
--fog-nicest                Enable nicest fog/haze
--disable-horizon-effect    Disable celestial body growth illusion near the
                              horizon
--enable-horizon-effect      Enable celestial body growth illusion near the
                              horizon
--disable-enhanced-lighting  Disable enhanced runway lighting
--enable-enhanced-lighting  Enable enhanced runway lighting
--season=winter              Enable snow covered scenery
--disable-distance-attenuation
                              Disable runway light distance attenuation
--enable-distance-attenuation
                              Enable runway light distance attenuation
--disable-specular-highlight
                              Disable specular reflections on textured
                              objects
--enable-specular-highlight  Enable specular reflections on textured objects
--enable-clouds              Enable 2D (flat) cloud layers
--disable-clouds            Disable 2D (flat) cloud layers
--enable-clouds3d            Enable 3D (volumetric) cloud layers
--disable-clouds3d          Disable 3D (volumetric) cloud layers
--fov=degrees                Specify field of view angle
--disable-fullscreen        Disable fullscreen mode
--enable-fullscreen          Enable fullscreen mode
--shading-flat              Enable flat shading
--shading-smooth            Enable smooth shading
--disable-wireframe          Disable wireframe drawing mode
--enable-wireframe          Enable wireframe drawing mode
--geometry=WxH              Specify window geometry (640x480, etc)
--view-offset=value          Specify the default forward view direction as
                              an offset from straight ahead. Allowable values
                              are LEFT, RIGHT, CENTER, or a specific number
                              in degrees
--visibility=meters          Specify initial visibility
--visibility-miles=miles    Specify initial visibility in miles
--texture-filtering=number  Specify anisotropic filtering of terrain textures. Valid values is 1, 2, 4, 8, 16. Default is 1.


==== Hud Options ====
<code>--composite-viewer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-composite-viewer</code><br/>
<code>--disable-composite-viewer</code>
::Enable/disable CompositeViewer (extra view windows.)


  --hud-tris                  Hud displays number of triangles rendered
<code>--panel[={true|false|1|0|yes|no}]</code><br/>
  --hud-culled                Hud displays percentage of triangles culled
<code>--enable-panel</code><br/>
<code>--disable-panel</code>
::Enable/disable 2D instrument panel.


<code>--freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-freeze</code><br/>
<code>--disable-freeze</code>
::Start in a pause state or unpause.


==== Time Options ====
<code>--fuel-freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fuel-freeze</code><br/>
<code>--disable-fuel-freeze</code>
::Fuel tank quantity forced to remain constant or fuel is consumed normally.


  --timeofday={dawn,noon,dusk,midnight}
<code>--clock-freeze[={true|false|1|0|yes|no}]</code><br/>
                                Specify a time of day
<code>--enable-clock-freeze</code><br/>
  --time-offset=[+-]hh:mm:ss  Add this time offset
<code>--disable-clock-freeze</code>
  --time-match-real            Synchronize time with current time at chosen airport
::Do not advance clock or clock advances normally.
  --time-match-local          Synchronize time with system time of computer
  --start-date-sys=yyyy:mm:dd:hh:mm:ss
                                Specify a starting date/time with respect to
                                system time
  --start-date-gmt=yyyy:mm:dd:hh:mm:ss
                                Specify a starting date/time with respect to
                                Greenwich Mean Time
  --start-date-lat=yyyy:mm:dd:hh:mm:ss
                                Specify a starting date/time with respect to
                                Local Aircraft Time


==== Network Options ====
<code>--ai-scenario=scenario</code>
::Add and enable a new scenario. Multiple options are allowed. Scenarios are in [[$FG_ROOT]]/AI/.


  --httpd=port                Enable http server on the specified port
<code>--ai-models[={true|false|1|0|yes|no}]</code><br/>
  --telnet=port                Enable telnet server on the specified port
<code>--enable-ai-models</code><br/>
  --jpg-httpd=port            Enable screen shot http server on the specified
<code>--disable-ai-models</code>
                                port
::Enable/disable the AI subsystem. When disabled this also disables showing the models of other multiplayer aircraft.


<code>--ai-traffic[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ai-traffic</code><br/>
<code>--disable-ai-traffic</code>
::Enable/disable the autogenerated traffic subsystem.


==== MultiPlayer Options ====
<code>--vr[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-vr</code><br/>
<code>--disable-vr</code>
::Enable/disable the Virtual Reality.


  --callsign                  assign a unique name to a player
<code>--restart-launcher[={true|false|1|0|yes|no}]</code><br/>
  --multiplay={in|out},hz,address,port
<code>--enable-restart-launcher</code><br/>
                                Specify multipilot communication settings
<code>--disable-restart-launcher</code>
                                multiple instances can be used
::Enable/Disable automatic opening of the Launcher when exiting FlightGear.


<code>--load-tape={name|url}</code>
::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.


==== Route/Way Point Options ====
<code>--load-tape-create-video[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-load-tape-create-video</code><br/>
<code>--disable-load-tape-create-video</code>
::Enable/Disable encode video while replaying tape specified by <code>--load-tape</code>.


  --wp=ID[@alt]                Specify a waypoint for the GC autopilot;
<code>--load-tape-fixed-dt=value</code>
                                multiple instances can be used
::Set fixed-dt mode while replaying tape specified by <code>--load-tape</code>.
  --flight-plan=file          Read all waypoints from a file


= Aircraft =


==== IO Options ====
<code>--aircraft=name</code> (<code>--vehicle=name</code>)
::Select an aircraft profile as defined by a top level -set.xml.


  --generic=params             Open connection using a predefined
<code>--aircraft-dir=path</code>
                                communication interface and a preselected
::Specify the exact directory to use for the aircraft (normally not required, but may be useful). Interpreted relatively to the current directory. Causes the <code><path-cache></code> from autosave_X_Y.xml, as well as <code>--fg-aircraft</code> options and the FG_AIRCRAFT environment variable to be bypassed.
                                communication protocol
 
  --garmin=params             Open connection using the Garmin GPS protocol
<code>--show-aircraft[={true|false|1|0|yes|no}]</code>
  --joyclient=params           Open connection to an Agwagon joystick
::Enable/disable printing a list of the currently available aircraft types.
  --jsclient=params           Open connection to a remote joystick
 
  --native-ctrls=params       Open connection using the FG Native Controls
<code>--min-status={alpha|beta|early-production|production}</code>
                                protocol
::Allows you to define a minimum status level (=development status) for all listed aircraft by <code>--show-aircraft</code> option.
  --native-fdm=params         Open connection using the FG Native FDM
 
                                protocol
<code>--auto-coordination[={true|false|1|0|yes|no}]</code><br/>
  --native=params             Open connection using the FG Native protocol
<code>--enable-auto-coordination</code><br/>
  --nmea=params               Open connection using the NMEA protocol
<code>--disable-auto-coordination</code>
  --opengc=params             Open connection using the OpenGC protocol
::Enable/disable auto coordination. Disabled as default. If enabled, the rudder will respond according to the movement of the ailerons.
  --props=params               Open connection using the interactive property
 
                                manager (LEGACY/DEAD DO NOT USE same as --telnet)
<code>--livery=name</code>
  --pve=params                 Open connection using the PVE protocol
::Select aircraft livery.
  --ray=params                 Open connection using the Ray Woodworth motion
 
                                chair protocol
<code>--state=value</code>
  --rul=params                 Open connection using the RUL protocol
::Specify the initial state of the aircraft to the given value. The states that can be used depend on the aircraft. For example, the Cessna 172P has only one state: <tt>auto</tt>.
  --atc610x                    Enable atc610x interface
 
= Flight Model =
 
<code>--fdm={ada | acms | aisim | balloon | jsb | larcsim | magic | network | pipe | ufo | yasim | external | null}</code>
::Select the core flight dynamics model.
 
<code>--aero=name</code>
::Select aircraft aerodynamics model to load.
 
<code>--model-hz=n</code>
::Run the FDM this rate (iterations per second).
 
<code>--speed=n</code>
::Run the FDM 'n' times faster than real time.
 
<code>--trim[={true|false|1|0|yes|no}]</code><br/>
<code>--notrim[={true|false|1|0|yes|no}]</code>
::Trim or do not attempt to trim the model (only with <code>--fdm=jsbsim</code>).
 
<code>--on-ground[={true|false|1|0|yes|no}]</code><br/>
<code>--in-air[={true|false|1|0|yes|no}]</code>
::Start at ground level (default) or in air (implied when using <code>--altitude</code>).
 
= Initial Position and Orientation =
 
<code>--airport=ICAO</code>
::Specify airport (e.g. KOAK).
 
<code>--runway=rwy_no</code>
::Specify starting runway (must also specify an airport).
 
<code>--parking-id=name</code> (<code>--parkpos=name</code>)
::Specify a gate at the airport (e.g. 747d11).
 
<code>--carrier={name|ID}</code>
::Specify starting position on an AI carrier.
 
<code>--carrier-position={abeam|FLOLS|name}</code>
::Specify a starting position relative to the carrier where you can use the predefined <tt>abeam</tt> (start on downwind abeam) or <tt>FLOLS</tt> (start on final approach) values, or specify the name of the carrier's parking position. Must also specify a carrier by <code>--carrier</code>.
 
<code>--vor=ID</code>
::Specify starting position relative to a VOR.
 
<code>--vor-frequency=frequency</code>
::Specify the frequency of the VOR. Use with <code>--vor=ID</code>.
 
<code>--ndb=ID</code>
::Specify starting position relative to an NDB.
 
<code>--ndb-frequency=frequency</code>
::Specify the frequency of the NDB. Use with <code>--ndb=ID</code>.
 
<code>--fix=ID</code>
::Specify starting position relative to a fix.
 
<code>--offset-distance=nm</code>
::Specify distance to reference point (nautical miles).
 
<code>--offset-azimuth=degrees</code>
::Specify heading to reference point.
 
<code>--lon=degrees</code>
::Starting longitude (west = -).
 
<code>--lat=degrees</code>
::Starting latitude (south = -).
 
<code>--altitude=value</code>
::Starting altitude (in feet unless <code>--units-meters</code> specified).
 
<code>--heading=degrees</code>
::Specify heading (yaw) angle (Psi).
 
<code>--roll=degrees</code>
::Specify roll angle (Phi).
 
<code>--pitch=degrees</code>
::Specify pitch angle (Theta).
 
<code>--vc=knots</code><br/>
<code>--mach=num</code>
::Specify initial airspeed in knots or mach number.
 
<code>--glideslope=degrees</code>
::Specify flight path angle (can be positive).
 
<code>--roc=fpm</code>
::Specify initial climb of rate (can be negative).
 
<code>--uBody=units_per_sec</code>
::Specify velocity along the body X axis (in feet unless <code>--units-meters</code> specified).
 
<code>--vBody=units_per_sec</code>
::Specify velocity along the body Y axis (in feet unless <code>--units-meters</code> specified).
 
<code>--wBody=units_per_sec</code>
::Specify velocity along the body Z axis (in feet unless <code>--units-meters</code> specified).
 
<code>--vNorth=units_per_sec</code>
::Specify velocity along a South-North axis (in feet unless <code>--units-meters</code> specified).
 
<code>--vEast=units_per_sec</code>
::Specify velocity along a West-East axis (in feet unless <code>--units-meters</code> specified).
 
<code>--vDown=units_per_sec</code>
::Specify velocity along a vertical axis (in feet unless <code>--units-meters</code> specified).
 
= Audio Options =
 
<code>--show-sound-devices[={true|false|1|0|yes|no}]</code>
::Enable/disable the display of the list of audio devices.
 
<code>--sound-device=name</code>
::Explicitly specify the audio device to use. To get available names use <code>--show-sound-devices</code>.
 
<code>--sound[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-sound</code><br/>
<code>--disable-sound</code>
::Enable/disable sound.
 
= Rendering Options =
 
<code>--prop:/sim/rendering/multi-sample-buffers={true|false}</code>
::Enable/disable multi sample buffer (anti-aliasing).
 
<code>--prop:/sim/rendering/multi-samples=value</code>
::Specify number of multi samples (anti-aliasing). Valid values is 2, 4, 8, 16.
 
<code>--aspect-ratio-multiplier=factor</code>
::Specify a multiplier for the aspect ratio.
 
<code>--bpp={16|24|32}</code>
::Specify the bits per pixel.
 
<code>--compositor=path</code>
::Specify the path to XML file for multi-pass rendering. The path is relative to [[$FG_ROOT]] (defaults to <code>Compositor/default</code>.) For enable HDR pipeline use <code>Compositor/HDR/hdr</code> path.
 
<code>--horizon-effect[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-horizon-effect</code><br/>
<code>--disable-horizon-effect</code>
::Enable/disable celestial body growth illusion near the horizon.
 
<code>--distance-attenuation[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-distance-attenuation</code><br/>
<code>--disable-distance-attenuation</code>
::Enable/disable runway light distance attenuation.
 
<code>--specular-highlight[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-specular-highlight</code><br/>
<code>--disable-specular-highlight</code>
::Enable/disable specular reflections on textured objects.
 
<code>--clouds[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clouds</code><br/>
<code>--disable-clouds</code>
::Enable/disable 2D (flat) cloud layers.
 
<code>--clouds3d[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clouds3d</code><br/>
<code>--disable-clouds3d</code>
::Enable/disable 3D (volumetric) cloud layers.
 
<code>--texture-cache[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-texture-cache</code><br/>
<code>--disable-texture-cache</code>
::Enable/disable texture cache (DDS).
 
<code>--texture-cache-dir=path</code>
::Set the DDS texture cache directory to be different than the default location.
 
<code>--fullscreen[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fullscreen</code><br/>
<code>--disable-fullscreen</code>
::Enable/disable fullscreen mode.
 
<code>--random-objects[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-random-objects</code><br/>
<code>--disable-random-objects</code>
::Enable/disable random scenery objects (buildings, etc.)
 
<code>--wireframe[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-wireframe</code><br/>
<code>--disable-wireframe</code>
::Enable/disable wireframe drawing mode.
 
<code>--fog-disable</code><br/>
<code>--fog-fastest</code><br/>
<code>--fog-nicest</code>
::Set the fog. The <code>--fog-disable</code> option will turn off the fog, resulting in increased visibility and a decrease in performance (more terrain to render). The <code>--fog-fastest</code> option will enable fog rendering in a less realistic way, but improving performance. By default, the <code>--fog-nicest</code> option is used to render a realistic fog, at the expense of performance. These options are deprecated.
 
<code>--fov=degrees</code>
::Specify field of view angle.
 
<code>--geometry=WidthxHeight</code>
::Specify window geometry/resolution (640x480, etc).
 
<code>--graphics-preset={minimal-quality|low-quality|medium-quality|high-quality|ultra-quality}</code>
::Specify a graphic preset.
 
<code>--materials-file=file</code>
::Specify the materials file used to render the scenery (default: Materials/regions/materials.xml).
 
<code>--max-fps=Hz</code>
::Maximum frame rate in Hz.
 
<code>--shading-smooth</code><br/>
<code>--shading-flat</code>
::Enable smooth or flat shading. These options are deprecated.
 
<code>--texture-filtering={1|2|4|8|16}</code>
::Specify anisotropic filtering of terrain textures. Valid values is 1, 2, 4, 8, 16. Default is 1.
 
<code>--view-offset={LEFT|CENTER|RIGHT|value}</code>
::Specify the default forward view direction as an offset from straight ahead. Allowable values are <tt>LEFT</tt>, <tt>RIGHT</tt>, <tt>CENTER</tt>, or a specific number in degrees.
 
<code>--terrain-engine={tilecache|pagedLOD}</code>
::Specify the terrain engine you want to use: <tt>tilecache</tt> or <tt>pagedLOD</tt>.
 
<code>--lod-levels=levels</code>
::Specify the detail levels, where levels are a space-separated numeric list of levels. The default is "1 3 5 7 9". Use with <code>--terrain-engine=pagedLOD</code>.
 
<code>--lod-res=resolution</code>
::Specify the resolution of the terrain grid. Defaults is 1. Use with <code>--terrain-engine=pagedLOD</code>.
 
<code>--lod-texturing={bluemarble|raster|debug}</code>
::Specify the method of texturing the terrain. The default is <tt>bluemarble</tt>. Use with <code>--terrain-engine=pagedLOD</code>.
 
<code>--lod-range-mult=multiplier</code>
::Specify the range multiplier (point from low to fine detail). Defaults is 2. Use with <code>--terrain-engine=pagedLOD</code>.
 
== WS3.0 ==
 
<code>--prop:/scenery/use-vpb=true</code>
::Activate the use of World Scenery 3.0.
 
= Hud Options =
 
<code>--hud[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hud</code><br/>
<code>--disable-hud</code>
::Enable/disable Heads Up Display (HUD).
 
<code>--anti-alias-hud[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-anti-alias-hud</code><br/>
<code>--disable-anti-alias-hud</code>
::Enable/disable anti-aliased HUD.
 
<code>--hud-3d[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hud-3d</code><br/>
<code>--disable-hud-3d</code>
::Enable/disable 3D HUD.
 
<code>--hud-tris</code><br/>
<code>--hud-culled</code>
::Hud displays number of triangles rendered or percentage of triangles culled.
 
= Time Options =
 
The following time and date setting options are not compatible with each other, so only one of them should be given.
 
<code>--timeofday={real|dawn|morning|noon|afternoon|dusk|evening|midnight}</code>
::Specify a time of day.
 
<code>--time-offset=[+-]hh:mm:ss</code>
::Add this time offset to <code>--time-match-real</code>.
 
<code>--time-match-real</code>
::Synchronize time with current time at chosen airport.
 
<code>--time-match-local</code>
::Synchronize time with system time of computer.
 
<code>--start-date-sys=yyyy:mm:dd:hh:mm:ss</code>
::Specify a starting date/time with respect to system time.
 
<code>--start-date-gmt=yyyy:mm:dd:hh:mm:ss</code>
::Specify a starting date/time with respect to Greenwich Mean Time.
 
<code>--start-date-lat=yyyy:mm:dd:hh:mm:ss</code>
::Specify a starting date/time with respect to Local Aircraft Time.
 
= Network Options =
 
<code>--proxy=[user:password@]host:port</code>
::Specify the proxy server and port to be used. Username and password are optional. If present, they should be listed as MD5 hashes. This option is only useful when <code>--real-weather-fetch</code> is enabled.
 
<code>--httpd=port</code>
::Enable HTTP server on the specified port.
 
<code>--telnet={port|socket,bi,hz,localhost,port,tcp}</code> (<code>--props={port|socket,bi,hz,localhost,port,tcp}</code>)
::Enable telnet server on the specified port. Optionally, you can change the hz (number of packets per second).
 
<code>--jpg-httpd=port</code>
::Enable screen shot HTTP server on the specified port. This option has been withdrawn, instead use <code>--httpd</code> and /screenshot URL.
 
<code>--allow-nasal-from-sockets[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-allow-nasal-from-sockets</code><br/>
<code>--disable-allow-nasal-from-sockets</code>
::Enable/disable allowing executing Nasal scripts from sockets. 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.
 
<code>--sentry[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-sentry</code><br/>
<code>--disable-sentry</code>
::Enable/disable crash and error reports from being sent to the development team for analysis.
 
= MultiPlayer Options =
 
<code>--callsign=name</code>
::Assign a unique name to a player. A call sign must be at most 10 characters long and can only contain numbers, letters of the English alphabet, hyphens (-) and underscores (_). Longer call signs are truncated, and characters that do not match those listed above are replaced with hyphens.
 
<code>--multiplay={in|out},hz,address,port</code>
::Specify multipilot communication settings. Multiple instances can be used.
 
<code>--fgcom[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fgcom</code><br/>
<code>--disable-fgcom</code>
::Enable/disable built-in FGCom (voice communication with ATC.)
 
<code>--hold-short[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hold-short</code><br/>
<code>--disable-hold-short</code>
::In multiplayer mode, when you select an initial position on the runway, you will be moved by default to the hold-short position (<code>--hold-short</code>), which is on the taxiway, just in front of the runway. The <code>--disable-hold-short</code> option allows you to disable this behavior, but keep in mind that this is undesirable, as it may interfere with others taking off or landing.
 
= Route/Way Point Options =
 
<code>--wp=ID[@alt]</code>
::Specify a waypoint for the GC autopilot. Multiple instances can be used.
 
<code>--flight-plan=file</code>
::Read all waypoints from a file.
 
= IO Options =
 
<code>--generic=params</code>
::Open connection using a predefined communication interface and a preselected communication protocol.
 
<code>--atlas=params</code>
::Open connection using the Atlas protocol.
 
<code>--atcsim=params</code>
::Open connection using the ATC sim protocol (atc610x).
 
<code>--AV400=params</code>
::Emit the Garmin AV400 protocol required to drive a Garmin 196/296 series GPS.
 
<code>--AV400Sim=params</code>
::Emit the set of AV400 strings required to drive a Garmin 400-series GPS from FlightGear.
 
<code>--AV400WSimA=params</code>, <code>--AV400WSimB=params</code>
::The Garmin WAAS GPS uses 2 serial channels to communicate with the simulator. These 2 channels are represented by the FGAV400WSimA and the FGAV400WSimB classes. The "A" channel is similar to the previous AVSim400 protocol. The "B" channel is considered the "GPS" channel and uses a different protocol than the "A" channel. The GPS unit expects input on the "B" channel at two different frequencies (1hz and 5hz, normally). The "B" channel also expects responses to certain output messages.
 
<code>--flarm=params</code>
::Open connection using the FLARM protocol, which includes NMEA/GPS and traffic reporting messages.
 
<code>--garmin=params</code>
::Open connection using the Garmin GPS protocol.
 
<code>--hla=params</code>
::Open a remote connection using the HLA protocol. Currently, this option is disabled.
 
<code>--hla-local=params</code>
::Open a local connection using the HLA protocol. Currently, this option is disabled.
 
<code>--igc=params</code>
::Open connection using the International Gliding Commission (IGC) protocol.
 
<code>--joyclient=params</code>
::Open connection to an Agwagon joystick.
 
<code>--jsclient=params</code>
::Open connection to a remote joystick.
 
<code>--native=params</code>
::Open connection using the FG Native protocol.
 
<code>--native-ctrls=params</code>
::Open connection using the FG Native Controls protocol.
 
<code>--native-fdm=params</code>
::Open connection using the FG Native FDM protocol.
 
<code>--native-gui=params</code>
::Open connection using the FG Native GUI protocol.
 
<code>--nmea=params</code>
::Open connection using the NMEA protocol.
 
<code>--opengc=params</code>
::Open connection using the OpenGC protocol.
 
<code>--props=params</code>
::Open connection using the interactive property manager (same as <code>--telnet</code>).
 
<code>--pve=params</code>
::Open connection using the PVE protocol (ProVision Entertainment - some sort of motion platform).
 
<code>--ray=params</code>
::Open connection using the Ray Woodworth motion chair protocol.
 
<code>--rul=params</code>
::Open connection using the RUL protocol (some sort of motion platform some guy was building).


Under Windows, you must use a special escape sequence if you need to specify a COM port higher than 9.
Under Windows, you must use a special escape sequence if you need to specify a COM port higher than 9.


Example: --generic=\\.\COM10,out,1,/tmp/data.xml,myproto
Example: <code>--generic=\\.\COM10,out,1,/tmp/data.xml,myproto</code>


This is per the Microsoft KB article here: http://msdn.microsoft.com/en-us/library/aa363858%28v=vs.85%29.aspx
This is per the Microsoft KB article here: http://msdn.microsoft.com/en-us/library/aa363858%28v=vs.85%29.aspx


==== Avionics Options ====
= Avionics Options =
 
<code>--com1=frequency</code>, <code>--com2=frequency</code>
::Set the COM1 and COM2 radio frequency.
 
<code>--nav1=[radial:]frequency</code>, <code>--nav2=[radial:]frequency</code>
::Set the NAV1 and NAV2 radio frequency, optionally preceded by a radial.
 
<code>--adf1=[rotation:]frequency</code>, <code>--adf2=[rotation:]frequency</code>
::Set the ADF1 and ADF2 frequency to frequency kHz. You can optionally specify the rotation angle of its compass card by prefixing the frequency with the angle and a colon. The <code>--adf</code> option is deprecated.
 
<code>--dme={nav1|nav2|frequency}</code>
::Slave the ADF to one of the NAV radios, or set its internal frequency.
 
= Environment Options =
 
<code>--real-weather-fetch[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-real-weather-fetch</code><br/>
<code>--disable-real-weather-fetch</code>
::Enable/disable METAR based real weather fetching. Enable requires an open internet connection.
 
<code>--horizon-effect[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-horizon-effect</code><br/>
<code>--disable-horizon-effect</code>
::Enable/disable celestial body growth illusion near the horizon.
 
<code>--visibility=meters</code><br/>
<code>--visibility-miles=miles</code>
::Specify initial visibility in meters or in statute miles. It works only with Basic Weather.
 
<code>--wind=DIR[:MAXDIR]@SPEED[:GUST]</code>
::Specify the direction from which the wind is blowing (DIR in degrees) and its SPEED (in knots). If the wind direction is variable, specify the range as DIR:MAXDIR, as a minimum and maximum angle in degrees. If you want the simulator to also model wind gusts, set the maximum :GUST rate in knots.
 
<code>--turbulence=value</code>
::Specify turbulence where value must to be from 0.0 (calm) to 1.0 (severe).
 
<code>--ceiling=FT_ASL[:THICKNESS_FT]</code>
::Create an overcast ceiling, optionally with a specific thickness (defaults to 2000 ft). This option looks like it has been broken for a long time and doesn't work at all.
 
<code>--random-wind</code>
::Set up random wind direction and speed.
 
<code>--metar="metar string"</code>
::Starts with a certain METAR string. Only works if live weather is disabled.
 
= Situation Options =
 
<code>--failure={pitot|static|vacuum|electrical}</code>
::Fail the pitot, static, vacuum, or electrical system (repeat the option for multiple system failures).
 
= Debugging Options =
 
<code>--console[={true|false|1|0|yes|no}]</code> (<code>-c</code>)
::Enable/Disable displaying console (Windows specific.) Short <code>-c</code> always enable console.
 
<code>--developer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-developer</code><br/>
<code>--disable-developer</code>
::Enable/Disable developer mode which will log more events.
 
<code>--fpe[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fpe</code><br/>
<code>--disable-fpe</code>
::Enable/Disable aborting on encountering a floating point exception.


  --com1=frequency            Set the COM1 radio frequency.
<code>--fgviewer file</code>
  --com2=frequency            Set the COM2 radio frequency.
::Use a model viewer rather than load the entire simulator.
  --nav1=[radial:]frequency    Set the NAV1 radio frequency, optionally
                                preceded by a radial.
  --nav2=[radial:]frequency    Set the NAV2 radio frequency, optionally
                                preceded by a radial.
  --adf=[rotation:]frequency  Set the ADF radio frequency, optionally
                                preceded by a card rotation.
  --dme={nav1|nav2|frequency}  Slave the ADF to one of the NAV radios, or set
                                its internal frequency.


==== Environment Options ====
<code>--json-report[={true|false|1|0|yes|no}]</code>
::Enable/Disable printing a report in JSON format on the standard output. The report will give useful information for debugging purposes, such as the FlightGear version, the scenery/aircraft paths in use, the TerraSync and the data download directories and the paths to navigation data files.


  --disable-real-weather-fetch
<code>--log-level={bulk|debug|info|warn|alert}</code>
                                Disable METAR based real weather fetching
::Set the logging level for this session. 0 = verbose, 5 = alerts only. See also [[Commonly used debugging tools#fgfs.log]].
  --enable-real-weather-fetch  Enable METAR based real weather fetching (this
                                requires an open internet connection)
  --disable-horizon-effect    Disable celestial body growth illusion near the
                                horizon
  --enable-horizon-effect      Enable celestial body growth illusion near the
                                horizon
  --enable-clouds              Enable 2D (flat) cloud layers
  --disable-clouds            Disable 2D (flat) cloud layers
  --enable-clouds3d            Enable 3D (volumetric) cloud layers
  --disable-clouds3d          Disable 3D (volumetric) cloud layers
  --visibility=meters          Specify initial visibility
  --visibility-miles=miles    Specify initial visibility in miles
  --wind=DIR@SPEED            Specify wind coming from DIR (degrees) at SPEED
                                (knots)
  --turbulence=0.0 to 1.0      Specify turbulence from 0.0 (calm) to 1.0
                                (severe)
  --ceiling=FT_ASL[:THICKNESS_FT]
                                Create an overcast ceiling, optionally with a
                                specific thickness (defaults to 2000 ft).
  --random-wind
  --metar="metar string"      Starts with a certain METAR string. Only works if live weather is disabled.


==== Situation Options ====
<code>--log-class={none|ai|aircraft|astro|atc|autopilot|clipper|cockpit| environment|event|flight|general|gl|gui|headless|input|instrumentation| io|math|nasal|navaid|network|osg|particles|sound|systems|terrain| terrasync|undefined|view|all}</code>
::Specify which logging class(es) to use.


  --failure={pitot|static|system|vacuum}
<code>--log-dir={desktop|path}</code>
                                Fail the pitot, static, vacuum, or electrical
::Save the logs in the given directory. If <code>desktop</code> is entered instead of the path, the logs are saved on the Desktop. This option may be given several times, using a different directory each time. Inside the specified directory, the log file will be named FlightGear_YYYY-MM-DD_num.log, where YYYY-MM-DD is the current date and num is a progressive number starting at 0.
                                system (repeat the option for multiple system
                                failures).


<code>--trace-read=property</code>
::Trace the reads for a property; multiple instances can be used.


==== Debugging Options ====
<code>--trace-write=property</code>
::Trace the writes for a property; multiple instances can be used.


  --log-level={bulk|debug|info|warn|alert}
<code>--uninstall</code>
                                Set the logging level for this session.
::Remove [[$FG_HOME]] directory. For Windows, it additionally removes TerraSync, Aircraft and TextureCache directories from download directory.
                                0=verbose, 5=alerts only
  --pid=/pathto/some/file.pid  Write current PID into file.
  --trace-read=property        Trace the reads for a property;
                                multiple instances can be used
  --trace-write=property      Trace the writes for a property;
                                multiple instances can be used


== Related content ==
= Related content =
=== Wiki articles ===
== Wiki articles ==
* [[Command line]]
* [[Command line]]
* [[Command line options 2020.3]]


=== Source files ===
== Source files ==
* {{fgdata file|options.xml}}
* {{fgdata file|options.xml}}
* {{flightgear file|src/Main/options.hxx}}
* {{flightgear file|src/Main/options.hxx}}
* {{flightgear file|src/Main/options.cxx}}
* {{flightgear file|src/Main/options.cxx}}


[[Category:FlightGear]]
[[Category:Lists]]
[[Category:Lists]]


[[de:Command Line Options]]
[[de:Command Line Options]]
[[fr:Options de ligne de commande]]
[[fr:Options de ligne de commande]]
[[pl:Opcje wiersza poleceń]]

Latest revision as of 13:32, 22 September 2023

Note  This article presents the current command line options, including the development version. To check the options for FlightGear version 2020.3.x, see the Command line options 2020.3 article.

Command line options are a common way to tell applications what to do/how to act on startup. With FlightGear they are used for many things, from simple ones like selecting an aircraft up to complex stuff like network traffic and weather parameters.

The easiest way to handle those options for FlightGear is using a tool with a graphical user interface like the FlightGear Qt launcher. This way one doesn't have to bother about them at all.

However, there are users who don't want or are not able to run a GUI and therefore are interested in this. Those who need them or just want to learn more about FlightGear, but have no idea what we are talking about, may read the wiki page on the general usage of the command line. The launcher GUI works by setting command-line options for the options you choose. Try different options and see what the launcher sets from menu in Qt launcher *** > View command-line or by use Ctrl+L keyboard shortcut.

A good place to store the personal options is a file called fgfsrc. This file is read by FlightGear on each startup.

The following lists show the options for FlightGear including a short description and sorted by categories. Please have in mind that keeping those lists up to date on the wiki is not an easy task. Also there are different versions of FlightGear out there which don't share exactly the same options. Therefore you better also check your versions ones with fgfs --help --verbose. If this command fails, you may add the option --fg-root=[path] as well, see below.

It is sad but true, not even this command is, at least in Git, up to date all the time. At the time of writing at least one option which is supported is not shown with fgfs --help --verbose. So if you have serious issues with an option, the source code is, as always, also the best source for info. In the file src/Main/options.cxx all the options are listed with their hard coded default setting and type.

The file $FG_ROOT/options.xml is used to generate the output for fgfs --help [--verbose]. That's the reason why --fg-root=[path] has to be added to this, if it is not set as environmental variable or as option in fgfsrc.

Usage in terminal: fgfs [OPTION [OPTION ...]]

The way to use options by Qt Launcher: go to the "Settings" tab and in the "Additional Settings" section enter the following options, each on a new line. The options entered there take precedence over those defined by Qt Launcher. To see the entire list of command line options used by Qt Launcher, use the keyboard shortcut Ctrl+L or select "View command-line" from the Launcher menu.

Legend how to read the following options

  1. --option1 (--option2) - in this case --option2 is the aliast for --option1 which is exactly the same as --option1.
  2. --option1
    --option2 - two different options, mutually exclusive. They cannot be used simultaneously, but are connected due to a common description.
  3. --option1, --option2 - two different options that can be used simultaneously and are connected due to a common description.

Values for options

Some options do not require a value, such as --help, but there are options for which we must specify a value, such as --fg-root, as well as there are options for which we can optionally specify a value, such as for --launcher. We can separate the value from the option with either the = sign or a space, such as:

   --fg-root=/path/to/fgdata
   --fg-root /path/to/fgdata

Options that act like an enable/disable switch take optional values as true, 1, yes (enable) or false, 0, no (disable). If we don't specify any value next to such an option, it will work by default as if we passed true, 1 or yes, i.e. enabled it, e.g:

   --launcher

will enable Launcher, which is equivalent to:

   --launcher=yes

On the other hand, we can also pass a value that disables the option, e.g.:

   --launcher=no

which will cause Launcher not to be launched. In addition, most of such options have two additional versions without a value, but preceded by the prefix enable- and disable-, e.g.:

   --enable-launcher

will also enable Launcher.

General Options

--help (-h)

Show the most relevant command line options.

--verbose (-v)

Show all command line options when combined with --help or -h.

--version[={true|false|1|0|yes|no}]

Display the current FlightGear version.

--fg-root=path

Specify the root data path.

--fg-scenery=path[:path...]

Specify the base scenery path. Defaults to $FG_ROOT/Scenery.

--fg-aircraft=path

Specify additional aircraft directory path(s) (alternatively, you can use --aircraft-dir to target a specific aircraft in a given directory).

--addon=path

Specify a path to addon. Multiple instances can be used.

--download-dir=path

Store aircraft and scenery downloaded via the simulator in path. The TerraSync directory may be specifically set with the --terrasync-dir option.

--data=path

Specify an additional base data directory (FGData), before the $FG_ROOT directory.

--terrasync[={true|false|1|0|yes|no}]
--enable-terrasync
--disable-terrasync

Enable/disable automatic scenery downloads/updates.

--terrasync-dir=path

Specify the TerraSync scenery path. Defaults to $FG_HOME/TerraSync.

--language=code

Select the language for this session. Available codes: ca, de, en, es, fr, it, nl, pl, pt, ru, tr, sk, zh.

--launcher[={true|false|1|0|yes|no}]
--enable-launcher
--disable-launcher

Enable/disable Qt Launcher. Without this option or with enabled it, it will immediately start the simulator in the default configuration or in the configuration read from the fgfsrc file - if it exists.

--splash-screen[={true|false|1|0|yes|no}]
--enable-splash-screen
--disable-splash-screen

Enable/disable splash screen.

--mouse-pointer[={true|false|1|0|yes|no}]
--enable-mouse-pointer
--disable-mouse-pointer

Enable/disable extra mouse pointer (i.e. for full screen Voodoo based cards).

--browser-app=path

Specify path to your web browser.

--prop:[type:]property=value

Set the given property to the given value. Type can be one of string, double, float, long, int, or bool.

--prop:browser=property

After starting the simulator, open the properties dialog immediately on the given property. If you need more windows, just add more browser indexes like browser[1], browser[2] etc., for example:
 --prop:browser=/sim/presets
 --prop:browser[1]=/devices/status/keyboard/event
which will open two dialogs with the given properties.

--config=path

Load additional properties from path.

--no-default-config[={true|false|1|0|yes|no}]

Enable/Disable not loading any default configuration files (like fgfsrc) unless explicitly specified with --config.

--units-feet
--units-meters

Use feets (default) or meters for distances.

--allow-nasal-read=path[:path...]

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.

--read-only[={true|false|1|0|yes|no}]
--enable-read-only
--disable-read-only

Enable/disable folder $FG_HOME read-only.

--ignore-autosave[={true|false|1|0|yes|no}]
--enable-ignore-autosave
--disable-ignore-autosave

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.

--save-on-exit[={true|false|1|0|yes|no}]
--enable-save-on-exit
--disable-save-on-exit

Enable/Disable saving preferences at program exit.

--restore-defaults[={true|false|1|0|yes|no}]
--enable-restore-defaults
--disable-restore-defaults

Enable/Disable resetting all user settings to their defaults (rendering options etc.)

--gui[={true|false|1|0|yes|no}]
--enable-gui
--disable-gui

Enable/Disable GUI (disabling GUI enables headless mode.)

--jsbsim-output-directive-file=file

Log JSBSim properties. An output directives file contains an <output> element, within which should be specified the parameters or parameter groups that should be logged. See JSBSim Logging.

Features

--composite-viewer[={true|false|1|0|yes|no}]
--enable-composite-viewer
--disable-composite-viewer

Enable/disable CompositeViewer (extra view windows.)

--panel[={true|false|1|0|yes|no}]
--enable-panel
--disable-panel

Enable/disable 2D instrument panel.

--freeze[={true|false|1|0|yes|no}]
--enable-freeze
--disable-freeze

Start in a pause state or unpause.

--fuel-freeze[={true|false|1|0|yes|no}]
--enable-fuel-freeze
--disable-fuel-freeze

Fuel tank quantity forced to remain constant or fuel is consumed normally.

--clock-freeze[={true|false|1|0|yes|no}]
--enable-clock-freeze
--disable-clock-freeze

Do not advance clock or clock advances normally.

--ai-scenario=scenario

Add and enable a new scenario. Multiple options are allowed. Scenarios are in $FG_ROOT/AI/.

--ai-models[={true|false|1|0|yes|no}]
--enable-ai-models
--disable-ai-models

Enable/disable the AI subsystem. When disabled this also disables showing the models of other multiplayer aircraft.

--ai-traffic[={true|false|1|0|yes|no}]
--enable-ai-traffic
--disable-ai-traffic

Enable/disable the autogenerated traffic subsystem.

--vr[={true|false|1|0|yes|no}]
--enable-vr
--disable-vr

Enable/disable the Virtual Reality.

--restart-launcher[={true|false|1|0|yes|no}]
--enable-restart-launcher
--disable-restart-launcher

Enable/Disable automatic opening of the Launcher when exiting FlightGear.

--load-tape={name|url}

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.

--load-tape-create-video[={true|false|1|0|yes|no}]
--enable-load-tape-create-video
--disable-load-tape-create-video

Enable/Disable encode video while replaying tape specified by --load-tape.

--load-tape-fixed-dt=value

Set fixed-dt mode while replaying tape specified by --load-tape.

Aircraft

--aircraft=name (--vehicle=name)

Select an aircraft profile as defined by a top level -set.xml.

--aircraft-dir=path

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 options and the FG_AIRCRAFT environment variable to be bypassed.

--show-aircraft[={true|false|1|0|yes|no}]

Enable/disable printing a list of the currently available aircraft types.

--min-status={alpha|beta|early-production|production}

Allows you to define a minimum status level (=development status) for all listed aircraft by --show-aircraft option.

--auto-coordination[={true|false|1|0|yes|no}]
--enable-auto-coordination
--disable-auto-coordination

Enable/disable auto coordination. Disabled as default. If enabled, the rudder will respond according to the movement of the ailerons.

--livery=name

Select aircraft livery.

--state=value

Specify the initial state of the aircraft to the given value. The states that can be used depend on the aircraft. For example, the Cessna 172P has only one state: auto.

Flight Model

--fdm={ada | acms | aisim | balloon | jsb | larcsim | magic | network | pipe | ufo | yasim | external | null}

Select the core flight dynamics model.

--aero=name

Select aircraft aerodynamics model to load.

--model-hz=n

Run the FDM this rate (iterations per second).

--speed=n

Run the FDM 'n' times faster than real time.

--trim[={true|false|1|0|yes|no}]
--notrim[={true|false|1|0|yes|no}]

Trim or do not attempt to trim the model (only with --fdm=jsbsim).

--on-ground[={true|false|1|0|yes|no}]
--in-air[={true|false|1|0|yes|no}]

Start at ground level (default) or in air (implied when using --altitude).

Initial Position and Orientation

--airport=ICAO

Specify airport (e.g. KOAK).

--runway=rwy_no

Specify starting runway (must also specify an airport).

--parking-id=name (--parkpos=name)

Specify a gate at the airport (e.g. 747d11).

--carrier={name|ID}

Specify starting position on an AI carrier.

--carrier-position={abeam|FLOLS|name}

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 by --carrier.

--vor=ID

Specify starting position relative to a VOR.

--vor-frequency=frequency

Specify the frequency of the VOR. Use with --vor=ID.

--ndb=ID

Specify starting position relative to an NDB.

--ndb-frequency=frequency

Specify the frequency of the NDB. Use with --ndb=ID.

--fix=ID

Specify starting position relative to a fix.

--offset-distance=nm

Specify distance to reference point (nautical miles).

--offset-azimuth=degrees

Specify heading to reference point.

--lon=degrees

Starting longitude (west = -).

--lat=degrees

Starting latitude (south = -).

--altitude=value

Starting altitude (in feet unless --units-meters specified).

--heading=degrees

Specify heading (yaw) angle (Psi).

--roll=degrees

Specify roll angle (Phi).

--pitch=degrees

Specify pitch angle (Theta).

--vc=knots
--mach=num

Specify initial airspeed in knots or mach number.

--glideslope=degrees

Specify flight path angle (can be positive).

--roc=fpm

Specify initial climb of rate (can be negative).

--uBody=units_per_sec

Specify velocity along the body X axis (in feet unless --units-meters specified).

--vBody=units_per_sec

Specify velocity along the body Y axis (in feet unless --units-meters specified).

--wBody=units_per_sec

Specify velocity along the body Z axis (in feet unless --units-meters specified).

--vNorth=units_per_sec

Specify velocity along a South-North axis (in feet unless --units-meters specified).

--vEast=units_per_sec

Specify velocity along a West-East axis (in feet unless --units-meters specified).

--vDown=units_per_sec

Specify velocity along a vertical axis (in feet unless --units-meters specified).

Audio Options

--show-sound-devices[={true|false|1|0|yes|no}]

Enable/disable the display of the list of audio devices.

--sound-device=name

Explicitly specify the audio device to use. To get available names use --show-sound-devices.

--sound[={true|false|1|0|yes|no}]
--enable-sound
--disable-sound

Enable/disable sound.

Rendering Options

--prop:/sim/rendering/multi-sample-buffers={true|false}

Enable/disable multi sample buffer (anti-aliasing).

--prop:/sim/rendering/multi-samples=value

Specify number of multi samples (anti-aliasing). Valid values is 2, 4, 8, 16.

--aspect-ratio-multiplier=factor

Specify a multiplier for the aspect ratio.

--bpp={16|24|32}

Specify the bits per pixel.

--compositor=path

Specify the path to XML file for multi-pass rendering. The path is relative to $FG_ROOT (defaults to Compositor/default.) For enable HDR pipeline use Compositor/HDR/hdr path.

--horizon-effect[={true|false|1|0|yes|no}]
--enable-horizon-effect
--disable-horizon-effect

Enable/disable celestial body growth illusion near the horizon.

--distance-attenuation[={true|false|1|0|yes|no}]
--enable-distance-attenuation
--disable-distance-attenuation

Enable/disable runway light distance attenuation.

--specular-highlight[={true|false|1|0|yes|no}]
--enable-specular-highlight
--disable-specular-highlight

Enable/disable specular reflections on textured objects.

--clouds[={true|false|1|0|yes|no}]
--enable-clouds
--disable-clouds

Enable/disable 2D (flat) cloud layers.

--clouds3d[={true|false|1|0|yes|no}]
--enable-clouds3d
--disable-clouds3d

Enable/disable 3D (volumetric) cloud layers.

--texture-cache[={true|false|1|0|yes|no}]
--enable-texture-cache
--disable-texture-cache

Enable/disable texture cache (DDS).

--texture-cache-dir=path

Set the DDS texture cache directory to be different than the default location.

--fullscreen[={true|false|1|0|yes|no}]
--enable-fullscreen
--disable-fullscreen

Enable/disable fullscreen mode.

--random-objects[={true|false|1|0|yes|no}]
--enable-random-objects
--disable-random-objects

Enable/disable random scenery objects (buildings, etc.)

--wireframe[={true|false|1|0|yes|no}]
--enable-wireframe
--disable-wireframe

Enable/disable wireframe drawing mode.

--fog-disable
--fog-fastest
--fog-nicest

Set the fog. The --fog-disable option will turn off the fog, resulting in increased visibility and a decrease in performance (more terrain to render). The --fog-fastest option will enable fog rendering in a less realistic way, but improving performance. By default, the --fog-nicest option is used to render a realistic fog, at the expense of performance. These options are deprecated.

--fov=degrees

Specify field of view angle.

--geometry=WidthxHeight

Specify window geometry/resolution (640x480, etc).

--graphics-preset={minimal-quality|low-quality|medium-quality|high-quality|ultra-quality}

Specify a graphic preset.

--materials-file=file

Specify the materials file used to render the scenery (default: Materials/regions/materials.xml).

--max-fps=Hz

Maximum frame rate in Hz.

--shading-smooth
--shading-flat

Enable smooth or flat shading. These options are deprecated.

--texture-filtering={1|2|4|8|16}

Specify anisotropic filtering of terrain textures. Valid values is 1, 2, 4, 8, 16. Default is 1.

--view-offset={LEFT|CENTER|RIGHT|value}

Specify the default forward view direction as an offset from straight ahead. Allowable values are LEFT, RIGHT, CENTER, or a specific number in degrees.

--terrain-engine={tilecache|pagedLOD}

Specify the terrain engine you want to use: tilecache or pagedLOD.

--lod-levels=levels

Specify the detail levels, where levels are a space-separated numeric list of levels. The default is "1 3 5 7 9". Use with --terrain-engine=pagedLOD.

--lod-res=resolution

Specify the resolution of the terrain grid. Defaults is 1. Use with --terrain-engine=pagedLOD.

--lod-texturing={bluemarble|raster|debug}

Specify the method of texturing the terrain. The default is bluemarble. Use with --terrain-engine=pagedLOD.

--lod-range-mult=multiplier

Specify the range multiplier (point from low to fine detail). Defaults is 2. Use with --terrain-engine=pagedLOD.

WS3.0

--prop:/scenery/use-vpb=true

Activate the use of World Scenery 3.0.

Hud Options

--hud[={true|false|1|0|yes|no}]
--enable-hud
--disable-hud

Enable/disable Heads Up Display (HUD).

--anti-alias-hud[={true|false|1|0|yes|no}]
--enable-anti-alias-hud
--disable-anti-alias-hud

Enable/disable anti-aliased HUD.

--hud-3d[={true|false|1|0|yes|no}]
--enable-hud-3d
--disable-hud-3d

Enable/disable 3D HUD.

--hud-tris
--hud-culled

Hud displays number of triangles rendered or percentage of triangles culled.

Time Options

The following time and date setting options are not compatible with each other, so only one of them should be given.

--timeofday={real|dawn|morning|noon|afternoon|dusk|evening|midnight}

Specify a time of day.

--time-offset=[+-]hh:mm:ss

Add this time offset to --time-match-real.

--time-match-real

Synchronize time with current time at chosen airport.

--time-match-local

Synchronize time with system time of computer.

--start-date-sys=yyyy:mm:dd:hh:mm:ss

Specify a starting date/time with respect to system time.

--start-date-gmt=yyyy:mm:dd:hh:mm:ss

Specify a starting date/time with respect to Greenwich Mean Time.

--start-date-lat=yyyy:mm:dd:hh:mm:ss

Specify a starting date/time with respect to Local Aircraft Time.

Network Options

--proxy=[user:password@]host:port

Specify the proxy server and port to be used. Username and password are optional. If present, they should be listed as MD5 hashes. This option is only useful when --real-weather-fetch is enabled.

--httpd=port

Enable HTTP server on the specified port.

--telnet={port|socket,bi,hz,localhost,port,tcp} (--props={port|socket,bi,hz,localhost,port,tcp})

Enable telnet server on the specified port. Optionally, you can change the hz (number of packets per second).

--jpg-httpd=port

Enable screen shot HTTP server on the specified port. This option has been withdrawn, instead use --httpd and /screenshot URL.

--allow-nasal-from-sockets[={true|false|1|0|yes|no}]
--enable-allow-nasal-from-sockets
--disable-allow-nasal-from-sockets

Enable/disable allowing executing Nasal scripts from sockets. 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.

--sentry[={true|false|1|0|yes|no}]
--enable-sentry
--disable-sentry

Enable/disable crash and error reports from being sent to the development team for analysis.

MultiPlayer Options

--callsign=name

Assign a unique name to a player. A call sign must be at most 10 characters long and can only contain numbers, letters of the English alphabet, hyphens (-) and underscores (_). Longer call signs are truncated, and characters that do not match those listed above are replaced with hyphens.

--multiplay={in|out},hz,address,port

Specify multipilot communication settings. Multiple instances can be used.

--fgcom[={true|false|1|0|yes|no}]
--enable-fgcom
--disable-fgcom

Enable/disable built-in FGCom (voice communication with ATC.)

--hold-short[={true|false|1|0|yes|no}]
--enable-hold-short
--disable-hold-short

In multiplayer mode, when you select an initial position on the runway, you will be moved by default to the hold-short position (--hold-short), which is on the taxiway, just in front of the runway. The --disable-hold-short option allows you to disable this behavior, but keep in mind that this is undesirable, as it may interfere with others taking off or landing.

Route/Way Point Options

--wp=ID[@alt]

Specify a waypoint for the GC autopilot. Multiple instances can be used.

--flight-plan=file

Read all waypoints from a file.

IO Options

--generic=params

Open connection using a predefined communication interface and a preselected communication protocol.

--atlas=params

Open connection using the Atlas protocol.

--atcsim=params

Open connection using the ATC sim protocol (atc610x).

--AV400=params

Emit the Garmin AV400 protocol required to drive a Garmin 196/296 series GPS.

--AV400Sim=params

Emit the set of AV400 strings required to drive a Garmin 400-series GPS from FlightGear.

--AV400WSimA=params, --AV400WSimB=params

The Garmin WAAS GPS uses 2 serial channels to communicate with the simulator. These 2 channels are represented by the FGAV400WSimA and the FGAV400WSimB classes. The "A" channel is similar to the previous AVSim400 protocol. The "B" channel is considered the "GPS" channel and uses a different protocol than the "A" channel. The GPS unit expects input on the "B" channel at two different frequencies (1hz and 5hz, normally). The "B" channel also expects responses to certain output messages.

--flarm=params

Open connection using the FLARM protocol, which includes NMEA/GPS and traffic reporting messages.

--garmin=params

Open connection using the Garmin GPS protocol.

--hla=params

Open a remote connection using the HLA protocol. Currently, this option is disabled.

--hla-local=params

Open a local connection using the HLA protocol. Currently, this option is disabled.

--igc=params

Open connection using the International Gliding Commission (IGC) protocol.

--joyclient=params

Open connection to an Agwagon joystick.

--jsclient=params

Open connection to a remote joystick.

--native=params

Open connection using the FG Native protocol.

--native-ctrls=params

Open connection using the FG Native Controls protocol.

--native-fdm=params

Open connection using the FG Native FDM protocol.

--native-gui=params

Open connection using the FG Native GUI protocol.

--nmea=params

Open connection using the NMEA protocol.

--opengc=params

Open connection using the OpenGC protocol.

--props=params

Open connection using the interactive property manager (same as --telnet).

--pve=params

Open connection using the PVE protocol (ProVision Entertainment - some sort of motion platform).

--ray=params

Open connection using the Ray Woodworth motion chair protocol.

--rul=params

Open connection using the RUL protocol (some sort of motion platform some guy was building).

Under Windows, you must use a special escape sequence if you need to specify a COM port higher than 9.

Example: --generic=\\.\COM10,out,1,/tmp/data.xml,myproto

This is per the Microsoft KB article here: http://msdn.microsoft.com/en-us/library/aa363858%28v=vs.85%29.aspx

Avionics Options

--com1=frequency, --com2=frequency

Set the COM1 and COM2 radio frequency.

--nav1=[radial:]frequency, --nav2=[radial:]frequency

Set the NAV1 and NAV2 radio frequency, optionally preceded by a radial.

--adf1=[rotation:]frequency, --adf2=[rotation:]frequency

Set the ADF1 and ADF2 frequency to frequency kHz. You can optionally specify the rotation angle of its compass card by prefixing the frequency with the angle and a colon. The --adf option is deprecated.

--dme={nav1|nav2|frequency}

Slave the ADF to one of the NAV radios, or set its internal frequency.

Environment Options

--real-weather-fetch[={true|false|1|0|yes|no}]
--enable-real-weather-fetch
--disable-real-weather-fetch

Enable/disable METAR based real weather fetching. Enable requires an open internet connection.

--horizon-effect[={true|false|1|0|yes|no}]
--enable-horizon-effect
--disable-horizon-effect

Enable/disable celestial body growth illusion near the horizon.

--visibility=meters
--visibility-miles=miles

Specify initial visibility in meters or in statute miles. It works only with Basic Weather.

--wind=DIR[:MAXDIR]@SPEED[:GUST]

Specify the direction from which the wind is blowing (DIR in degrees) and its SPEED (in knots). If the wind direction is variable, specify the range as DIR:MAXDIR, as a minimum and maximum angle in degrees. If you want the simulator to also model wind gusts, set the maximum :GUST rate in knots.

--turbulence=value

Specify turbulence where value must to be from 0.0 (calm) to 1.0 (severe).

--ceiling=FT_ASL[:THICKNESS_FT]

Create an overcast ceiling, optionally with a specific thickness (defaults to 2000 ft). This option looks like it has been broken for a long time and doesn't work at all.

--random-wind

Set up random wind direction and speed.

--metar="metar string"

Starts with a certain METAR string. Only works if live weather is disabled.

Situation Options

--failure={pitot|static|vacuum|electrical}

Fail the pitot, static, vacuum, or electrical system (repeat the option for multiple system failures).

Debugging Options

--console[={true|false|1|0|yes|no}] (-c)

Enable/Disable displaying console (Windows specific.) Short -c always enable console.

--developer[={true|false|1|0|yes|no}]
--enable-developer
--disable-developer

Enable/Disable developer mode which will log more events.

--fpe[={true|false|1|0|yes|no}]
--enable-fpe
--disable-fpe

Enable/Disable aborting on encountering a floating point exception.

--fgviewer file

Use a model viewer rather than load the entire simulator.

--json-report[={true|false|1|0|yes|no}]

Enable/Disable printing a report in JSON format on the standard output. The report will give useful information for debugging purposes, such as the FlightGear version, the scenery/aircraft paths in use, the TerraSync and the data download directories and the paths to navigation data files.

--log-level={bulk|debug|info|warn|alert}

Set the logging level for this session. 0 = verbose, 5 = alerts only. See also Commonly used debugging tools#fgfs.log.

--log-class={none|ai|aircraft|astro|atc|autopilot|clipper|cockpit| environment|event|flight|general|gl|gui|headless|input|instrumentation| io|math|nasal|navaid|network|osg|particles|sound|systems|terrain| terrasync|undefined|view|all}

Specify which logging class(es) to use.

--log-dir={desktop|path}

Save the logs in the given directory. If desktop is entered instead of the path, the logs are saved on the Desktop. This option may be given several times, using a different directory each time. Inside the specified directory, the log file will be named FlightGear_YYYY-MM-DD_num.log, where YYYY-MM-DD is the current date and num is a progressive number starting at 0.

--trace-read=property

Trace the reads for a property; multiple instances can be used.

--trace-write=property

Trace the writes for a property; multiple instances can be used.

--uninstall

Remove $FG_HOME directory. For Windows, it additionally removes TerraSync, Aircraft and TextureCache directories from download directory.

Related content

Wiki articles

Source files