denki-kurage

Denki Kurage

Denki Kurage (ja: 電気くらげ, electric jellyfish)

A sort of an artificial jellyfish on CYD (Cheap Yellow Display, ESP32).

• Retro, low-poly 3D jellyfish animation for the CYD, an ESP32 development board with an integrated screen.
• Touch the screen to change color modes or adjust the water current speed.
• Customizable enclosure designed with OpenSCAD.
• Just watch the jellyfish swimming and chill.

This project is currently only for the CYD2USB (CYD variants with a USB-C port).

BOM

Component	Quantity	Notes
ESP32-2432S028 (CYD2USB variant)	1	2.8" TFT “Cheap Yellow Display” with USB-C + Micro USB
M2x3 Self-Tapping screw	4

Getting Started

1. Print the enclosure: Use the 3MF files in ./enclosure to 3D print the stand.
2. Flash the firmware: Use the Web Flasher to flash the latest firmware directly from your browser.
3. Assemble: Put the CYD into the enclosure and secure it with four M2x3 self-tapping screws.

3D Printed Parts

For .3mf and .scad files, see ./enclosure.

Controls (Touch)

Area	Action
Top / Bottom strip (Left side)	Move Up / Down
Middle left / Middle right	Rotate Camera
Center area	Cycle Colors
Top-right corner (Solid / Wireframe)	Toggle Mode
Bottom-right corner	Debug Info

Building from source

Built and flashed using PlatformIO.

pio run -t upload

Gallery

Acknowledgements

• TFT_eSPI by Bodmer
• XPT2046_Touchscreen by Paul Stoffregen
• ESP32-Cheap-Yellow-Display by Witnessmenow
• BOSL2 library for enclosure design
• M+ FONTS for typography
• 人工くらげ for the inspiration
• A reference to Philip K. Dick’s Electric Sheep (ja: 電気羊)

License

• Software: MIT
• Font (M+ FONTS): SIL Open Font License. M+ FONTS are free to use, modify, and redistribute.