ivcall 0.4

Copyright 2002-2005 Lennart Poettering <mzvipnyy (at) 0pointer (dot) de>


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Sun Jan 23 2005:

Version 0.4 released, changes include: cleanups, add softfax support using spandsp.

Sat Jan 2004:

Version 0.3 released, changes include: uucp locking fixes, ivcall may listen on wildcard MSNs now.

Sun July 27 2003:

Version 0.2 released, changes include: many fixes, autoconf support


ivcall is a small utility which may be used to make automated telephone calls with your isdn4linux supported ISDN card. Outgoing calls are supported as well as incoming calls. The audio data recieved from the peer is written to STDOUT, audio data read from STDIN is send to the peer. The audio data is in raw 8 bit uLaw 8 KHz format, without any headers.

Since release 0.4 ivcall supports sending and receiving facsimiles using spandsp as software modem for 9600bps connections (just fax, no data connections).


Version 0.4 is stable and feature complete when used to playback and record voice messages. The softfax is not reliable, primarily due to the fact that isdn4linux is broken.



Have a look on the man page ivcall(1). (An XSLT capable browser is required)

You may use ivcall as a Unix filter:


Replace LMSN by the local MSN and RMSN by the MSN the program shall call. IFILE must be a raw uLAW 8 KHz bytesized file, which is be played to the peer. OFILE is the file the recorded audio data will be written to. It has the same format as the input file. If no recording (or playback) is desired you may pipe STDOUT (or STDIN) to /dev/null.

Four detailed usage information try:

ivcall --help

If you want to create a sample playable with ivcall with your soundcard, you'll need sox:

$ rec -t raw -r 8000 -U -b FILE

Don't forget to plug in a microphone and set the record volume with aumix or something similar. However, it is recommended to create audio samples with the telephone itself.

If you have a wave file you want to convert to a sample playable with ivcall use sox as well:

$ sox IFILE -t raw -r 8000 -U -b OFILE


For receiving faxes use:

$ ivcall -a -F foo.tif 47110815

This will wait for an incoming fax call on MSN 47110815 and store the data in foo.tif.

For sending faxes use:

$ ivcall -F bar.tif 47110815 08154711

This will call 08154711 from the local MSN 47110815 and deliver bar.tif to the peer. The image file has to be in TIFF format, monochrome and either uncompressed or with G3 compression applied.


A newer Linux Kernel (I think 2.0 is good enough, alltough I tested it only with 2.4) with a compatible device driver (isdn4linux).

ivcall was developed and tested on Debian GNU/Linux "testing" from July 2003, it should work on most other Linux distributions since it uses GNU autoconf for source code configuration.

For using ivcall has softfax you have to install spandsp 0.0.2pre10 or newer.


As this package is made with the GNU autotools you should run ./configure inside the distribution directory for configuring the source tree. After that you should run make for compilation and make install (as root) for installation of ivcall.


For the developers of awag (Stefan Szomraky), minicom (Miquel van Smoorenburg) and vbox (Michael Herold), since I looked on their source codes for learning how to use the isdn4linux modem emulation

Steve Underwood for writing spandsp


The newest release is always available from http://0pointer.de/lennart/projects/ivcall/

The current release is 0.4

Get ivcall's development sources from the Subversion repository (viewcvs):

svn checkout svn://seth.intheinter.net/ivcall/trunk ivcall

If you want to be notified whenever I release a new version of this software use the subscription feature of Freshmeat.

Lennart Poettering <mzvipnyy (at) 0pointer (dot) de>, January 2005
$Id: README.html.in 22 2005-01-23 02:43:43Z lennart $