Visual Effects

Several text and transition effects are included:

• Pop
• Shake
• Glitch
• Zoom In
• Typewriter
• Bounce
• Invert
• Fade Effects

Components Required

Hardware Components

• ESP32 DevKit V1
• SSD1306 OLED Display (128×64)
• Breadboard
• Jumper Wires
• USB Cable

Display Specifications

• Resolution: 128×64
• Interface: I2C
• Driver IC: SSD1306

Circuit Connections

OLED to ESP32

| OLED Pin | ESP32 Pin | | -------- | --------- | | VCC | 3.3V | | GND | GND | | SDA | GPIO21 | | SCL | GPIO22 |

Wiring Summary

OLED VCC → 3.3V
OLED GND → GND
OLED SDA → GPIO21
OLED SCL → GPIO22

Required Libraries

Install Libraries

Install the following libraries through Arduino IDE Library Manager:

• Adafruit SSD1306
• Adafruit GFX
• Wire

Upload Procedure

Step 1

Connect the ESP32 board to your computer.

Step 2

Open the Arduino IDE.

Step 3

Install all required libraries.

Step 4

Select:

• Board: ESP32 Dev Module
• Correct COM Port

Step 5

Upload the sketch.

Step 6

After resetting the ESP32, the Love Me Not animation sequence will start automatically.

How It Works

Timeline System

The project uses a predefined timeline synchronized with the song.

Each scene contains:

• Start Time
• Duration
• Lyric Text
• Animation Effect
• Background Animation

Background Switching

The visualizer automatically changes its background animation based on the current section of the song.

OLED Rendering

Every frame:

1. The background animation is generated.
2. Animated visual effects are rendered.
3. Lyrics are displayed.
4. The OLED buffer is updated.
5. The process repeats continuously.

This creates smooth real-time animation on the small 128×64 OLED display.

Troubleshooting

OLED Not Detected

Blank Screen

Compilation Error

Slow Performance

Learning Outcomes

After completing this project, you will understand:

• OLED Graphics Programming
• I2C Communication
• Animation Programming
• Timeline-Based Synchronization
• Frame Rendering
• Text Animation Effects
• ESP32 Development
• Real-Time Embedded Graphics
• Music-Synchronized Visual Design

Conclusion

The Love Me Not OLED Music Visualizer transforms a small SSD1306 OLED display into a dynamic music-driven animation system. By combining synchronized lyrics, animated backgrounds, text effects, and real-time frame rendering, the project creates an immersive visual experience using an ESP32 microcontroller.

It is a great example of how a simple OLED display can be pushed beyond basic text and sensor displays to create advanced graphics and music-synchronized animations.