table of contents
FLDIGI(1) | FLDIGI(1) |
NAME¶
fldigi - digital modem program for hamradio operatorsSYNOPSIS¶
fldigi [OPTIONS]DESCRIPTION¶
Fldigi is a cross-platform multi-modem program for most of the digital modes used by radio amateurs today: CW, PSK, MFSK, MT-63, RTTY, Hellschreiber, DominoEX, Olivia, THOR and Throb are all supported. It can also help calibrate a sound card to a time signal and do on-air frequency measurement tests. Fldigi features basic rig control, logging, and contest operation, “panoramic” PSK decoding, a PSK Reporter client, and remote control via XML-RPC.OPTIONS¶
Long options begin with two hyphens and are handled by fldigi. The option names may be abbreviated to any unambiguous substring, and the option argument may be separated from the name by a space or equals sign, as per getopt(3).Short options begin with a single hyphen and are passed directly to FLTK. They may be abbreviated only as indicated.
--config-dir DIRECTORY
--rx-ipc-key KEY
--tx-ipc-key KEY
--arq-server-address HOSTNAME
--arq-server-port PORT
Note
The --xmlrpc-* options are only available if fldigi was built with XML-RPC support.
--xmlrpc-server-address HOSTNAME
--xmlrpc-server-port PORT
--xmlrpc-allow REGEX
--xmlrpc-deny REGEX
--xmlrpc-list
--cpu-speed-test
--noise
--wfall-only
--debug-level LEVEL
--version
--build-info
--help
Standard FLTK options¶
-bg, -background COLOUR-bg2, -background2 COLOUR
-di, -display DISPLAY
-dn, -dnd or -nodn, -nodnd
-fg, -foreground COLOUR
-g, -geometry GEOMETRY
-i, -iconic
-k, -kbd or -nok, -nokbd
-na, -name CLASSNAME
-ti, -title WINDOWTITLE
Additional UI options¶
--font FONT[:SIZE]Options useful to developers¶
Note
The --benchmark-* options are only enabled if fldigi was built (exclusively) for benchmarking and batch decoding.
--benchmark-modem ID
--benchmark-frequency FREQ
--benchmark-afc BOOLEAN
--benchmark-squelch BOOLEAN
--benchmark-squelch-level LEVEL
--benchmark-input INPUT
--benchmark-output FILE
--benchmark-src-ratio RATIO
--benchmark-src-type TYPE
Warning
The following options should not be relied upon. They are listed here only for the sake of completeness, and may be replaced by GUI settings or removed altogether in a future version.
--wfall-width WIDTH
--wfall-height HEIGHT
--window-width WIDTH
--window-height HEIGHT
--exit-after SECONDS
--frames-per-buffer FRAMES
ENVIRONMENT¶
Fldigi uses several environment variables, mainly set for child processes created by the <EXEC> macro and the notifier.General variables¶
FLDIGI_BROWSERMacro variables¶
The following variables are created in the environment of the child process that is forked by the <EXEC> macro. They are empty if values are not available.FLDIGI_RX_IPC_KEY
FLDIGI_TX_IPC_KEY
FLDIGI_XMLRPC_ADDRESS
FLDIGI_XMLRPC_PORT
FLDIGI_ARQ_ADDRESS
FLDIGI_ARQ_PORT
FLDIGI_VERSION
FLDIGI_PID
FLDIGI_CONFIG_DIR
FLDIGI_MY_CALL
FLDIGI_MY_NAME
FLDIGI_MY_LOCATOR
FLDIGI_MODEM
FLDIGI_MODEM_LONG_NAME
FLDIGI_DIAL_FREQUENCY
FLDIGI_AUDIO_FREQUENCY
FLDIGI_FREQUENCY
FLDIGI_LOG_FREQUENCY
FLDIGI_LOG_TIME_ON
FLDIGI_LOG_TIME_OFF
FLDIGI_LOG_CALL
FLDIGI_LOG_NAME
FLDIGI_LOG_RST_IN
FLDIGI_LOG_RST_OUT
FLDIGI_LOG_QTH
FLDIGI_LOG_LOCATOR
FLDIGI_LOG_NOTES
FLDIGI_AZ
Notifier variables¶
The following variables are created in the environment of child processes created by the notifier.FLDIGI_NOTIFY_STRi
FLDIGI_NOTIFY_STR_NUM
FLDIGI_NOTIFY_CALLSIGN
FLDIGI_NOTIFY_TEXT
FLDIGI_NOTIFY_AUDIO_FREQUENCY
FLDIGI_NOTIFY_EVENT
FLDIGI_NOTIFY_COUNTRY
Debugging variables¶
The following variables are only used if fldigi was built with debugging support (--enable-debug), or they are only useful when debugging specific modules.FLDIGI_NO_EXEC
FLDIGI_TRACE_LOCKS
FLDIGI_HAMLIB_DEBUG
RESTRICTIONS¶
Fldigi is licensed under the GNU GPL, which grants you the right to run the program for any purpose (freedom 0). However, permission to use it for the transmission of radio signals can only be obtained from the communications authority of your country. When given, this permission almost always comes in the form of an amateur radio license.If you do not have an amateur radio license you can still have fun using fldigi as a shortwave listener. One way to do so is by using the builtin PSK Reporter client to submit realtime spots of transmitting stations; see RESOURCES below. All you need is a computer, homebrew SDR receiver, and simple wire antenna!
FILES¶
Various files and subdirectories are created in $HOME/.fldigi. Some of the most interesting ones are listed below.fldigi_def.xml
fldigi.prefs
status_log.txt
macros/macros.mdf
palettes/
scripts/
logs/
images/
freqanalysis.csv
Note
The following files are used if present. They must be downloaded and copied to ~/.fldigi/ by the user.
cty.dat
lotw1.txt
AGMemberList.txt or eqsl.txt
EXAMPLES¶
fldigi --wfall-height 144 --font sans:11 -fg "#c0c0c0" -bg "#5f5f63" -bg2 "#19213b"fldigi --xmlrpc-deny "main.(tx|tune|run_macro)"
ssh -L 7362:localhost:7362 remote-host xvfb-run fldigi -display :99
fldigi --benchmark-input 480000 --benchmark-modem 1
fldigi --benchmark-input audio.wav --benchmark-modem 25 --benchmark-frequency 1500 --benchmark-afc 1 --benchmark-squelch 1 --benchmark-squelch-level 5.0 --benchmark-output out.txt
BUGS¶
Yes.SEE ALSO¶
fldigi-shell(1), gmfsk(1), gpsk31(1), grig(1), rigctl(1), xlog(1), getaddrinfo(3), getopt(3), regex(7), X(7)RESOURCES¶
Main web site: http://www.w1hkj.com/Fldigi.htmlSourceforge project page: http://sourceforge.net/projects/fldigi/
Wiki and bug tracker: https://fedorahosted.org/fldigi/
More information on MFSK16, DominoEX and other digital modes can be found at http://www.qsl.net/zl1bpu/ and http://www.w1hkj.com/FldigiHelp/Modes/index.htm
The PSK Automatic Propagation Reporter site can be found at http://www.pskreporter.info/
AUTHORS¶
Fldigi was written byFldigi also includes code written by others. Among them are
This manual page was written by Stelios Bounanos <sb[at]enotty(dot)net>.
COPYING¶
License GPLv3+: GNU GPL version 3 or later.03/01/2019 |