libipcamera

README

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. Additionally it is possible to start a crude RTSP-Server that is able to serve a single client.

# Start preview streaming via RTP
actioncam <Camera IP>

# Start RTSP server and stream preview to connecting
actioncam rtsp <Camera IP>

# Use mplayer to stream a low-latency preview (ffmpeg and VLC introduce significant delay)
mplayer -nocache rtsp://127.0.0.1:8554

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 any given 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. (if this feature is really needed this could be implemented but the utility should be simple and without many side-effects).