openmcu - simple Multi Conference Unit using H.323

openmcu [options]...

openmcu is a simple Multi Conference Unit using the H.323 protocol. It sets up a H.323 listener process, and then waits for incoming connections. Whenever an incoming connection is established, it adds that call to the specified conference or to the default one if none is specified. You specify one on your H.323 client when you call the OpenMCU server with address "room_name@server_name", where room_name is the conference you want to join. If video is enabled and there are more than 4 people in a chat room it shows the images of the last 4 people that have talked in that room.

All of the command line options to openmcu can be specified in long form, and the most commonly used options also have single character equivalents. The long forms can also be used in the openmcu configuration file.

--defaultroom name

Selects the default room name that will be used for connections that don't specify one, default is room101.

--disable-menu

Disable the command line menu.

-g, --gatekeeper host

Upon startup, register only with the specified gatekeeper rather than attempting to find a gatekeeper by using UDP broadcast.

--g711frames count

Set the number of G.711 frames in capabilities to count. Defaults to 30.

--gsmframes count

Set the number of GSM frames in capabilities to count. Defaults to 4.

-h, --help

Display the help message.

-i, --interface IP

Only bind to the specified network interface address. By default, openmcu automatically listens for incoming calls on all TCP/IP network interfaces available on the host machine. This option is useful for running multiple copies of openmcu on the same multi-homed machine, or for ensuring that only calls from the external, or internal, network will be received on a particular mcu server.

--no-defaultroom

Reject connections with no room specified.

-n, --no-gatekeeper

Do not attempt to find a gatekeeper upon startup using UDP broadcast.

-o, --output filename

Write trace output (enabled with the -t option) to the specified file rather than to stderr.

--require-gatekeeper

Exit if a gatekeeper cannot be found.

--save

Save arguments in configuration file.

-t, --trace

Enable debug tracing, which displays messages at run-time to assist in debugging or problem identification. Specifying this option multiple times increases the amount of information displayed. Use the -o option to write the trace information to a file rather than to stderr.

-u, --username str

Set the local endpoint name to str.

-v, --video

Enable H261 video handling.

--videolarge

Set the video size from normal (176x144) to large (352x288).

--videotxquality n

Set sent video quality to n, default is 9. n has to be between 1 (good) and 31.

--videofill n

Set the number of updated background blocks per frame to n, default is 2. n has to be between 1 and 99.

--videotxfps n

Set maximum number of transmited video frames per second to n, default is 10. n has to be between 1 and 30.

--single-stream

Disable video and audio multiplexing. Only First connection is allowed to send data.

openmcu options can be set in the openmcu configuration file ~/.pwlib_config/openmcu.ini either by edditing this file or via the --save option. Options must be located in the section prefixed with [Options]. The long form of any command line option specified above can be specified in the configuration file, in the format:

option = value

Unless the --disable-menu option has been specified openmcu allows the user to perform various operations whilst running. These operations are accessed via single line commands which each start with a single character identifying the function. The available commands are:

?

Print the menu help.

v

Report which connections are at each video corner.

m

Make a call, which will be added to the default room.

x

Exit.

s

Report statistics.

z

Put message in log file (for debugging).

openmcu -n

Start the program without registering with a gatekeeper.

~/.pwlib_config/openmcu.ini

None that I know of.

README.txt file in the doc directory.