# Pepper's Ghost Monster Eye
## Overview
https://www.youtube.com/watch?v=V3sjxf0XkLQ
Build a desktop size [Pepper's Ghost](https://en.wikipedia.org/wiki/Pepper%27s_ghost) effect using the Adafruit Qualia ESP32-S3 and a 2.1in round TFT display! 👻👁️
This project shows the infamous animated [Monster Eye](https://learn.adafruit.com/adafruit-monster-eyes) as a Pepper's Ghost effect inside the Adafruit DIY Snow Globe Kit. The 3D printed enclosure houses all of the electronics and features a clear plastic reflector that you can cut yourself.
Use the built-in UP button on the Qualia ESP32-S3 to cycle through different eyes like snake, demon and the classic hazel style eyes. The DOWN button enables the eye to randomly float up and down, repeatedly creating a ghostly effect.
# Parts
Featured
### DIY Snow Globe Kit
[DIY Snow Globe Kit](https://www.adafruit.com/product/3722)
Not merely a snow globe, but a _show_ globe! This custom container is durable, clear and round, with a large flat screw-on top and a press-fit rubber stopper. The stopper makes a nice seal, and is also _hollow_ which means you can put (you guessed it...) electronics inside! This...
In Stock
[Buy Now](https://www.adafruit.com/product/3722)
[Related Guides to the Product](https://learn.adafruit.com/products/3722/guides)
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
Out of Stock
[Buy Now](https://www.adafruit.com/product/5800)
[Related Guides to the Product](https://learn.adafruit.com/products/5800/guides)
Featured
### USB Type A to Type C Cable - approx 1 meter / 3 ft long
[USB Type A to Type C Cable - approx 1 meter / 3 ft long](https://www.adafruit.com/product/4474)
As technology changes and adapts, so does Adafruit. This **USB Type A to Type C** cable will help you with the transition to USB C, even if you're still totin' around a USB Type A hub, computer or laptop.
USB C is the latest industry-standard connector for...
In Stock
[Buy Now](https://www.adafruit.com/product/4474)
[Related Guides to the Product](https://learn.adafruit.com/products/4474/guides)
Featured
### 5V 1A (1000mA) USB port power supply - UL Listed
[5V 1A (1000mA) USB port power supply - UL Listed](https://www.adafruit.com/product/501)
Need a USB jack for charging or powering a project, but don't want to lug around a computer? This switching supply gives a clean regulated output at up to 1000mA! 110 or 240 input, so it works in any country. The plugs are "US 2-prong" style so you may need a plug adapter, but...
In Stock
[Buy Now](https://www.adafruit.com/product/501)
[Related Guides to the Product](https://learn.adafruit.com/products/501/guides)
### Part: Plexiglass Sheets 0.5mm 12x12
quantity: 1
10 Pcs Thin Plexiglass Sheets
[Plexiglass Sheets 0.5mm 12x12](https://www.amazon.com/dp/B0D2HTGHDD?ref=fed_asin_title)
## Hardware Fasteners
The following hardware fasteners are required for this build.
- 4x M2.5 x 6mm steel machine screws
# Pepper's Ghost Monster Eye
## CAD Files
## CAD Parts
Individual 3MF files for 3D printing are oriented and ready to print on FDM machines using PLA filament. Original design source files may be downloaded using the links below.
[Download 3MF.zip](https://cdn-learn.adafruit.com/assets/assets/000/146/703/original/3MF.zip?1790693668)
[Download CAD Source](https://cdn-learn.adafruit.com/assets/assets/000/146/704/original/CAD.zip?1790693684)
## CAD Assembly
This will all be described in detail on the Assembly page. In short:
- Qualia ESP32-S3 is secured to the bottom plate with machine screws
- Display is secured to a case with a inlay holder
- Reflector is fitted into a holder placed inside the snow globe
- Snow globe is fastened to a holder
- Snow globe is secured to the frame using twist lock feature
- The snow globe holder and bottom plate snap fit into the frame
## Slice with Settings for PLA Material
Most of the parts were sliced using BambuStudio using the slicer 0.2mm standard settings.
- PLA filament 220c extruder
- 0.2mm layer height
- 8% gyroid infill
- 200mm/s print speed
- Support type tree(auto) with 30º threshold angle
## Reflector Template
The reflector can be cut using a printed template or vinyl cutter.
Download the SVG file below. Print the template on paper or 3D printer.
Before printing, ensure the dimensions of the reflector is 105mm x 103mm (4.14in x 4.05in)
To cut, use scissors or hobby knife to cut the 0.5mm thick clear plastic sheet using the template.
If you have a vinyl cutter (like a Cricut machine), upload the SVG and cut using a material profile for 0.5mm thick material.
Yellow: Be careful cutting material with a hobby knife. Older folks should help younger makers.
[Download Reflector Template SVG](https://cdn-learn.adafruit.com/assets/assets/000/146/708/original/Reflector_Template.zip?1790694385)
## Build Volume
The parts require a 3D printer with a minimum build volume of 92 (X) x 92 (Y) x 32mm (Z).
## 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/).
# Pepper's Ghost Monster Eye
## Install CircuitPython - Flash Filesystem
[CircuitPython](https://github.com/adafruit/circuitpython) is a derivative of [MicroPython](https://micropython.org) designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. Simply copy and edit files on the **CIRCUITPY** drive to iterate.
## CircuitPython Quickstart
Follow this step-by-step to quickly get CircuitPython running on your board.
This microcontroller requires the latest **unstable (development) **release of CircuitPython. Click below to visit the downloads page on **circuitpython.org** for your board. Then, Browse **S3** under **Absolute Newest**.
[Download the latest version of CircuitPython for this board via circuitpython.org](https://circuitpython.org/board/adafruit_qualia_s3_rgb666/)
**Click the link above to download the latest CircuitPython UF2 file.**
Save it wherever is convenient for you.
Warning:
Plug your board into your computer, using a known-good data-sync cable, directly, or via an adapter if needed.
Double-click the **reset** button (highlighted in red above), and you will see the **RGB status LED(s)** turn green (highlighted in green above). If you see red, try another port, or if you're using an adapter or hub, try without the hub, or different adapter or hub.
Warning:
For this board, tap reset and wait about a half a second and then tap reset again.
Warning:
If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the rhythm right!
A lot of people end up using charge-only USB cables and it is very frustrating! **Make sure you have a USB cable you know is good for data sync.**
You will see a new disk drive appear called **TFT\_S3BOOT**.
Drag the **adafruit\_circuitpython\_etc.uf2** file to **TFT\_S3BOOT**.
The **BOOT** drive will disappear and a new disk drive called **CIRCUITPY** will appear.
That's it!
# Pepper's Ghost Monster Eye
## Code the Eye
Info: Monster Eyes is an Arduino sketch. CircuitPython is installed to use the **CIRCUITPY** file system to store eyeball graphics.
## Eyeball Graphics
After installing CircuitPython, you can drag and drop the eyeball graphics onto your **CIRCUITPY** drive. The three eyeball types (hazel, demon and snake) are available in this .ZIP file:
[Pepper's Ghost Monster Eye Graphics](https://cdn-learn.adafruit.com/assets/assets/000/146/638/original/PeppersGhostMonsterEyesGraphics.zip?1790608382)
After downloading, unzip the file. You'll see three folders containing graphics.
Each folder contains a set of .BMP images for that eye, plus a file called \ ***.eye**. Copy one of these folders to the **CIRCUITPY** drive — _not_ the individual files, but the _whole folder._ Then copy or move the file called **\*.eye** out of the folder and into the drive’s root directory.
Here is what your **CIRCUITPY** drive should look like after copying the graphics folders and **moving the \*.eye files** to the root directory.
## Upload UF2 File
The Qualia S3 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.
[Pepper's Ghost Monster Eye UF2 for Qualia S3](https://cdn-learn.adafruit.com/assets/assets/000/146/642/original/peppersGhostQualia.uf2?1790610749)
**Click the button 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 **peppersGhostQualia.UF2** file to **TFT\_S3BOOT**.
The code will begin running by animating the hazel eye graphics on the display. Press the UP button to change the eyeball graphics. Press the DOWN button to toggle the eyeball floating offscreen repeatedly.
## Source Code in Arduino
Below is the Arduino project sketch. You can compile and upload this sketch locally if you prefer. First, you'll need to install the Adafruit Monster Eyes library. Then, you can edit the code and upload it to your Qualia S3 board.
### Adafruit Monster Eyes - Install the Monster Eyes Library
[Adafruit Monster Eyes](https://learn.adafruit.com/adafruit-monster-eyes)
[Install the Monster Eyes Library](https://learn.adafruit.com/adafruit-monster-eyes/install-the-monster-eyes-library)
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/Qualia/Qualia_S3_Peppers_Ghost_Monster_Eye/peppersGhostQualia/peppersGhostQualia.ino
# Pepper's Ghost Monster Eye
## Assembly
## Connect Display to Qualia ESP32-S3
Orient the Qualia PCB and the 2.1in display with both facing up.
Carefully lift the tab from the display connector on the Qualia PCB.
Insert the flex ribbon cable from the display into the Qualia's display connector.
Carefully press down on the the tab to secure the ribbon cable.
## Secure Qualia ESP32-S3
Use four M2.5 x 6mm long short machine screws.
Orient the Qualia PCB with the flat edge of the bottom cover.
Place the Qualia PCB onto the four standoffs on the bottom cover with the mounting holes lined up.
Insert and fasten the machine screws to secure the PCB to the bottom cover.
## Secure Display
Place the 2.1in display into the display cover with the ribbon cable fitting through the cutout.
Insert the display holder underneath the three nubs on the inner edge of the display cover.
Press the display holder to snap fit them into place with the opening oriented with the display's ribbon cable.
## Install Display Case
Insert the display case assembly through the bottom of the frame.
Pull the display case assemble through the frame.
## Install Buttons to Frame
Orient the Qualia PCB with the frame so the USB-port and buttons are lined up with the corresponding cutouts.
Insert the button overlay through the matching cutouts on the frame.
Press the bottom cover into the frame to snap fit them together.
## Secure Display Case
Press the display case assemble into the frame so it sits on the inner ledge.
## Test Eye
Connect the Qualia ESP32-S3 to a 5V power supply or a computers USB hub to power it up and test the circuit.
## Install Reflector
Get the clear plastic reflector and reflector holder.
Insert the flat edge of the reflector into the clip on the holder.
## Install Reflector to Snow Globe
Remove the stock bottom cover and insert from the snow globe.
While holding the reflector in the holder, insert the reflector through the opening in the snow globe. Bend and flex the reflector so it can fit into the opening.
The reflector may pop out of the holder during installation. Keep the holder inside the snow globe while adjusting the reflector, then reinstall the reflector so the flat edge is fitted into the retaining clip.
## Install Snow Globe Holder
Install the snow globe holder by twisting it clock-wise until it's tightly fitted.
Rotate the reflector inside the snow globe so the edge is oriented with the snow globe's seam.
## Install Snow Globe to Frame
Fit the snow globe holder into the frame with the two nubs lined up with the matching cutouts.
Once fitted, twist the snow globe holder clock-wise to lock it into place.
The snow globe holder can be rotated so the retaining clip from reflector holder is lined up with the flat edge of the frame.
## Align and Orient Reflector
Power on the Qualia ESP32-S3. Twist the snow globe holder to rotate the reflector until the animated eye appears in the desired location.
If the reflector needs to be reoriented inside the globe, remove it from the holder and readjust as needed.
# Pepper's Ghost Monster Eye
## Use
## Switch Graphics
Press the UP (middle) button on the Qualia ESP32-S3 to toggle between hazel, demon, and snake eyes.
## Floating Eye Mode
Press the DOWN button (left) to toggle the eyeball floating offscreen repeatedly.
## Guide Products
### DIY Snow Globe Kit
[DIY Snow Globe Kit](https://www.adafruit.com/product/3722)
Not merely a snow globe, but a _show_ globe! This custom container is durable, clear and round, with a large flat screw-on top and a press-fit rubber stopper. The stopper makes a nice seal, and is also _hollow_ which means you can put (you guessed it...) electronics inside! This...
In Stock
[Buy Now](https://www.adafruit.com/product/3722)
[Related Guides to the Product](https://learn.adafruit.com/products/3722/guides)
### 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
Out of Stock
[Buy Now](https://www.adafruit.com/product/5800)
[Related Guides to the Product](https://learn.adafruit.com/products/5800/guides)
### USB Type A to Type C Cable - approx 1 meter / 3 ft long
[USB Type A to Type C Cable - approx 1 meter / 3 ft long](https://www.adafruit.com/product/4474)
As technology changes and adapts, so does Adafruit. This **USB Type A to Type C** cable will help you with the transition to USB C, even if you're still totin' around a USB Type A hub, computer or laptop.
USB C is the latest industry-standard connector for...
In Stock
[Buy Now](https://www.adafruit.com/product/4474)
[Related Guides to the Product](https://learn.adafruit.com/products/4474/guides)
### 5V 1A (1000mA) USB port power supply - UL Listed
[5V 1A (1000mA) USB port power supply - UL Listed](https://www.adafruit.com/product/501)
Need a USB jack for charging or powering a project, but don't want to lug around a computer? This switching supply gives a clean regulated output at up to 1000mA! 110 or 240 input, so it works in any country. The plugs are "US 2-prong" style so you may need a plug adapter, but...
In Stock
[Buy Now](https://www.adafruit.com/product/501)
[Related Guides to the Product](https://learn.adafruit.com/products/501/guides)
## Related Guides
- [Adafruit Qualia ESP32-S3 for RGB-666 Displays](https://learn.adafruit.com/adafruit-qualia-esp32-s3-for-rgb666-displays.md)
- [CircuitPython Audio FX](https://learn.adafruit.com/circuitpython-audio-fx.md)
- [Laser-Cut Layered LED Art Panel (Wood + Acrylic) with WLED](https://learn.adafruit.com/laser-cut-layered-led-art-panel-wood-acrylic-with-wled.md)
- [MIDI Breath Controller](https://learn.adafruit.com/midi-breath-controller.md)
- [Logic Gates Simulator on Fruit Jam](https://learn.adafruit.com/logic-gates-simulator-on-fruit-jam.md)
- [Fruit Jam Motion Tracking Eyeballs](https://learn.adafruit.com/fruit-jam-motion-tracking-eyeballs.md)
- [Mini Weather Station ESP32-S3 TFT](https://learn.adafruit.com/mini-weather-station-esp32-s2-tft.md)
- [IoT Bird Feeder with Camera](https://learn.adafruit.com/iot-window-bird-feeder-with-camera.md)
- [Metro Minimalist Clock](https://learn.adafruit.com/metro-minimalist-clock.md)
- [Memento Photo Capture with itsaSNAP](https://learn.adafruit.com/memento-photo-capture-with-itsasnap.md)
- [Bubble Table with LED Animations and IR Remote Control](https://learn.adafruit.com/bubble-table-with-led-animations-and-ir-remote-control.md)
- [IoT Battery Monitor](https://learn.adafruit.com/iot-battery-monitor.md)
- [Fisher-Price USB Foot Pedal](https://learn.adafruit.com/fisher-price-usb-foot-pedal.md)
- [MacroPad Remote Procedure Calls over USB to Control Home Assistant](https://learn.adafruit.com/macropad-remote-procedure-calls-over-usb-to-control-home-assistant.md)
- [Arcade Machine/Console Emulator for Fruit Jam](https://learn.adafruit.com/space-invaders-for-fruit-jam.md)
- [Adafruit MagTag Kitchen Timer](https://learn.adafruit.com/adafruit-magtag-kitchen-timer.md)