rzeldent / esp32cam-ready

Plug and Play firmware for the esp32cam. Connect with RTSP (for example VLC). Easy installation: Flash, provision and connect!
145 stars 24 forks source link
camera esp32 esp32-arduino esp32-cam ov2640 platformio rtsp streaming-video vlc vlc-player

Update: New version available!

This version has a nice web interface to configure and much leaner. Please take a look at ESP32CAM-RTSP

esp32cam-ready

Platform IO CI

esp32cam-ready combines multiple projects to have an out-the-box solution to use the Chinese (7 Euro!) esp32cam modules. Easy installation: Flash, provision using the build in configuration webserver and connect!

ESP32CAM module

Flashing this software in esp32cam will make the esp32cam a webserver with streaming data from the camera and some more features. Additionally this software hosts a RTSP server, that can be used to connect with standard video applications that use RTSP (for example VLC). RTSP also allows to stream directly to a server using ffmpeg. This makes the module a camera server allowing recording and so the stream can be stored on a disk and replayed later.

Required

Wiring

Only during the upload, the esp32cam module needs to be attached using an USB to serial adapter. ESP FTDI wiring

After programming remove the wire to GPIO0 so the module will start normally.

Or, just put the esp32cam module on the ESP32-CAM-MB board and press the IO0 button together with reset and then release the reset button.

ESP32-CAM-MB

Usage

RTSP stream is available at: rtsp://esp32cam.local:554/mjpeg/1. This link can be opened with for example VLC.

Using the browser, you can

Installing and running PlatformIO

Debian based systems command-line

Install platformIO

 sudo apt-get install python-pip
 sudo pip install platformio
 pio upgrade

Windows / Linux and Mac

Install Visual Studio code and install the PlatformIO plugin. For command line usage Python and PlatformIO-Core is sufficient. More information can be found at: https://docs.platformio.org/en/latest/installation.html

Clone this repository, go into the folder and type:

 pio run

Put a jumper between IO0 and GND, press reset and type:

 pio run -t upload

When done remove the jumper and press reset. To monitor the output, start a terminal using:

 pio device monitor

Credits

esp32cam-ready depends on PlatformIO and Micro-RTSP by Kevin Hester.

Thanks for the community making these tools and libraries available.

Also thanks to EspressIf and the guys that created these modules!