iphone-1.0
Kai Voelcker
-rw-r--r-- 1 kai users 26126 Nov 30 15:54 iphone-1.0.tgz
-rw-r--r-- 1 kai users 3087 Nov 30 15:54 iphone-1.0.txt
# ======== iphone-1.0/README ========
IPHONE: VOICE CALLS ACROSS THE INTERNET
#######################################
This is iphone -- the Internet voice call utility.
With iphone you can set up a voice connection between two workstations and chat
by using a microphone and a pair of headphones connected to your workstation.
In order to be able to accept incoming iphone calls, you must run the
``iserver'' utility on your workstation:
iserver
Your friends will connect to you by invoking
iphone iphone://j...@venus.somewhere.edu
assuming that your iserver is running on workstation venus.somewhere.edu, and
that your name is Joe. iphone uses TCP/IP to transmit the audio data.
iphone performs run-time compression of the audio data, silence detection, and
automatically adjusts the audio quality to the available bandwidth.
This software was tested on SPARCstations running SUNOS 4.1.3. You will
need gcc or another ANSI C compiler. Although the code contains a few SUNOS
specific audio-ioctls, it should be quite easy to port it to other UNIX flavors.
(iphone also compiles under SOLARIS, both with gcc and acc)
INSTALLATION
============
- Check the definitions in Makefile. It is configured for SUNOS and gcc.
- Type ``make''. This should build the iphone and iserver executables.
- Copy the executables to /usr/local/bin or whatever.
USING IPHONE
============
iserver [-p port] [-a audiofile] [-v volume] [-V]
-p to set a TCP port other than the configured default
-a to specify an audio device other than /dev/audio
-v to set the volume to a value between 0 and 100. (Default: 32)
-V for verbose
normally, you will just call ``iserver'' with no arguments.
iphone url [-a audiodev] [-v volume] [-V] [-s pktsize]
url is something like ``iphone://j...@venus.somewhere.edu''
The format is ``iphone://user@iserverhost[:portnumber]''
-a to specify an audio device other than /dev/audio
-v to set the volume to a value between 0 and 100. (Default: 32)
-V for verbose
-p to set the size of the audio packets. (Default: 512 bytes)
e.g., iphone iphone://j...@venus.somewhere.edu
Verbose mode:
a number in square brackets informs you of the present quality level
([0] means best quality).
``r'' means that audio data is being received
``s'' that audio data is being sent
You can run both iphone and iserver on the same machine. The audio is
directed to the jack, i.e., to your headphones, in order to avoid back coupling!
.PHONERC FILE
=============
You can have following kinds of entries in your ~/.iphonerc file.
(.iphonerc is read only by iphone, not by iserver.)
myurl iphone://ja...@sirius.blubb.com
alias ann iphone://a...@gungnir.cs.cornell.edu
``myurl'' defines the iphone url which will be displayed by the destination's
iserver utility when you set up a connection to it.
``alias'' serves to define a nickname. I.e., you can type
iphone ann
instead of
iphone iphone://a...@gungnir.cs.cornell.edu
BUG REPORTS, COMMENTS
=====================
Are very welcome and shall be directed to Silvano Maffeis, maf...@acm.org
--
* Kai Völcker * Kappelner 18 * D-24106 Kiel * Fax +49 431 330545 *