actioncam / libipcamera

Go Library and command line tool for working with cheap action cameras.

Compatible Cameras

Vendor	Model	Firmware Version	Compatibility	Remarks
Campark	ACT76 (Xtreme 2)	v1.0 rc5	Full (tested)
TecTecTec	XPro2	-	Full (untested)

Usage Examples

Preview Streaming

Supplying no additional command will start streaming a preview video stream to your local system. To view the video use the camera.sdp file and open it in a compatible player like VLC. The stream is a RTP stream sent to Port 5220 on localhost containing H.264 data in preview resolution as AVP Type 99.

actioncam <Camera IP>

Shooting a still picture

To shoot a still picture and save it to SD-Card run the subcommand still.

actioncam still <Camera IP>

Recording Video

To record full resolution video to SD-Card use the subcommands record and stop.

# Start recording Video
actioncam record <Camera IP>

# Stop recording Video
actioncam stop <Camera IP>

Fetch the list of files on the SD-Card and download the latest file

The camera can provide a list of files stored on the SD-Card, the ipcamera tool currently allows the download of the latest file in the list.

# List files
actioncam ls <Camera IP>

# Download latest file
actioncam fetch <Camera IP>

Send a RAW packet to the Camera

It's possible to send RAW commands to the camera to test new commands and help reverse engineer the protocol.

actioncam cmd <RAW Command and Payload in HEX> <Camera IP>

# Example (Take a still image)
actioncam cmd A038 192.168.1.1

Limitations

On all tested cameras, there can only be one client connected to the camera at a time. This means that to take a picture you have to stop a client that is currently running a preview stream. To help with that issue the command line client will open a socket in the future that can accept commands to control the camera while previewing the video.

2.1 KiB Raw Blame History