A small example app for ESP32 + Micro-RTSP
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs add picts of the ESP32-CAM board Feb 8, 2019
src Fix ESP32-CAM support / (aithinker) Feb 11, 2019
.gitignore Initial commit Jan 29, 2019
LICENSE Initial commit Jan 29, 2019
README.md Fix ESP32-CAM support / (aithinker) Feb 11, 2019
platformio.ini use platformio version of lib (now that they updated) Feb 16, 2019



This little project has two goals:

  1. Be a little open source webcam (with so-so quality, but hey $10 and open source)
  2. Serve as an example app for the Micro-RTSP library.

sample VLC view

These camera are very cheap (< $10) and the ESP32 has a fair amount of horsepower left over for other work.


Supported boards

Virtually any OV2460 + ESP32 board should work.

For boards other than this list you might (probably not) need to change esp32cam_config to use the GPIO assignments for your hardware.

I've tested the following boards with the stock config: ex1, ex2, ex3.

ESP32-CAM board special handling needed

This board is great in some ways: it has PSRAM (so can in theory capture might higher res images than SVGA) and it is cheap and tiny. Two downsides:

  • It has no built in USB port, so to program you'll need to use a USB serial adapter. See docs for a photo of the proper pins.
  • The GPIO assignments are different for the camera, so you'll need to define USEBOARD_AITHINKER

TTGO-T board special handling needed

@drmocm contributed a config file for this great board. It might be the current best choice because it has an extra 8MB of RAM which makes it possible to use very high resolutions on the camera.
You will need to #define USEBOARD_TTGO_T in ESP32-devcam.ino to get the proper bindings for this board.

How to buy/install/run

This project uses the simple PlatformIO build system. You can use the IDE, but for brevity in these instructions I describe use of their command line tool.

  1. Purchase one of the inexpensive ESP32-CAM modules from asia (see above).
  2. Install PlatformIO.
  3. Download this git repo and cd into it.
  4. pio run -t upload (This command will fetch dependencies, build the project and install it on the board via USB)

The first time you run your device you'll need to use an Android or iOS app to give it access to your wifi network. See instructions here.

At this point your device should be happily serving up frames. Either via a web-browser at http://yourdeviceipaddr or more interestingly via a standard RTSP video stream. If your device has an LCD screen it will be showing the IP address and boot messages to that screen.

To see the RTSP stream use the client of your choice, for example you can use VLC as follows:

vlc -v rtsp://yourdevipaddr:8554/mjpeg/1

Note: an older version of these instructions/code had you manually place your wifi keys into the source code. That code is now commented out, in favor of AutoWifi.