cam2ip/README.md at master

andre/cam2ip

Fork 0

mirror of https://github.com/gen2brain/cam2ip.git synced 2025-12-13 02:48:31 +00:00

Files

Milan Nikolic 3fe0d88418 Update README.md

2025-06-15 08:48:39 +02:00

2.4 KiB

Raw Permalink Blame History

cam2ip

Turn any webcam into an IP camera.

Example (in web browser):

http://localhost:56000/html

http://localhost:56000/mjpeg

You can also use apps like ffplay or vlc:

ffplay -i http://localhost:56000/mjpeg

Requirements

On Linux/RPi native Go V4L implementation is used to capture images.
On Windows Video for Windows (VfW) framework is used over win32 API.

Build tags

opencv - use OpenCV library to access camera (gocv)
libjpeg - build with libjpeg (go-libjpeg) instead of native image/jpeg
jpegli - build with jpegli (jpegli) instead of native image/jpeg

Download

Download the latest binaries from the releases.

Installation

go install github.com/gen2brain/cam2ip/cmd/cam2ip@latest

This command will install cam2ip in GOBIN, you can point GOBIN to e.g. /usr/local/bin or ~/.local/bin.

Run in Docker container

docker run --device=/dev/video0:/dev/video0 -p56000:56000 -it gen2brain/cam2ip # on RPi use gen2brain/cam2ip:arm

Usage

Usage: cam2ip [<flags>]
  --index
    	Camera index [CAM2IP_INDEX] (default "0")
  --delay
    	Delay between frames, in milliseconds [CAM2IP_DELAY] (default "10")
  --width
    	Frame width [CAM2IP_WIDTH] (default "640")
  --height
    	Frame height [CAM2IP_HEIGHT] (default "480")
  --quality
    	Image quality [CAM2IP_QUALITY] (default "75")
  --rotate
    	Rotate image, valid values are 90, 180, 270 [CAM2IP_ROTATE] (default "0")
  --flip
    	Flip image, valid values are horizontal and vertical [CAM2IP_FLIP] (default "")
  --no-webgl
    	Disable WebGL drawing of image (html handler) [CAM2IP_NO_WEBGL] (default "false")
  --timestamp
    	Draws timestamp on image [CAM2IP_TIMESTAMP] (default "false")
  --time-format
    	Time format [CAM2IP_TIME_FORMAT] (default "2006-01-02 15:04:05")
  --bind-addr
    	Bind address [CAM2IP_BIND_ADDR] (default ":56000")
  --htpasswd-file
    	Path to htpasswd file, if empty auth is disabled [CAM2IP_HTPASSWD_FILE] (default "")

Handlers

/html: HTML handler, frames are pushed to canvas over websocket
/jpeg: Static JPEG handler
/mjpeg: Motion JPEG, supported natively in major web browsers

2.4 KiB Raw Permalink Blame History