direwolf - Man Page

Soundcard TNC for packet radio.


direwolf [ options ] [ - | udp:9999 ]

The first audio channel can be streamed thru stdin or a UDP port.  This is typically used with an SDR receiver.


direwolf  is a software "soundcard" modem/TNC and APRS encoder/decoder.    It can be used stand-alone to receive APRS messages, as a digipeater,  APRStt gateway, or Internet Gateway (IGate).     It can also be used as a virtual TNC for other applications such as  APRSIS32, UI-View32, Xastir, APRS-TW, YAAC, UISS, Linux AX25, SARTrack,  RMS Express, and many others.


-c file

Read configuration file from specified location rather than the default locations.

-l logdir

Generate daily log files in specified directory.  Use "." for current directory.

-L logfile

Generate single log file with fixed name.

-r n

Audio sample rate per second for first channel.  Default 44100.

-n n

Number of audio channels for first device.  1 or 2.  Default 1.

-b n

Audio sample size for first channel.  8 or 16.  Default 16.

-B n

Data rate in bits/sec for first channel.  Standard values are 300, 1200, 2400, 4800, 9600.

300 bps defaults to AFSK tones of 1600 & 1800.

1200 bps uses AFSK tones of 1200 & 2200.

2400 bps uses QPSK based on V.26 standard.

4800 bps uses 8PSK based on V.27 standard.

9600 bps and up uses K9NG/G3RUH standard.

AIS for ship Automatic Identification System.

EAS for Emergency Alert System (EAS) Specific Area Message Encoding (SAME).


Force G3RUH modem regardless of data rate.


2400 bps QPSK compatible with Dire Wolf <= 1.5.


2400 bps QPSK compatible with MFJ-2400.

-D n

Divide audio sample by n for first channel.

-X n

1 to enable FX.25 transmit.

-d x

Debug options.  Specify one or more of the following in place of x.

a = AGWPE network protocol client.

k = KISS serial port client.

n = Network KISS client.

u = Display non-ASCII text in hexadecimal.

p = Packet dump in hexadecimal.

g = GPS interface.

W = Waypoints for position or object reports.

t = Tracker beacon.

o = Output controls such as PTT and DCD.

i = IGate

h = Hamlib verbose level.  Repeat for more.

m = Monitor heard station list.

f = Packet filtering.

x = FX.25 increase verbose level.

-q x

Quiet (suppress output). Specify one or more of the following in place of x.

h = Heard line with the audio level.

d = Decoding of APRS packets.

-t n

Text colors.  0=disabled. 1=default.  2,3,4,... alternatives.  Use 9 to test compatibility with your terminal.


Enable pseudo terminal for KISS protocol.


Send Xmit level calibration tones.


Print UTF-8 test string and exit.


Print Symbol tables and exit.

-a n

Report audio device statistics each n seconds.

-T fmt

Time stamp format for sent and received frames.

-e ber

Receive Bit Error Rate (BER), e.g. 1e-5


gqrx (2.3 and later) has the ability to send streaming audio through a UDP socket to another application for further processing.  direwolf can listen over a UDP port with options like this:

direwolf -n 1 -r 48000 -b 16 udp:7355

Other SDR applications might produce audio on stdout so it is convenient to pipe into the next application.  In this example, the final "-" means read from stdin.

rtl_fm -f 144.39M -o 4 - | direwolf -n 1 -r 24000 -b 16 -

See Also

More detailed information is in the pdf files in /usr/local/share/doc/direwolf, or possibly /usr/share/doc/direwolf, depending on installation location.

Applications in this package: aclients, atest, cm108, decode_aprs, direwolf, gen_packets, kissutil, ll2utm, log2gpx, text2tt, tt2text, utm2ll