fldigi-shell(1) [debian man page]

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)

FLARQ(1)																  FLARQ(1)

NAME

       flarq - ARQ data transfer utility for fldigi

SYNOPSIS

       flarq [OPTIONS]

DESCRIPTION

       Flarq (fast light automatic repeat request) is a file transfer application that is based on the ARQ specification developed by Paul
       Schmidt, K9PS. It is capable of transmitting and receiving frames of ARQ data via fldigi, as well as MultiPSK on Windows.

OPTIONS

       Long options begin with two hyphens and are handled by flarq. 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.

       --arq-protocol TYPE
	   Set the ARQ protocol. May be either "fldigi" or "multipsk". Defaults to "fldigi".

       --arq-server-address HOSTNAME
	   Set the ARQ TCP server address. Defaults to "127.0.0.1".  HOSTNAME may be any node name string accepted by getaddrinfo(3).

       --arq-server-port PORT
	   Set the ARQ TCP server port. Defaults to "7322".  PORT may be any service name string accepted by getaddrinfo(3).

       --debug
	   Enable debugging messages.

       --version
	   Print version information and exit.

       --build-info
	   Print build information and exit.

       --help
	   Print options summary and exit.

   Standard FLTK options
       -bg, -background COLOUR
	   Set the background colour.

       -bg2, -background2 COLOUR
	   Set the secondary (text) background colour.

       -di, -display DISPLAY
	   Specifies the X server to connect to; see X(7).

       -dn, -dnd or -nodn, -nodnd
	   Enable or disable drag and drop copy and paste in text fields.

       -fg, -foreground COLOUR
	   Set the foreground colour.

       -g, -geometry GEOMETRY
	   Set the initial window size and position.  Flarq may not honour this option.

       -i, -iconic
	   Start flarq in iconified state.  Flarq may not honour this option.

       -k, -kbd or -nok, -nokbd
	   Enable or disable visible keyboard focus in non-text widgets.

       -na, -name CLASSNAME
	   Set the window class. Defaults to "Flarq".

       -ti, -title WINDOWTITLE
	   Set the window title. Defaults to "flarq - <callsign>".

   Additional UI options
       --font FONT[:SIZE]
	   Set the widget font and (optionally) size. Defaults to "sans:12".

FILES

       $HOME/.flarq
	   The main settings file.

       The following directories are used to interface with MUAs such as Sylpheed:

       $HOME/Mail/ARQin
	   Stores incoming email messages.

       $HOME/Mail/ARQout
	   Stores outgoing email messages.

       $HOME/Mail/ARQsent
	   Stores sent email messages.

       The following directories are used for ARQ file transfer:

       $HOME/ARQrecv
	   Stores received files.

       $HOME/ARQsend
	   Stores files to be transmitted.

       $HOME/ARQfiles/logfile.txt
	   Stores transfer logs.

BUGS

       o   There are no command line arguments to override the default configuration file and ARQ and Mail directories.

SEE ALSO

       fldigi(1), getaddrinfo(3), getopt(3), X(7)

RESOURCES

       Flarq web site: http://www.w1hkj.com/flarq_main.html

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

       BerliOS project page: http://developer.berlios.de/projects/fldigi/

       ARQ specification by Paul Schmidt, K9PS: http://www.w1hkj.com/FlarqHelpFiles/ARQ2.pdf

AUTHORS

       Flarq was written by David Freese, W1HKJ.

       This manual page was written by Stelios Bounanos <sb[at]enotty(dot)net>.

COPYING

       License GPLv3+: GNU GPL version 3 or later.

								    07/01/2012								  FLARQ(1)