sophie/actioncam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Added README.md

Browse source
This commit is contained in:
Jonas Köritz 2019-08-26 18:12:51 +02:00
parent 72d025f4bd
commit 8194785ba6
1 changed files with 70 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

70
README.md Normal file
View file

@ -0,0 +1,70 @@
# 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) | r0.5 | 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.
```
ipcamera <Camera IP>
```
### Shooting a still picture
To shoot a still picture and save it to SD-Card run the subcommand `still`.
```
ipcamera still <Camera IP>
```
### Recording Video
To record full resolution video to SD-Card use the subcommands `record` and `stop`.
```
# Start recording Video
ipcamera record <Camera IP>
# Stop recording Video
ipcamera 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
ipcamera ls <Camera IP>
# Download latest file
ipcamera 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.
```
ipcamera cmd <RAW Command and Payload in HEX> <Camera IP>
# Example (Take a still image)
ipcamera cmd 00A038 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.