🏎️ TypeRacer Pro - Advanced Typing Bot

Note: I have already emailed to the typeracer about this bug now this may not work and I don't have time to continue this project.

⚠️ Educational Purpose Only: This extension is created for educational purposes to understand automation and web scraping. Please use responsibly and in accordance with TypeRacer's terms of service.

🌟 Features

🎯 Core Features

• 🎮 Intelligent Typing Control: Customizable typing speed with human-like patterns
• 🤖 Human-like Errors: Configurable error rate to simulate natural typing mistakes
• ⚡ Real-time Word Detection: Automatically detects and types the next word
• 🔄 Auto-restart: Automatically starts new races after completion

🆕 Advanced Features

• 🧠 Humanized Typing Patterns:
  • Slower typing for capital letters and special characters
  • Faster typing for common words
  • Variable delays between keystrokes
• 💥 Burst Mode: Occasional fast typing bursts for realism
• 📊 Live Stats: Real-time WPM calculation and accuracy display
• 🎨 Modern UI: Beautiful, responsive popup interface

🔍 OCR Support

• 📸 Image Recognition: Automatically solves image-based typing challenges
• 🤖 OCR Integration: Uses OCR.space API for text extraction
• ⚙️ Auto-submit: Optional automatic submission of OCR results

🚀 Installation

Method 1: Load as Unpacked Extension

1. Download or clone this repository
2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" (top right toggle)
4. Click "Load unpacked" and select the project folder
5. The extension will appear in your browser toolbar

Method 2: Manual Installation

1. Download the ZIP file of this repository
2. Extract to a folder on your computer
3. Follow steps 2-5 from Method 1

⚙️ Configuration

🎛️ Settings Panel

Click the extension icon to open the settings panel:

Setting	Description	Range	Default
Typing Speed	Delay between keystrokes (ms)	10-200	80ms
Error Rate	Percentage of intentional typos	0-100%	2%
Humanized Typing	Enable human-like typing patterns	ON/OFF	ON
Burst Mode	Enable occasional fast typing	ON/OFF	OFF
Auto-Submit OCR	Auto-submit OCR challenges	ON/OFF	OFF
OCR API Key	Your OCR.space API key	Text	Required for OCR

🔧 Advanced Configuration

For developers who want to modify selectors or behavior:

Selectors (in content_script.js):

const SELECTORS = {
    WORDS_CONTAINER: ".hideableWords.unselectable",
    TEXT_INPUT: ".txtInput",
    COUNTDOWN_POPUP: ".countdownPopup.horizontalCountdownPopup",
    OCR_CONTAINER: ".bodyWidgetHolder",
    CHALLENGE_TEXTAREA: ".challengeTextArea",
    SUBMIT_BUTTON: ".gwt-Button"
};

🎮 Usage

1. Install and Configure: Install the extension and configure your preferred settings
2. Get OCR API Key (optional): Sign up at OCR.space for free API key
3. Navigate to TypeRacer: Go to play.typeracer.com
4. Start a Race: The bot will automatically detect when a race starts
5. Watch the Magic: The bot will type with human-like patterns and errors

📊 Performance Tips

• For Higher WPM: Decrease typing speed (lower ms value)
• For Realism: Keep error rate between 1-3%
• For Stealth: Enable humanized typing and burst mode
• For OCR: Ensure you have a valid API key

🎨 Interface Preview

🖥️ Popup Interface

• Modern Dark Theme: Sleek GitHub-inspired design
• Real-time Stats: Live WPM and accuracy display
• Interactive Controls: Sliders and toggles for easy configuration
• Status Feedback: Visual feedback for all actions

📱 Responsive Design

• Optimized for different screen sizes
• Smooth animations and transitions
• Intuitive user experience

🛠️ Technical Details

📁 Project Structure

typeracer-cheat/
├── 📄 manifest.json          # Extension configuration
├── 🎨 popup.html             # Settings interface
├── ⚙️ popup.js               # Settings logic
├── 🤖 content_script.js      # Main bot logic
├── 📖 README.md              # This file
└── 🎨 icons/                 # Extension icons
    ├── Blog.png
    └── Blog.svg

🔧 Key Technologies

• Chrome Extension API: For browser integration
• MutationObserver: For DOM change detection
• OCR.space API: For image text recognition
• Modern CSS: For beautiful UI design
• Vanilla JavaScript: For lightweight performance

🎯 Algorithm Features

• Smart Word Detection: Uses MutationObserver for real-time updates
• Human Error Simulation: Probabilistic typo generation
• Adaptive Timing: Context-aware typing speed adjustment
• Memory Management: Proper cleanup of observers and timers

💪 Strengths

• ✅ Excellent UI/UX: Modern, intuitive interface
• ✅ Advanced Features: Humanized typing, burst mode, OCR
• ✅ Clean Code: Well-structured and maintainable
• ✅ Educational Value: Great for learning automation
• ✅ Customizable: Extensive configuration options

🔄 Areas for Improvement

• 🔧 API Dependencies: Relies on external OCR service
• 🔧 Detection Resilience: May need updates if TypeRacer changes
• 🔧 More Antiblocking: The more random typing behavior to prevent blocking.
• 🔧 Performance: Could add more optimization for slower devices

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

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

⚠️ Disclaimer

This extension is created for educational purposes only. The author does not encourage or endorse:

• Cheating in competitions
• Violating terms of service
• Unfair advantage in typing tests

Use this tool responsibly and ethically. Always respect the platform's rules and other users.

🙏 Acknowledgments

• OCR.space for the OCR API
• The open-source community for inspiration

---

Made with ❤️ for the coding community

Happy Typing! 🎉