
                                  ivcall 0.4

   Copyright 2002-2005 Lennart Poettering <mzvipnyy (at) 0pointer (dot)
   de>
     * [1]License
     * [2]News
     * [3]Overview
     * [4]Status
     * [5]Documentation
     * [6]Requirements
     * [7]Installation
     * [8]Acknowledgements
     * [9]Download

License

   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.

News

   Sun Jan 23 2005:

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

   Sat Jan 2004:

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

   Sun July 27 2003:

   [12]Version 0.2 released, changes include: many fixes, autoconf
   support

Overview

   ivcall is a small utility which may be used to make automated
   telephone calls with your [13]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 [14]spandsp as software modem for 9600bps connections (just fax,
   no data connections).

Status

   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.

Documentation

  Voice

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

   You may use ivcall as a Unix filter:
ivcall LMSN RMSN < IFILE > OFILE

   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

  Fax

   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.

Requirements

   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 [16]spandsp
   0.0.2pre10 or newer.

Installation

   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.

Acknowledgements

   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

Download

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

   The current release is [18]0.4

   Get ivcall's development sources from the [19]Subversion
   [20]repository ([21]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 [22]Freshmeat.
     _________________________________________________________________


    Lennart Poettering <mzvipnyy (at) 0pointer (dot) de>, January 2005

   $Id: README.html.in 22 2005-01-23 02:43:43Z lennart $

References

   1. README#license
   2. README#news
   3. README#overview
   4. README#status
   5. README#documentation
   6. README#requirements
   7. README#installation
   8. README#acks
   9. README#download
  10. http://0pointer.de/lennart/projects/ivcall/ivcall-0.4.tar.gz
  11. http://0pointer.de/lennart/projects/ivcall/ivcall-0.3.tar.gz
  12. http://0pointer.de/lennart/projects/ivcall/ivcall-0.2.tar.gz
  13. http://www.isdn4linux.de/
  14. http://opencall.org/
  15. http://0pointer.de/lennart/projects/ivcall/ivcall.1.xml
  16. http://opencall.org/
  17. http://0pointer.de/lennart/projects/ivcall/
  18. http://0pointer.de/lennart/projects/ivcall/ivcall-0.4.tar.gz
  19. http://subversion.tigris.org/
  20. svn://seth.intheinter.net/ivcall
  21. http://0pointer.de/cgi-bin/viewcvs.cgi/?root=ivcall
  22. http://freshmeat.net/projects/ivcall/
