mirror of
https://github.com/andreili/camera-streamer.git
synced 2025-08-23 19:34:07 +02:00
3d2085c4b2
Adding the command required to clone the entire repository with submodules makes it less likely to error out when building.
63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
# camera-streamer
|
|
|
|
> Use `main` branch for semi-stable changes, or `develop` for experimental changes.
|
|
|
|
There's a number of great projects doing an UVC/CSI camera streaming
|
|
on SBC (like Raspberry PI's).
|
|
|
|
This is yet another **camera-streamer** project that is primarly focused
|
|
on supporting a fully hardware accelerated streaming of MJPEG streams
|
|
and H264 video streams for minimal latency.
|
|
|
|
This supports well CSI cameras that provide 10-bit Bayer packed format
|
|
from sensor, by using a dedicated ISP of Raspberry PI's.
|
|
|
|
Take into account that this is a draft project, and is nowhere as complete
|
|
and well supported as [awesome ustreamer](https://github.com/pikvm/ustreamer).
|
|
This project was inspired by mentioned ustreamer.
|
|
|
|
To clone this repository be sure to use the following command:
|
|
|
|
git clone --recurse-submodules https://github.com/ayufan/camera-streamer.git
|
|
|
|
## Requirements
|
|
|
|
1. Debian Bullseye, with at least 5.15 kernel
|
|
1. Best: Raspberry PI for hardware acceleration
|
|
|
|
## Install
|
|
|
|
1. [Use precompiled debian package](https://github.com/ayufan/camera-streamer/releases/latest) (recommended)
|
|
2. [Compile manually](docs/install-manual.md) (advanced)
|
|
|
|
## Configure
|
|
|
|
1. [Configure resolution, brightness or image quality](docs/configure.md)
|
|
1. [See different streaming options](docs/streaming.md)
|
|
1. [See example configurations](service/)
|
|
|
|
## Advanced
|
|
|
|
This section contains some advanced explanations that are not complete and might be outdated:
|
|
|
|
1. [High-performance mode via ISP for CSI](docs/v4l2-isp-mode.md)
|
|
1. [High-performance mode via direct decoding for USB](docs/v4l2-usb-mode.md)
|
|
1. [High-compatibility via `libcamera` on Raspberry PI](docs/raspi-libcamera.md)
|
|
1. [Performance analysis](docs/performance-analysis.md)
|
|
|
|
## License
|
|
|
|
GNU General Public License v3.0
|
|
|
|
## References
|
|
|
|
This project uses:
|
|
|
|
- [WebRTC library libdatachannel](https://github.com/paullouisageneau/libdatachannel)
|
|
- [Raspberry PI libcamera](https://github.com/raspberrypi/libcamera)
|
|
- [RTSP live555](http://www.live555.com)
|
|
- [FFmpeg](https://ffmpeg.org/)
|
|
- [C++ helper magic_enum](https://github.com/Neargye/magic_enum)
|
|
- [C++ JSON nlohmann](https://github.com/nlohmann/json)
|
|
- [HTML from ESP32 Cam WebServer](https://github.com/easytarget/esp32-cam-webserver)
|