FGFS(1)

📦
version 2024.1.6 · 2 versions
, in fedora 43, fedora 44, ubuntu resolute, ubuntu stonking

💖 fgfs — the FlightGear manual page, bestie edition 💖

okay so welcome to fgfs(1), aka the FlightGear man pages, aka the place where your girl explains the whole flight sim to you like we're texting at 2am. grab a snack 🍓, this is a long one, but I promise it slaps.

🌸 NAME 🌸

fgfs — literally the FlightGear flight simulator. that's it. that's the name. iconic.

✨ SYNOPSIS ✨

fgfs [options...]

yeah bestie, you just run it with options. that's the whole vibe. 💅

🦋 DESCRIPTION 🦋

okay so fgfs is the main executable for FlightGear. and FlightGear itself? it's a free, open-source, multi-platform, sophisticated flight simulator framework — built for developing and pursuing interesting flight simulator ideas. like, it's not just a game, it's a whole framework, and it's giving main character energy fr fr. 🛩️👑

💜 OPTIONS 💜

here's how the options actually get read, and this part matters, so pay attention bestie:

  1. First, options are read from the command-line arguments you passed to fgfs.
  2. Then the program checks whether ~/.fgfsrc.hostname exists (where hostname is the hostname of the machine) and whether ~/.fgfsrc exists. If at least one of those files exists, it gets read and parsed.

and if you're curious about the full specs of that file format, go peek at the fgfsrc(5) man page. 📖

conflicting options? the ones read last win. periodt.

🎀 General options 🎀

  • --help, -h — shows you usage info about the most relevant command-line options, then dips. ✌️
  • --verbose, -v — when you pair this with --help/-h, it shows usage info about all the command-line options, not just the relevant ones. the full tea, no filter. ☕
  • --version — spills the version info for fgfs plus some of the libraries it uses (SimGear, OpenSceneGraph, PLIB), then exits. flexing its whole stack, honestly. 💪
  • --fg-root=path — sets the FlightGear data root directory ($FG_ROOT) to path. If you don't set this option, fgfs uses the path in the FG_ROOT environment variable or — if that's not there either — the FlightGear data directory that got chosen back when the program was compiled. 🗂️
  • --fg-scenery=path — sets the FlightGear scenery directories ($FG_SCENERY) to path.

You can drop in multiple directories by separating them with colons (:), like /first/path:/second/path. On Microsoft Windows operating systems though, separate multiple paths with semicolons instead. when you do that, fgfs searches for scenery files following the order you wrote the paths in, and stops the second it finds a match. 🔍

If this option isn't set, fgfs uses the path in the FG_SCENERY environment variable or — absent that — the Scenery subdirectory inside $FG_ROOT.

  • --fg-aircraft=path — loads extra aircraft from path, on top of the Aircraft subdirectory inside $FG_ROOT. OR, alternatively, you can use --aircraft-dir to target a specific aircraft in a given directory. 🛫
  • --download-dir=path — stores aircraft and scenery downloaded through the simulator in path.

Also, the TerraSync directory can be specifically set with the --terrasync-dir option. 📥

  • --allow-nasal-read=dirs — lets Nasal aircraft scripts read files from the directories listed in dirs (separate multiple paths with colons, or semicolons on Microsoft Windows operating systems).

By default, Nasal scripts are allowed to read data only from $FG_ROOT and $FG_HOME, and that's a security measure. so like, this flag is you unlocking the door on purpose. 🔐

  • --read-only — makes $FG_HOME (where all your user-specific FlightGear data lives) read-only. 🚫✍️
  • --language=code — sets the language the simulator uses to code, where code is an ISO 639-1 two-letter locale code (for example, en or it). 🌍
  • --restore-defaults — resets all user settings back to their defaults. factory reset moment. 🔄
  • --enable-save-on-exit, --disable-save-on-exit — save / do not save user settings when the program exits.
  • --ignore-autosave — ignores the user settings saved the previous time FlightGear was run. and heads up: this option implies --disable-save-on-exit. 📝
  • --browser-app=path — uses the Web browser specified in path to open aircraft documentation. 🌐
  • --prop:[type:]name=value — sets the property name to value. You can optionally specify the property type by setting type to string, double, float, long, int or bool. 🧩
  • --config=path — loads additional configuration directives from path. That file should follow the format described in fgfsrc(5).
  • --no-default-config — don't load any configuration files unless they were explicitly specified with --config. no sneaky defaults, we're doing this on purpose. 💅
  • --units-feet — uses feet as the internal measure unit for distances. 🦶
  • --units-meters — uses meters as the internal measure unit for distances. 📏
  • --console — displays a console window for simulator/aircraft debugging purposes.

⚠️ This option is recognized only on Microsoft Windows operating systems; on other systems, debug messages are always printed to standard output/standard error anyway.

  • --launcher — starts the FlightGear Launcher, a graphical Qt-based interface to the simulator. ✨

heads up: this option is available only if FlightGear was compiled with Qt support enabled.

  • --json-report — prints a report in JSON format on the standard output. the report gives you useful debugging info, like the FlightGear version, the scenery/aircraft paths in use, the TerraSync and the data download directories, and the paths to navigation data files. 🧾

🔥 Features 🔥

  • --enable-panel, --disable-panel — enable/disable the pop-up aircraft instrument panel, if the chosen airplane has one.
  • --enable-hud, --disable-hud — enable/disable the heads-up display (HUD), if the chosen airplane has one.
  • --enable-anti-alias-hud, --disable-anti-alias-hud — enable/disable heads-up display antialiasing.
  • --enable-hud-3d, --disable-hud-3d — enable/disable the 3D version of the heads-up display.
  • --hud-tris — displays the number of triangles rendered when painting the heads-up display. 🔺
  • --hud-culled — displays the number of triangles culled when painting the heads-up display.
  • --enable-random-objects, --disable-random-objects — show/hide random scenery objects, like buildings. Scenery objects increase realism, but they require more resources (memory and graphic card power). so it's a tradeoff, bestie. 🏙️
  • --enable-random-vegetation, --disable-random-vegetation — show/hide random vegetation. 🌳
  • --enable-random-buildings, --disable-random-buildings — show/hide random buildings. 🏢
  • --enable-ai-models, --disable-ai-models — enable/disable the internal AI subsystem, which is required for multiplayer gaming, AI traffic and many other animations.
Disabling the internal AI subsystem is deprecated. just so you know.
  • --enable-ai-traffic, --disable-ai-traffic — enable/disable artificial plane traffic. ✈️
  • --ai-scenario=scenario — adds and enables the AI scenario scenario. and you can repeat this option multiple times to enable multiple scenarios. the more the merrier honestly.
  • --enable-freeze — starts the simulator in a frozen (paused) state. 🧊
  • --disable-freeze — starts the simulator in a running (unpaused) state. 🏃♀️
  • --enable-fuel-freeze — do not consume any fuel (keeps the quantity in the tanks constant). ⛽
  • --disable-fuel-freeze — consume fuel normally.
  • --enable-clock-freeze — doesn't let the clock advance while running the simulation. ⏰
  • --disable-clock-freeze — lets the clock advance normally.
  • --failure=pitot|static|vacuum|electrical — fails the aircraft pitot, static, vacuum or electrical systems. you can repeat this option multiple times to fail more than one system. chaotic, but okay. 💀
  • --load-tape=tape — loads and replays the flight recorder tape tape. 📼

🔊 Audio options 🔊

  • --show-sound-devices — shows a list of available audio devices and exits. 🎧
  • --sound-device=name — sets the sound device to use to name, where name is the device name shown by the --show-sound-devices option.
  • --enable-sound, --disable-sound — enable/disable sound in the simulator.

🌈 Rendering options 🌈

  • --terrain-engine=tilecache|pagedLOD — chooses the terrain engine to use. tilecache is the "traditional" terrain engine (recommended ✅); pagedLOD is a new, experimental terrain engine designed to minimize memory usage by loading more detailed versions of scenery objects on demand.

ngl the pagedLOD engine is available only if FlightGear was compiled with GDAL support.

  • --lod-levels=levels — sets the level of detail levels to levels, where levels is a space-separated list of numeric levels. ⚠️ this option is available only if the terrain engine in use is pagedLOD.
  • --lod-res=resolution — sets the terrain mesh resolution to resolution. ⚠️ available only if the terrain engine in use is pagedLOD.
  • --lod-texturing=bluemarble|raster|debug — sets the terrain texture method. ⚠️ available only if the terrain engine in use is pagedLOD.
  • --lod-range-mult=multiplier — sets the range multiplier (the breakpoint from a low to a high level of detail) to multiplier. ⚠️ available only if the terrain engine in use is pagedLOD.
  • --enable-splash-screen, --disable-splash-screen — show/hide the simulator splash screen while loading the aircraft/scenery.
  • --enable-mouse-pointer, --disable-mouse-pointer — force enable display / do not force display the mouse pointer at startup. 🖱️
  • --max-fps=frequency — limits the maximum frame rate of the simulator to frequency Hz (frames per second). 🎞️
  • --bpp=depth — uses a color depth of depth bits per pixel to display the aircraft and scenery.
  • --fog-disable, --fog-fastest, --fog-nicest — choose the fog/haze rendering technique. --fog-disable disables fog/haze entirely; --fog-fastest explicitly asks the graphics card driver to choose the most efficient — but possibly less accurate — fog/haze rendering algorithm; --fog-nicest leaves the algorithm choice to the driver, which leads to higher quality results. 🌫️
  • --enable-enhanced-lighting, --disable-enhanced-lighting — enable/disable enhanced runway lighting.
This option is deprecated. just saying. 🚨
  • --enable-distance-attenuation, --disable-distance-attenuation — enable/disable runway light distance attenuation (the runway lights become less intense as distance increases). 💡
  • --enable-horizon-effect, --disable-horizon-effect — enable/disable the celestial body growth illusion near the horizon. 🌅
  • --enable-specular-highlight, --disable-specular-highlight — enable/disable specular reflections on textured objects. ✨
  • --fov=degrees — sets the field of view angle (FOV) to degrees. High field of view angles let you see a wider part of the world; low angles let you "zoom in" on details. 🔭

and that's part 1 bestie, keep scrolling, we're not done yet 💖

  • --aspect-ratio-multiplier=factor — sets the horizontal and vertical aspect ratio multiplier to factor. Slay those pixels, bestie. ✨
  • --enable-fullscreen, --disable-fullscreen — turn fullscreen mode on/off. 🖥️
  • --shading-flat, --shading-smooth — flat vs smooth shading. If flat shading is active, the simulator uses the same color to paint the face of an object: this is faster, but makes edges more pronounced. Smooth shading smooths color changes between vertices, leading to higher-quality results, at an expense in performance. ✨
  • --materials-file=file — load the definitions of the materials used to render the scenery from file. By default, materials are loaded from $FG_ROOT/regions/materials.xml. 🎨
  • --texture-filtering=value — set the anisotropic texture filtering to value. The acceptable values are 1 (default), 2, 4, 8 or 16. 🔍
  • --enable-wireframe, --disable-wireframe — enable/disable the wireframe drawing mode (in which only object edges are painted). 🕸️
  • --geometry=widthxheight — set the window geometry (size) to widthxheight (both width and height are in pixels). 📐
  • --view-offset=LEFT|RIGHT|CENTER|value — specify the default forward view direction as an offset from straight ahead. The allowed values are LEFT (-90°), RIGHT (90°), CENTER (0°) or a specific number in degrees. 👀

✈️ Aircraft options ✈️

  • --aircraft=name, --vehicle=name — load an aircraft/vehicle from a set file named name-set.xml. The file is searched for in $FG_ROOT/Aircraft, in the directory pointed to by the environment variable FG_AIRCRAFT and in the directories passed to fgfs(1) using the --fg-aircraft option. 🛩️
  • --aircraft-dir=path — explicitly specify the directory in which the -set.xml file should be searched for. If this argument is used, the path cache stored in ~/.fgfs/autosave_X_Y.xml, the directories passed with the --fg-aircraft option and the directory specified in the FG_AIRCRAFT environment variable are not taken into account. 📁
  • --show-aircraft — print a list of available aircraft and exit. 📋
  • --min-status=alpha|beta|early-production|production — do not list aircraft having a status level (development status) lower than the one specified. See the FlightGear wiki "Aircraft rating system" page for an extended description of aircraft ratings. ⭐
  • --fdm=jsb|larcsim|yasim|magic|balloon|ada|external|null — select the core flight dynamics model to use among the following ones:
    • jsb: the JSBSim flight dynamics model, which takes a data-driven approach to modeling: given the performance data for an aircraft (mass and balance, ground reactions, propulsions, aerodynamics...), it assembles it together to produce the global aircraft dynamics;
    • larcsim: the LaRCsim flight dynamics model, the original model used in FlightGear up to 2000, developed at NASA, now inactive;
    • yasim: the YASim flight dynamics model, which, given the physical and flying characteristics of an aircraft, attempts to solve for them;
    • magic: the "Magic Carpet" flight model;
    • balloon: a hot air balloon simulation;
    • ada: an externally-driven flight dynamics model designed by the Aeronautical Development Agency of Bangalore, India;
    • external/null: use an external flight dynamics model (the external option has the same meaning as null and is maintained for backward compatibility purposes).
  • --aero=name — load the aircraft aerodynamics model from the file name.xml in the aircraft directory. 🌬️
  • --model-hz=n — run the flight dynamics model at a frequency of n Hz (n times per second). ⚡
  • --speed=n — run the flight dynamics model n times faster than real time. ⏩
  • --trim, --notrim — trim/do not attempt to trim the model. This option is only valid if the flight dynamics module in use is JSBSim. ✂️
  • --on-ground — start the aircraft on the ground. This is the default option. 🛬
  • --in-air — start the aircraft in the air. This option is implied if --altitude is specified. 🛫
  • --enable-auto-coordination, --disable-auto-coordination — enable/disable auto coordination (joint control of rudder and ailerons). 🎮
  • --livery=name — load the aircraft livery from a file named name. 🎨
  • --state=value — set the initial aircraft state to value. The states that can be used are aircraft-dependent. 📌

⏰ Time options ⏰

  • --timeofday=real|dawn|morning|noon|afternoon|dusk|evening|midnight — start the simulator at the specified time of day:
    • real: real clock time;
    • dawn: the time when the Sun is 90° E on the horizon;
    • morning: the time when the Sun is 75° E on the horizon;
    • noon: the time when the Sun is 0° on the horizon;
    • afternoon: the time when the Sun is 75° W on the horizon;
    • dusk: the time when the Sun is 90° W on the horizon;
    • evening: the time when the Sun is 100° W on the horizon;
    • midnight: the time when the Sun is 180° on the horizon.
  • --season=summer|winter — load summer/winter textures. ❄️☀️
  • --time-offset=[+|-]hh:mm:ss — add a time offset to the startup time specified with the --timeofday option. ⏳
  • --time-match-real — synchronize the simulator time with real world GMT time. 🌍
  • --time-match-local — synchronize the simulator time with real world local time. 📍
  • --start-date-sys=yyyy:mm:dd:hh:mm:ss — specify the simulator starting date and time with respect to the local timezone of the system. 🗓️
  • --start-date-gmt=yyyy:mm:dd:hh:mm:ss — specify the simulator starting date and time with respect to the Greenwich Mean Time. 🌐
  • --start-date-lat=yyyy:mm:dd:hh:mm:ss — specify the simulator starting date and time with respect to the timezone of the starting airport. 🛫

📍 Initial position and orientation 📍

  • --airport=ID — start the simulator at the airport having ID as its ICAO code. 🛬
  • --parking-id=name — place the aircraft at the parking position name. This option requires the --airport option to be present. 🅿️
  • --runway=number — place the aircraft on runway number. This option requires the --airport option to be present. 🛣️
  • --carrier=name|ID — place the aircraft on the AI carrier named name/having the ID ID. 🚢
  • --parkpos=name — place the aircraft at the starting position name. This option requires the --carrier option to be present. ⚓
  • --vor=ID — place the aircraft over the VOR ID. 📡
  • --vor-frequency=frequency — set the frequency of the VOR to frequency. This option requires the --vor option to be present. 📻
  • --ndb=ID — place the aircraft over the NDB ID. 📶
  • --ndb-frequency=frequency — set the frequency of the NDB to frequency. This option requires the --ndb option to be present. 🎚️
  • --fix=ID — place the aircraft over the fix ID. 📍
  • --offset-distance=nm — place the aircraft nm statute miles away from the reference point specified by the previous options. 📏
  • --offset-azimuth=degrees — place the aircraft at a heading of degrees degrees with respect to the reference point specified by the previous options. 🧭
  • --lon=degrees, --lat=degrees — place the aircraft at the point with the coordinates (lat, lon). Northern longitudes/eastern latitudes must be positive; southern longitudes/western latitudes must be negative. 🌐
  • --altitude=value — place the aircraft at an altitude of value feet (meters if the --units-meters option was specified). ⛰️
  • --heading=degrees — specify the initial heading (yaw) angle (psi) of the aircraft. 🧭
  • --roll=degrees — specify the initial roll angle (phi) of the aircraft. 🔄
  • --pitch=degrees — specify the initial pitch angle (theta) of the aircraft. 📐
  • --uBody=units_per_sec — specify the initial velocity along the body X axis. ➡️
  • --vBody=units_per_sec — specify the initial velocity along the body Y axis. ⬆️
  • --wBody=units_per_sec — specify the initial velocity along the body Z axis. ⬇️
  • --vNorth=units_per_sec — specify the initial velocity along the body North-South axis. 🧭
  • --vEast=units_per_sec — specify the initial velocity along the body West-East axis. 🌅
  • --vDown=units_per_sec — specify the initial velocity along the body vertical axis. ⬇️
  • --vc=knots — set the initial airspeed of the aircraft to knots knots. 💨
  • --mach=number — set the initial airspeed of the aircraft to Mach number. 🚀
  • --glideslope=degrees — set the flight path angle to degrees degrees. The value can be positive. 📉
  • --roc=fpm — set the initial rate of climb to fpm feet per minute. The value can be negative. 📈

🗺️ Route/waypoint options 🗺️

  • --wp=ID[@alt] — enter the waypoint (VOR, NDB, fix) ID into the autopilot. The optional part @alt can be used to specify the altitude at which ID should be crossed. 🧭
  • --flight-plan=file — read a flight plan from file. 📄

📻 Avionics options 📻

  • --com1=frequency — set the COM1 frequency to frequency MHz. 📻
  • --com2=frequency — set the COM2 frequency to frequency MHz. 📻
  • --nav1=[radial:]frequency — set the NAV1 frequency to frequency MHz. You can optionally specify a radial by prefixing the frequency with the heading and a colon. 📡
  • --nav2=[radial:]frequency — set the NAV2 frequency to frequency MHz. You can optionally specify a radial by prefixing the frequency with the heading and a colon. 📡
  • --adf1=[rotation:]frequency, --adf=[rotation:]frequency — set the ADF1 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. 🧭
  • --adf2=[rotation:]frequency — set the 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. 🧭
  • --dme=nav1|nav2|frequency — slave the automatic direction finder to the NAV1/NAV2 radio or set its internal frequency to frequency. 📻

🌤️ Environment options 🌤️

  • --metar=METAR — okay so you can simulate the weather conditions described by the METAR string METAR. This option implies --disable-real-weather-fetch. 💨
  • --enable-real-weather-fetch, --disable-real-weather-fetch — bestie, turn METAR-based real weather fetching on or off. Heads up: this feature requires an active Internet connection. 🌐
  • --enable-clouds, --disable-clouds — enable/disable 2D (flat) cloud layers. ☁️
  • --enable-clouds3d, --disable-clouds3d — enable/disable 3D (volumetric) cloud layers. ☁️☁️
  • --visibility=meters — set the initial visibility to meters meters. 👀
  • --visibility-miles=miles — set the initial visibility to miles miles. 👀
  • --wind=dir[:maxdir]@speed[:gust] — specify the direction the wind blows from (dir) and its speed (speed knots). If the wind is not meant to blow from a fixed direction, but rather from a range of directions, specify the range as dir:maxdir, where dir and maxdir are the minimum and maximum angles in degrees. If you want the simulator to model wind gusts as well, set gust to their maximum intensity in knots. 🌬️
  • --random-wind — randomize the direction and speed of the wind. 🎲
  • --turbulence=intensity — set the turbulence intensity to intensity. The intensity can range from 0.0 (calm) to 1.0 (severe). 😵‍💫
  • --ceiling=ft_asl[:thickness_ft] — create an overcast ceiling at a height of ft_asl feet above the mean sea level. You can optionally specify a thickness by appending a colon (:) and the desired thickness in feet; if you omit it, the simulator will default to 2000 ft. 🌫️

🌐 Network options 🌐

  • --callsign=value — set the multiplayer callsign to value. The callsign must be at most ten characters long and must contain only numbers, letters of the English alphabet, dashes (-) and underscores (_); longer callsigns are truncated, and characters not matching those listed above are replaced with dashes. 📻
  • --multiplay={in|out},hz,address,port — specify the multiplayer communication settings. The first field specifies whether the settings apply to inbound (in) or outbound (out) communications. The second field (hz) specifies the frequency (in Hz, times per second) at which data should be sent. The third field (address) must be set to the IP address of the network interface that FlightGear should use to send/receive data, or left blank to let the simulator use all available interfaces. The fourth field (port) should be set to the port to use (usually 5000). 🕹️
  • --proxy=[username:password@]host:port — specify the proxy server and port to use. The username and password are optional; if they are present, they should be given as MD5 hashes. This option is only useful if --real-weather-fetch is enabled. 🔐
  • --httpd=[address:]port — enable the Phi interface (HTTP server) on the specified address and port. The address is optional. 🖥️
  • --telnet=port — enable the Telnet interface on the specified port. 📡
  • --jpg-httpd=port — enable the screenshot HTTP server interface on the specified port. This option is deprecated: use the Phi interface instead. 🚫
  • --enable-terrasync, --disable-terrasync — enable/disable automatic scenery/object downloads. 🗺️
  • --terrasync-dir=directory — set the directory where the downloaded scenery will be stored to directory. 📁
  • --enable-fgcom, --disable-fgcom — enable/disable the FGCom (voice ATC) integration. 🎙️

🔌 I/O options 🔌

  • --generic=params, --atlas=params, --atcsim=params, --AV400=params, --AV400Sim=params, --AV400WSimA=params, --AV400WSimB=params, --garmin=params, --hla=params, --hla-local=params, --igc=params, --joyclient=params, --jsclient=params, --native-ctrls=params, --native-gui=params, --native-fdm=params, --native=params, --nmea=params, --opengc=params, --props=params, --pve=params, --ray=params, --rul=params — open a connection to drive external programs or hardware.

Specify the protocol by using the correct command-line option:

  • generic: a predefined communication interface and a preselected communication protocol;
  • atlas: the Atlas protocol;
  • atcsim: the ATCsim (atc610x) protocol;
  • AV400: the Garmin AV400 protocol, required to drive a Garmin 196/296 series GPS;
  • AV400Sim: the set of AV400 strings required to drive a Garmin 400-series GPS;
  • AV400WSimA, AV400WSimB: the set of strings required to drive a Garmin WAAS GPS (where the A channel uses a variant of the AVSim400 protocol and the B channel communicates with the GPS unit);
  • garmin: the Garmin GPS protocol;
  • hla, hla-local: the HLA protocol, either remote or local;
  • igc: the International Glider Commission protocol;
  • joyclient: the protocol used by Agwagon joysticks;
  • native-ctrls: the FlightGear Native Controls protocol;
  • native-gui: the FlightGear Native GUI protocol;
  • native-fdm: the FlightGear Native FDM protocol;
  • native: the FlightGear Native protocol;
  • nmea: the NMEA protocol (used to drive most GPS units);
  • opengc: the protocol used by OpenGC, a software used to render high-quality glass cockpit displays for simulated flightdecks;
  • props: the interactive property manager protocol;
  • pve: the PVE protocol;
  • ray: the Ray Woodworth motion chair protocol;
  • rul: the RUL protocol.

The parameters (params) must be in the form medium,direction,hz,medium_options where medium is the medium used by the protocol (serial, socket, file...), direction is the communication direction (in, out or bi), hz is the frequency the channel should be processed at (floating point values are accepted) and medium_options are:

  • for serial protocols, device,baud, where device is the device name to be opened and baud is the communication baud rate;
  • for socket protocols, machine,port,style, where machine is the machine name or the IP address of the server (if the simulator should act as a client) or is left empty (if the simulator should act as a server), port is the port to use (or is left empty to ask the operating system to choose an available port) and style is tcp or udp;
  • for file protocols, filename, where filename is the name of the file data should be written to.

🐛 Debugging options 🐛

  • --enable-fpe — abort when a floating-point exception is encountered. 💥
  • --fgviewer — view the scenery and the aircraft in a simple model viewer, without loading the entire simulator. ✈️
  • --log-level=bulk|debug|info|warn|alert — set the minimum logging level. Log messages having a severity greater than or equal to the specified value are recorded; the others are discarded. 📝
  • --log-class=all|none|ai|environment|flight|general|io|network|sound|terrain|... — log only events belonging to the specified log classes (all logs all events, none logs none). Multiple classes can be specified by separating them with commas or pipes, for example: --log-class=ai,flight. 🗂️
  • --log-dir=dir — save the logs in the directory dir. If dir is desktop, 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-write=property — trace the reads/writes for a property (print a log message whenever property is read from/written to). 🔍
  • --developer — enable developer mode. 🛠️

🚦 EXIT STATUS 🚦

fgfs exits with 0 if the execution completes successfully, or with another status (usually 1 or -1) if an error occurred. 💀

🌍 ENVIRONMENT 🌍

  • COMPUTERNAME — specifies the hostname of the system in use. This environment variable is only taken into account on Microsoft Windows operating systems. 🪟
  • FG_AIRCRAFT — specifies the path in which aircraft should be searched for. ✈️
  • FG_LAUNCHER — if this environment variable is set and is not 0, the Qt launcher will be shown. The variable is mainly used on Mac OS X operating systems to avoid the use of wrapper scripts. 🍎
  • FG_ROOT — specifies the root data directory to use. 📁
  • FG_SCENERY — specifies the scenery directory to use. 🏞️
  • HTTP_PROXY — specifies the HTTP proxy to use. Must be in the form http://host:port/. 🌐
  • LANG — specifies the language to use. 🗣️

📁 FILES 📁

  • ~/.fgfs — the main directory where FlightGear configuration files and data (downloaded aircraft/scenery) are stored. 📂
  • ~/.fgfsrc.hostname, ~/.fgfsrc — configuration files containing command-line options for fgfs(1). ⚙️

okay bestie, that's the whole manual page! this was FlightGear, dated 2017-06-25, and it's page FGFS(1). love you, bye! 💖✨

📦 where this page comes from