# Video Playing 2.1" Round Ornament TFT
## Overview
https://youtu.be/ytfkebsxjmE
Build an Ornament that plays Holiday video clips using an Adafruit Qualia ESP32-S3 and a 2.1" round TFT display.
Load a series of your favorite video files on a micro SD card and display them on the round TFT LCD screen. Cycle through them by touching the screen.
3D print the parts to secure the display, Qualia ESP32-S2, and micro SD breakout.
The case uses ornament hooks so you can decorate your tree for the season!
## Parts
Featured
### Round RGB 666 TTL TFT Display - 2.1" 480x480 - Capacitive Touch
[Round RGB 666 TTL TFT Display - 2.1" 480x480 - Capacitive Touch](https://www.adafruit.com/product/5792)
This is a screen for advanced hackers who like the look of a nice, round TFT screen with tons of pixels. The 2.1" diagonal sized display has 480x480 16-bit full-color pixels and is an **IPS** display, so the color looks great up to 80 degrees off-axis in any...
In Stock
[Buy Now](https://www.adafruit.com/product/5792)
[Related Guides to the Product](https://learn.adafruit.com/products/5792/guides)
Featured
### Adafruit Qualia ESP32-S3 for TTL RGB-666 Displays
[Adafruit Qualia ESP32-S3 for TTL RGB-666 Displays](https://www.adafruit.com/product/5800)
There's a few things everyone loves: ice cream, kittens, and honkin' large TFT screens. We're no strangers to small TFT's - [from our itsy 1.14" color display](https://www.adafruit.com/search?q=1.14+tft) that graces many-a-TFT-Feather to
In Stock
[Buy Now](https://www.adafruit.com/product/5800)
[Related Guides to the Product](https://learn.adafruit.com/products/5800/guides)
Featured
### Adafruit Micro SD SPI or SDIO Card Breakout Board - 3V ONLY!
[Adafruit Micro SD SPI or SDIO Card Breakout Board - 3V ONLY!](https://www.adafruit.com/product/4682)
Micro SD cards and microcontrollers go together like micro-peanutbutter-and-jelly: SD cards are inexpensive, durable, easy to find at any shop, come in many sizes and can plug into any computer using a common SD card reader. That makes them perfect for microcontroller storage and retrieval -...
In Stock
[Buy Now](https://www.adafruit.com/product/4682)
[Related Guides to the Product](https://learn.adafruit.com/products/4682/guides)
Featured
### 1.25mm Pitch 8-pin Cable Matching Pair - 10 cm long
[1.25mm Pitch 8-pin Cable Matching Pair - 10 cm long](https://www.adafruit.com/product/4976)
These solid 1.25mm pitch connector cable pairs are great when you need something that can carry a couple of amps of current and are easy to connect and disconnect.
These cables are nice and long, 10cm each, in fact. They've got both small form-factor and are a matching set, with an...
In Stock
[Buy Now](https://www.adafruit.com/product/4976)
[Related Guides to the Product](https://learn.adafruit.com/products/4976/guides)
Featured
### SD/MicroSD Memory Card (8 GB SDHC)
[SD/MicroSD Memory Card (8 GB SDHC)](https://www.adafruit.com/product/1294)
Add mega-storage in a jiffy using this 8 GB class 4 micro-SD card. It comes with a SD adapter so you can use it with any of our shields or adapters. Preformatted to FAT so it works out of the box with our projects. Tested and works great with our
Out of Stock
[Buy Now](https://www.adafruit.com/product/1294)
[Related Guides to the Product](https://learn.adafruit.com/products/1294/guides)
Featured
### Pink and Purple Woven USB A to USB C Cable - 1 meter long
[Pink and Purple Woven USB A to USB C Cable - 1 meter long](https://www.adafruit.com/product/5153)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers, and more. [If you want something just like it but for Micro B, we...](https://www.adafruit.com/product/4111)
Out of Stock
[Buy Now](https://www.adafruit.com/product/5153)
[Related Guides to the Product](https://learn.adafruit.com/products/5153/guides)
### Part: M2.5x5mm Screws
quantity: 6
M2.5x5mm Screws
## Prerequisite Guides
Take a moment to review the following guides to learn more about the products.
- [Adafruit Qualia ESP32-S3 Guide](https://learn.adafruit.com/adafruit-qualia-esp32-s3-for-rgb666-displays)
# Video Playing 2.1" Round Ornament TFT
## Circuit Diagram
The diagram below provides a general visual reference for wiring of the components once you get to the **Assembly** page. This diagram was created using the software package [Fritzing](http://fritzing.org/download/).
## Adafruit Library for Fritzing
Adafruit uses the Adafruit's Fritzing parts library to create circuit diagrams for projects. You can download the library or just grab individual parts. Get the library and parts from [GitHub - Adafruit Fritzing Parts](https://github.com/adafruit/Fritzing-Library/tree/master/parts).
## Wired Connections
The Qualia ESP32-S3 is powered by a 5V 1A USB power supply.
- **SCK** from Qualia S3 to **CLK** on Micro SD
- **MISO** from Qualia S3 to **SO** on Micro SD
- **MOSI** from Qualia S3 to **SI** on Micro SD
- **CS** from Qualia S3 to **CS** on Micro SD
- **A1** from Qualia S3 to **DAT2** on Micro SD
- **A0** from Qualia S3 to **D1** on Micro SD
- **3.3V** from Qualia S3 to **3V** on Micro SD
- **GND** from Qualia to **GND** on Micro SD
# Video Playing 2.1" Round Ornament TFT
## Converting Videos
## Video File Preparation
You'll want to use a video file in a common format such as H.264 (.MP4 or .MOV) with a duration of anywhere from 10 seconds to 3 minutes in length. Your video clip should ideally have a 1:1 aspect ratio of 480x480.
The 2.1" display has a screen resolution of 480x480.
## Online Converter
You can use the website linked below to convert your video file into MJPEG. (maximum file size is 100MB.)
[Convert IO Website](https://convertio.co/)
Click on the **Choose Files** icon. Navigate to your video file and click **Open**. Click on the dropdown icon and select **MJPEG** under the video section. Then, click on the **gear** icon to open the settings dialog.
Use the following settings for best playback performance.
- Codec: MJPEG
- Quality: Highest
- Resize: Custom / 480 x 480
- Resize Method: Zoom and crop
- Frame rate : 10 FPS
- Rotate: Rotate by 90 degrees clockwise (this is to compensate for the screen orientation when mounted)
Click on the Convert button when finished.
## Format SD
Format a micro SD card to FAT32.
## Create VIDEOS folder
Make a new folder in the SD card and name it **VIDEOS**.
## Conversion Completed
Click the **Download** button when the upload and conversion is complete.
Use the [VLC media player app](https://www.videolan.org/)to playback the video for reviewing.
Rename the video file so it uses the **.MJPEG** extension. Then, drag and drop it into the **VIDEOS** folder on the micro SD card.
Danger:
# Video Playing 2.1" Round Ornament TFT
## 3D Printing
## 3D Printed Parts
STL files for 3D printing are oriented to print "as-is" on FDM style machines. Parts are designed to 3D print without any support material using PLA filament. Original design source may be downloaded using the links below.
[Edit Design](https://a360.co/4aqNHVW)
[Download STLs](https://www.thingiverse.com/thing:6386630)
[2.1_Round_Ornament_STEP.zip](https://cdn-learn.adafruit.com/assets/assets/000/126/759/original/2.1_Round_Ornament_STEP.zip?1702999826)
## Slice with Settings for PLA material
The parts were sliced using CURA using the slice settings below.
- PLA filament 200c extruder
- 0.2 layer height
- 10% gyroid infill
- 60mm/s print speed
- 60c heated bed
## Design Source Files
The project assembly was designed in Fusion 360. This can be downloaded in different formats like STEP, STL and more. Electronic components like Adafruit's boards, displays, connectors and more can be downloaded from the [Adafruit CAD parts GitHub Repo](https://github.com/adafruit/Adafruit_CAD_Parts/).
# Video Playing 2.1" Round Ornament TFT
## Software Setup and Use
## Prep SD Card
Create a folder called **VIDEOS** on your SD card. Save your converted video files in this folder. Eject the SD card from your computer and insert it into the microSD card breakout.
## Upload UF2 File
The round ornament code is available as a pre-compiled .UF2 file for the 2.1" 480x480 display that you can drag and drop onto your Qualia S3 board.
[Qualia S3 Ornament UF2 File](https://github.com/adafruit/Adafruit_Learning_System_Guides/raw/main/Qualia/Qualia_S3_OrnamentVideoPlayer/Qualia_S3_OrnamentVideoPlayer_480x480_2.1round.uf2)
**Click the link above to download the UF2 file.**
Save it wherever is convenient for you.
Plug your board into your computer, using a known-good data-sync USB cable, directly, or via an adapter if needed.
Double-click the **reset** button (highlighted in red above), wait about a half a second and then tap reset again.
You will see a new disk drive appear called **TFT\_S3BOOT**.
Drag the **Qualia\_S3\_OrnamentVideoPlayer\_480x480\_2.1round.UF2** file to **TFT\_S3BOOT**.
The code will begin running by playing the first video file on the SD card. Touch the center of the screen to advance to the next video file.
## Advanced Users: Source Code in Arduino IDE
Warning:
[Qualia S3 Round Ornament Arduino Code](https://github.com/adafruit/Adafruit_Learning_System_Guides/tree/main/Qualia/Qualia_S3_OrnamentVideoPlayer)
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/Qualia/Qualia_S3_OrnamentVideoPlayer/Qualia_S3_OrnamentVideoPlayer.ino
The source code for the round ornament is [available on GitHub](https://github.com/adafruit/Adafruit_Learning_System_Guides/tree/main/Qualia/Qualia_S3_OrnamentVideoPlayer). It consists of an Arduino script .ino file and a header file. You will need both files to compile it in the Arduino IDE. There are a few items you'll need to manually configure in the Arduino IDE:
- The header file requires the ESP32\_JPEG library, which isn't currently available in the Arduino IDE library bundle. You'll need to install it manually from its [GitHub repository](https://github.com/esp-arduino-libs/ESP32_JPEG).
- Currently the Arduino GFX library is not compatible with the ESP BSP 3.0 since it uses IDF 5. You will need to use an older BSP package and manually add the Qualia S3 board to your local installation.
If you defeat these dragons though, you can update the code to run on different RGB-666 displays and customize any other parameters that you want.
# Video Playing 2.1" Round Ornament TFT
## Assemble
## Prep SD breakout
Use an 8 pin matching cable pair to easily connect the SD breakout board to the pins on the Qualia board. Follow the wiring diagram [here](https://learn.adafruit.com/2-1-round-ornament-tft/circuit-diagram).
## Mount display
Take note of how the ribbon cable attaches to the Qualia board. Align the display to the cutout and place face down between the walls inside the case.
Slightly bend the case while gently pressing the edges of the display to fit.
## Mounting The Frame
Align cutout on the mounting frame to the ribbon cable
Slide the mounting frame into the case at an angle, between the snaps on the case.
## Mount SD breakout
Align the SD breakout to the slot on the case.
Use M2.5x5mm screws to mount the SD breakout board to the frame.
## Connect SD cable
Connect the SD cables to the Qualia. Coil the cable and place the connector between the three taller standoffs.
Use M2.5x5mm screws to secure the Qualia to the frame.
## Display Ribbon
Carefully lift the connect bracket on the Qualia.
Place the display ribbon cable into the connector on the Qualia board and gently press the bracket back down to secure the ribbon cable into place.
## Attach Lid
Align the snaps on the lid the nubs on the inside of the case to close the enclosure.
Plug in a USB battery pack or wall adapter and hang your video ornament!
## Guide Products
### Round RGB 666 TTL TFT Display - 2.1" 480x480 - Capacitive Touch
[Round RGB 666 TTL TFT Display - 2.1" 480x480 - Capacitive Touch](https://www.adafruit.com/product/5792)
This is a screen for advanced hackers who like the look of a nice, round TFT screen with tons of pixels. The 2.1" diagonal sized display has 480x480 16-bit full-color pixels and is an **IPS** display, so the color looks great up to 80 degrees off-axis in any...
In Stock
[Buy Now](https://www.adafruit.com/product/5792)
[Related Guides to the Product](https://learn.adafruit.com/products/5792/guides)
### Adafruit Qualia ESP32-S3 for TTL RGB-666 Displays
[Adafruit Qualia ESP32-S3 for TTL RGB-666 Displays](https://www.adafruit.com/product/5800)
There's a few things everyone loves: ice cream, kittens, and honkin' large TFT screens. We're no strangers to small TFT's - [from our itsy 1.14" color display](https://www.adafruit.com/search?q=1.14+tft) that graces many-a-TFT-Feather to
In Stock
[Buy Now](https://www.adafruit.com/product/5800)
[Related Guides to the Product](https://learn.adafruit.com/products/5800/guides)
### Adafruit Micro SD SPI or SDIO Card Breakout Board - 3V ONLY!
[Adafruit Micro SD SPI or SDIO Card Breakout Board - 3V ONLY!](https://www.adafruit.com/product/4682)
Micro SD cards and microcontrollers go together like micro-peanutbutter-and-jelly: SD cards are inexpensive, durable, easy to find at any shop, come in many sizes and can plug into any computer using a common SD card reader. That makes them perfect for microcontroller storage and retrieval -...
In Stock
[Buy Now](https://www.adafruit.com/product/4682)
[Related Guides to the Product](https://learn.adafruit.com/products/4682/guides)
### 1.25mm Pitch 8-pin Cable Matching Pair - 10 cm long
[1.25mm Pitch 8-pin Cable Matching Pair - 10 cm long](https://www.adafruit.com/product/4976)
These solid 1.25mm pitch connector cable pairs are great when you need something that can carry a couple of amps of current and are easy to connect and disconnect.
These cables are nice and long, 10cm each, in fact. They've got both small form-factor and are a matching set, with an...
In Stock
[Buy Now](https://www.adafruit.com/product/4976)
[Related Guides to the Product](https://learn.adafruit.com/products/4976/guides)
### SD/MicroSD Memory Card (8 GB SDHC)
[SD/MicroSD Memory Card (8 GB SDHC)](https://www.adafruit.com/product/1294)
Add mega-storage in a jiffy using this 8 GB class 4 micro-SD card. It comes with a SD adapter so you can use it with any of our shields or adapters. Preformatted to FAT so it works out of the box with our projects. Tested and works great with our
Out of Stock
[Buy Now](https://www.adafruit.com/product/1294)
[Related Guides to the Product](https://learn.adafruit.com/products/1294/guides)
### Pink and Purple Woven USB A to USB C Cable - 1 meter long
[Pink and Purple Woven USB A to USB C Cable - 1 meter long](https://www.adafruit.com/product/5153)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers, and more. [If you want something just like it but for Micro B, we...](https://www.adafruit.com/product/4111)
Out of Stock
[Buy Now](https://www.adafruit.com/product/5153)
[Related Guides to the Product](https://learn.adafruit.com/products/5153/guides)
## Related Guides
- [Adafruit MicroSD SPI or SDIO Card Breakout Board](https://learn.adafruit.com/adafruit-microsd-spi-sdio.md)
- [Adafruit Qualia ESP32-S3 for RGB-666 Displays](https://learn.adafruit.com/adafruit-qualia-esp32-s3-for-rgb666-displays.md)
- [Toddler Timer](https://learn.adafruit.com/toddler-timer.md)
- [A Z80 CP/M emulator for the SAMD51](https://learn.adafruit.com/z80-cpm-emulator-for-the-samd51-grand-central.md)
- [Blurry Analog Clock](https://learn.adafruit.com/blurry-analog-clock.md)
- [DIY Turbo Button Controller - HID Remapper](https://learn.adafruit.com/diy-turbo-button-controller-hid-remapper.md)
- [DIY USB Cable Aviation Connector Retro-Fit](https://learn.adafruit.com/aviation-connector-diy-usb-cables.md)
- [Coffee Rater](https://learn.adafruit.com/coffee-rater.md)
- [Using the CircuitPython Extension for Visual Studio Code](https://learn.adafruit.com/using-the-circuitpython-extension-for-visual-studio-code.md)
- [BLE Cat Thermal Printer with MEMENTO](https://learn.adafruit.com/ble-cat-thermal-printer-with-memento.md)
- [Adafruit PiCowbell Camera Breakout](https://learn.adafruit.com/adafruit-picowbell-camera-breakout.md)
- [Boomy The Boombox](https://learn.adafruit.com/boomy-the-boombox.md)
- [Qualia S3 iOS Photo Display with itsaSNAP](https://learn.adafruit.com/qualia-s3-ios-photo-display-with-itsasnap.md)
- [Wireless ESP32-S2 Touch Screen Controller for Pure Data](https://learn.adafruit.com/wireless-esp32-s2-controller-for-pure-data.md)
- [Fruit Jam Nintendo Entertainment System and Retro Jam](https://learn.adafruit.com/fruit-jam-nintendo-entertainment-system.md)
- [Saving CircuitPython Bitmaps and Screenshots](https://learn.adafruit.com/saving-bitmap-screenshots-in-circuitpython.md)
- [PB Gherkin 30% keyboard with KMK, CircuitPython, & KB2040](https://learn.adafruit.com/pb-gherkhin-30-keyboard-with-kmk-circuitpython-kb2040.md)