FLDIGI-SHELL(1) 														   FLDIGI-SHELL(1)

NAME

       fldigi-shell - program for controlling fldigi

SYNOPSIS

       fldigi-shell [OPTIONS] [FILE]

DESCRIPTION

       The fldigi-shell program controls fldigi(1) over HTTP via XML-encoded remote procedure calls (XML-RPC). It can call any XML-RPC method
       exported by fldigi, and also defines some useful commands of its own.

OPTIONS

       -d
	   Enable debug output.

       -u URL
	   Use URL to access the server. Defaults to "http://localhost:7362/RPC2", which corresponds to fldigi's default listen address and port.

       -c COMMAND
	   Execute command COMMAND and exit.

COMMANDS

	   Note
	   The "x:yz" notation refers to the return type and argument type(s). They are: "n" (nil), "i" (integer), and "s" (string).

       debug (n:n:)
	   Toggle debug output.

       eval (s:s)
	   Evaluate Perl code.

       exit (n:n)
	   Exit the shell.

       help (n:n)
	   Print help for server (fldigi) methods and shell commands.

       history (s:n)
	   Print command history.

       modems (s:n)
	   List all modem names.

       poll (s:i)
	   Poll for new received text every i seconds. Defaults to 1.

       pskrqsy (n:si)
	   QSY to ith best frequency for grid s. The list of frequencies is retrieved from the PSK Reporter website; see RESOURCES. The grid
	   square string may be left empty, and the index argument defaults to 0 (first frequency).

       recvtext (s:n)
	   Get all received text.

       reinit (n:n)
	   Fetch commands from the server and rebuild command list.

       send (n:s)
	   Send text interactively, one line at a time.

       sendchar (n:s)
	   Send text interactively, one character at a time.

       sendfile (n:s)
	   Send text read from file s.

       sendstr (n:s)
	   Send string s.

       source (n:s)
	   Read commands from file s.

       time (s:s)
	   Time a command.

       wait (n:s)
	   Wait for server TRX state to become s.

EXTENDED DESCRIPTION

       The shell has three modes of operation:

	1. Interactive mode with history, tab completion and command line editing. This is the default mode when fldigi-shell is run without
	   arguments.

	2. Batch mode for a single command with the -c option.

	3. Batch mode to "source" a file containing Perl code. Fldigi-shell commands can be called using "execute("COMMAND [ARG ...]")" calls.

FILES

       $HOME/.fldigi/shell-history
	   Contains the fldigi-shell command history.

EXAMPLES

       while :; do fldigi-shell -c pskrqsy; sleep 900; done
	   Change to the "best frequency" (see PSK Reporter) every fifteen minutes.

SEE ALSO

       fldigi(1), xmlrpc(1), readline(3), RPC::XML(3pm)

BUGS

       o   Some additional command wrappers are needed.

       o   Command completion should be enabled for the arguments of some commands.

       o   The XML-RPC handling code should probably go in a separate module.

       o   It should be possible to pass multiple -c CMD arguments.

RESOURCES

       Fldigi web site: http://www.w1hkj.com/Fldigi.html

       The PSK Automatic Propagation Reporter site can be found at http://www.pskreporter.info/

       The GNU Readline Library: http://directory.fsf.org/project/readline/

       XML-RPC home page: http://www.xmlrpc.com/

AUTHOR

       Fldigi-shell and this manual page were written by Stelios Bounanos, M0GLD <sb[at]enotty(dot)net>.

COPYING

       License GPLv2+: GNU GPL version 2 or later.

								    07/01/2012							   FLDIGI-SHELL(1)