https://github.com/jonas-koeritz/actioncam
Go Library and command line tool for working with cheap action cameras.
https://github.com/jonas-koeritz/actioncam
actioncam golang rtp rtsp rtsp-server video-streaming
Last synced: 5 months ago
JSON representation
Go Library and command line tool for working with cheap action cameras.
- Host: GitHub
- URL: https://github.com/jonas-koeritz/actioncam
- Owner: jonas-koeritz
- License: apache-2.0
- Created: 2019-08-26T16:13:37.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-04-27T08:47:09.000Z (about 5 years ago)
- Last Synced: 2024-06-19T00:33:16.508Z (about 2 years ago)
- Topics: actioncam, golang, rtp, rtsp, rtsp-server, video-streaming
- Language: Go
- Homepage:
- Size: 81.1 KB
- Stars: 39
- Watchers: 8
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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
# Start RTSP server and stream preview to connecting
actioncam rtsp
# 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
```
### Recording Video
To record full resolution video to SD-Card use the subcommands `record` and `stop`.
```
# Start recording Video
actioncam record
# Stop recording Video
actioncam stop
```
### 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
# Download latest file
actioncam fetch
```
### 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
# 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).