fgcom man page

fgcom — VoIP client for the FlightGear radio infrastructure

Synopsis

fgcom [--server=server] [--host=listeninghost] [--port=port] [--callsign=callsign] [--frequency=frequency] [--atis=frequency] [--airport=code] [--username=user] [--password=pass] [--silence-threshold=threshold] [--debug] [--help] [--version]

Description

fgcom is the FlightGear utility used for connecting to multiplayer voice servers.

It is usually not necessary to run fgcom from the command line, as it is already integrated into FlightGear, with the exception of a few specific cases (such as recording ATIS messages or performing a radio check, see the Example section).

Options

--server=server

Connect to the FGCom server server. By default, FGCom tries to connect to fgcom.flightgear.org.

--host=listeninghost, --port=port

Listen on the network interface having the IP address listeninghost, on port port. By default, FGCom listens on the loopback interface (127.0.0.1) on port 16661.

The specified port can be used by an instance of FlightGear to communicate with FGCom and update the pilot position as they fly.

--callsign=callsign

Use the callsign callsign during the session. By default, FGCom uses guest as callsign.

--frequency=frequency

Set the active radio frequency to frequency. The frequency must be written in the format xxx.xxx and must be given in MHz.

--atis=frequency

Record an ATIS message on frequency MHz. The frequency must be written in the format xxx.xxx and must be given in MHz.

--airport=code

Position the pilot/controller to the airport having the ICAO code code.

Since some radio frequencies might be reused across the world, it is essential to set the pilot/controller position correctly to make the FGCom server able to determine the correct voice channel. Always use this flag if you are not connecting a FlightGear instance to FGCom.

--username=user, --password=pass

Log in to the FGCom server using the username user and the password pass.

--silence-threshold=threshold

Set the silence threshold to threshold dB. The value must be between -60 and 0. The default is -35.0 dB.

The silence threshold is the level below which the sound captured by the microphone is considered background noise (and, thus, filtered out by FGCom). Setting the silence threshold to -60 turns the filter off; setting it to 0 filters everything (mutes the microphone).

--debug

Enable debug output for troubleshooting purposes.

--help

Display usage information and exit.

--version

Display the FGCom version and exit.

Exit Status

fgcom exits with EXIT_SUCCESS on success, with EXIT_FAILURE if the syntax of the command-line arguments is wrong or an error occurs.

Notes

FGCom understands several special frequencies used for testing purposes or general chatting:

Bugs

Example

Connect to the default FGCom server, switch to the San Francisco International Airport (KSFO) ground frequency (121.800 MHz) and allow FlightGear to update the current pilot position by sending it to port 16661 (the default one):

   $ fgcom --frequency=121.800 --airport=KSFO

Perform a radio check by connecting to the echo test frequency:

   $ fgcom --frequency=910.000

Record an ATIS message on the San Francisco International Airport (KSFO) ATIS frequency (118.850 MHz):

   $ fgcom --atis=118.850 --airport=KSFO

See Also

fgfs(1), the FlightGear wiki "FGCom 3.0" page

Info

2017-06-04 FlightGear man pages