$Id: README,v 1.5 2008/05/18 03:40:17 forys Exp $

Axmjpeg retrieves JPEG images from an MJPEG over HTTP stream.
The HTTP stream must conform to Revision 2.x of the "Axis Video
API, HTTP Interface Specification" (which is available from
"http://www.axis.com/techsup/cam_servers/dev/cam_http_api.htm").
Axmjpeg also supports Revision 1.x of this specification
provided the optional "Content-Length:" header is enabled.

When used in conjunction with the '-T' flag, Axmjpeg also
retrieves JPEG images from TRENDnet Internet Camera Servers
(and possibly others that prepend a header to each JPEG image).

This tool was written for 'cammgr', the web camera management
software available from "http://freshmeat.net/projects/cammgr".
Specifically, it allows cammgr to support the great range of
Axis(R) network cameras available from "http://www.axis.com".
However, it's easy to come up with other uses for axmjpeg.

Sam Liddicott <sam@liddicott.com> contributed code to support
SQ IP Cam, GP-280 IP Camera, and possibly other cameras that
prepend a 40-byte binary header to the input stream.  While
the format of the header does not appear to be documented
anywhere, Sam figured it out and added the code to axmjpeg.
To use these cameras, specify the '-N' flag.

The manual page describes the full range of functionality;
the basic list is:

   o save JPEG images to the same (optionally renamed) file.
   o save each JPEG image to a unique file.
   o pipe JPEG images to shell commands (for more processing).
   o time-based capturing, where only one image per the
     specified interval will be selected for processing.

Axmjpeg was developed on FreeBSD and tested on a wide range of
Unix systems including Linux, HP-UX, Tru64, SunOS, and AIX.

The latest release of axmjpeg is available from:

   ftp://ftp.flux.utah.edu/pub/axmjpeg
   http://freshmeat.net/projects/axmjpeg

If you have any fixes, enhancements or suggestions, please
send them along!

Thanks,
Jeff Forys <jeffware@marjum.com>
http://www.marjum.com/
