This project is inspired by OSU!Catch the beat and consists of catching falling balls on an 8x8 matrix. You have 10 lives, lose one for every miss, and recover two for every catch. As the speed increases, can you keep up with the beat?

Retro Rhythm: The Catch The Beat Experience

Inspired by the fan-favorite OSU!Catch mode, Arduino Catch The Beat brings high-speed rhythmic gaming to a simple $8\times8$ LED grid. Using a physical Rotary Potentiometer as your controller, you must slide your "catcher" across the bottom row of the matrix to intercept falling "beats" (LED pixels) before they hit the ground. It’s a masterclass in Real-Time Input Mapping and Collision Detection for the Arduino platform.

Game Mechanics and Difficulty Scaling

The game is designed for addictive, short-burst play sessions:

• Life System: You start with 10 lives. Missing a falling ball costs you one life, but a successful catch rewards you with 1 point and restores 2 lives (up to the maximum capacity).
• Speed Ramping: Every 4 points earned, the internal game clock accelerates. The falling pixels move faster and faster, requiring razor-sharp reflexes and a steady hand on the potentiometer.
• Audio Feedback: An integrated Passive Buzzer provides chip-tune sound effects for catches, misses, and the dreaded "Game Over" siren.

Precision Control: Potentiometer to Matrix

The core technical challenge lies in translating analog input to a digital grid:

1. Analog Smoothing: The 10-bit raw data ($0-1023$) from the potentiometer is "mapped" down to the 8 columns of the matrix. The code uses small software buffers to ensure the catcher doesn't "flicker" between columns due to electronic noise.
2. The Matrix Driver: Using the LedControl library and a MAX7219 driver chip, the project achieves flicker-free rendering of the falling beats, even at extreme game speeds.
3. Frame Logic: The game loop manages three distinct states: the "Catcher" position (bottom row), the "Falling Beats" (randomized spawns), and the "Collision Check" (when a beat overlaps with the catcher).

Build Your Own Arcade Cabinet

Once you've mastered the breadboard version, this project is the perfect candidate for a Miniature Arcade Cabinet. By 3D-printing a small housing and using a larger "Trimmer" knob, you can create a desktop gadget that challenges your co-workers or friends. This project demonstrates how simple hardware components, when paired with clever logic, can create a deeply engaging and professional-tier gaming experience.

How to do this project:

Step 1: Check Arduino connection.

Step 2: Copy and paste the code in new sketch of Arduino IDE.

Step 3: Connect the LED matrix, buzzer and potentiometer to Arduino.

Step 4: Enjoy the game ^^