Guess The YouTuber

"Guess The YouTuber" is an interactive web-based guessing game inspired by guessme.io. Players view YouTube video thumbnails and attempt to guess the YouTuber's name. The game features a beautiful animated particle background, scoring system, lives counter, and hint system for an engaging gaming experience.

Features

• YouTube Thumbnail Guessing: Random thumbnails from popular YouTubers
• Scoring & Lives System: Points for correct guesses, 3 lives with game over
• Smart Hints: Partial channel name revealed after first wrong attempt
• Animated Particles: 80+ floating particles with interactive effects
• Dark Theme: Modern glass-morphism UI design
• Mobile Responsive: Optimized for all devices

Quick Start

For a quick setup, run these commands:

Clone and setup

git clone https://github.com/badhon495/Guess-The-Youtuber.git
cd Guess-The-Youtuber
npm install

Setup environment variables

cp frontend/.env.example frontend/.env
cp backend/.env.example backend/.env

Add your YouTube API key to backend/.env file

echo "YOUTUBE_API_KEY=your_actual_api_key_here" > backend/.env

Start both servers

npm run start:backend &
npm run start:frontend

Then open http://localhost:3000 in your browser!

How It Works

1. Backend fetches random YouTuber data using YouTube Data API v3
2. Frontend displays video thumbnail to player
3. Player guesses the YouTuber's name
4. Correct guess: +1 point, new video loads
5. Wrong guess: Hint shown, then life deducted after second wrong guess

Troubleshooting

API Quota Exceeded: When YouTube API daily quota is reached, the app displays a message asking users to try again tomorrow.

Port Conflicts: Kill processes on port 5000: pkill -f "node.*5000"

Missing API Key: Add your YouTube API key to backend/.env file.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

⭐ Star this repo if you found it helpful!