1. Mads Kiilerich
  2. tcpcam


=== TCPCam ===

TCPCam is video/audio chat program for Linux.

It is a bit different in the implementation if comprated to
most other software around. The following is a list of main
features of TCPCam:

 - All the protocol works using a single TCP port (port 7766)
 - In order for TCPCam to work between two users, one of the users
   can be completly firewalled, while the other one must have
   port TCP 7766 open to the outside.
 - Audio frames are encoded using the Speex encoder/algorithm
 - Video frames are encoded using JPG at high compression level
 - The user can switch video quality at runtime using keys from 1 to 0
 - The protocol is very simple to implement in most operating
   systems and programming languages.


To compile SDL and libjpeg libraries must be installed.
The program also uses the speex audio compression library
but it is shipped with TCPCam itself.

=== USAGE ===

For a list of all options try ./tcpcam --help, but following
is the basic usage:

One computer works as server, one as client.
The computer working as server is the one with the TCP port 7766
open. In the server side just run the program using the
following command line:


If you don't have a webcam use "./tcpcam -n", if you don't
have a sound board use "./tcpcam -a", and -an if you lacks
both of course ;)

In the client side write instead:

  ./tcpcam -c

Of course you have to change the address with the
real internet address of the user you want to chat with.

If the server are using a different port you can specify
it using "./tcpcam -c address:port".

Of course the client side can use -n and -a options like the
server side in order to exclude support for audio and/or video.

!!!REMEMBER!!!: Once connected you need to press the SPACEBAR
in order to switch between your webcam and the remote webcam.

=== KEYS ===

spacebar: toggle between your webcam and the remote webcam.
0,1,2, ..., 9: switch compression level
p,o,i,u,y: switch webcam resolution
f: toggle full screen
b: toggle black&white mode
enter: get a screenshot saved as /tmp/tcpcam-<timestamp>.jpg
q: quit