Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Videoplayer for ESP32

This is a proof of concept videoplayer which plays raw RGB565 and MJPG video files from the SD card. You can convert any video file to to both formats with ffmpeg. Currently videos are played without sound.

Big Buck Bunny on TTGO T4

You can also see how it works in Vimeo.

Configure and compile

$ git clone --recursive
$ cd esp_video
$ cp sdkconfig.ttgo-t4-v13 sdkconfig
$ make -j8 flash

If you have some other board or display run menuconfig yourself.

$ git clone --recursive
$ cd esp_video
$ make menuconfig
$ make -j8 flash

Download and convert video

I used Big Buck Bunny in the examples. Converted video should be copied to a FAT formatted SD card. Note that by default ESP-IDF does not support long filenames. Either enable them from menuconfig or use short 8.3 filenames.

$ wget -O bbb.mp4
$ ffmpeg -i BigBuckBunny_320x180.mp4 -f rawvideo -pix_fmt rgb565be -vcodec rawvideo bbb24.raw

The original video is 24 fps. With SPI interface the SD card reading speed seems to be the bottleneck. You can create 12 fps raw video version with the following.

$ ffmpeg -i BigBuckBunny_320x180.mp4 -f rawvideo -pix_fmt rgb565be -vcodec  rawvideo -r 12 bbb12.raw

With motion jpeg video ESP32 itself is the bottleneck. With my testing I was able to decode at approximately 8 fps. You can create a 8 fps MJPG video with the following.

$ ffmpeg -i BigBuckBunny_320x180.mp4 -r 8 -an -f mjpeg -q:v 1 -pix_fmt yuvj420p -vcodec mjpeg -force_duplicated_matrix 1 -huffman 0 bbb08.mjp

There is a reasonable size difference between raw and motion jpeg files.

$ du -h bbb12.raw
798M	bbb12.raw

$ du -h bbb12.mjp
117M	bbb12.mjp

$ du -h bbb08.mjp
 80M	bbb08.mjp

Code expects to find files bbb12.raw and bbb08.mjp in the sdcard. You can change which file is played via menuconfig Component config -> Video demo configuration.

Big Buck Bunny

Copyright (C) 2008 Blender Foundation |
Some Rights Reserved. Creative Commons Attribution 3.0 license.


Proof of concept video player for ESP32 boards








No releases published

Sponsor this project



No packages published