🎮 The Ultimate Word Guessing Game Integration for Home Assistant 🎮
A professional HTML panel word guessing game that brings the complete word puzzle experience directly to your Home Assistant sidebar!
🎯 Modern HTML Panel Interface
- Sidebar Integration - Native Home Assistant panel experience
- Dynamic Responsive Design - HTML panel that automatically resizes to different screen sizes
- Multi-Device Perfect - Optimized for desktop, tablet, and mobile experiences in web browser or Home Assistant App.
- Theme Integration - Automatically matches your HA theme (light/dark)
- Professional UI - Clean, intuitive game interface
🛡️ Advanced Anti-Cheat System
- Smart Validation - Prevents vowel dumping and unrealistic guessing patterns
- Fair Play Enforcement - Blocks common cheating strategies like "AEIOU"
- Balanced Word Requirements - Ensures realistic letter combinations
- Real-time Feedback - Instant notifications for rule violations
🌐 Bulletproof Reliability & Multi-Language Support
- Multi-API System - 3-tier word generation with automatic failover
- 4 Languages Supported - English, Spanish, French, and German with automatic locale detection
- Expandable Framework - Ready for additional language APIs
- Offline Capability - Built-in word lists when APIs unavailable
- Connection Recovery - Automatic reconnection handling
- Smart Polling - Intelligent refresh system
⚡ Enhanced Gameplay
- Variable Difficulty - Easy, Normal, or Hard modes
- Multiple Word Lengths - 5, 6, 7, or 8-letter words
- Smart Guess Limits - Number of guesses equals word length
- Color-Coded Feedback - 🔵 Correct • 🔴 Wrong position • ⚪ Not in word
- Dictionary Hints - AI-powered clues from real definitions if available for the returned word. if the returned word fails to get an api hint a generic hint will be used.
- Statistics Tracking - Win rates, streaks, guess distribution, and play time
Quick Overview:
- Install via HACS (available in official store)
- Generate a long-lived access token in HA
- Add integration via Settings → Devices & Services
- Enter your access token to enable authentication
- Select which users can access the game
- Access game from sidebar
- Word Length: Choose between 5, 6, 7, or 8-letter words
- Guess Limit: Number of attempts equals word length
- Valid Words: Real English words with balanced letter patterns
- Win Condition: Guess the exact word within your attempts
- 🔵 Blue Tile: Correct letter in correct position
- 🔴 Red Tile: Correct letter in wrong position
- ⚪ White Tile: Letter not in the word
- Easy: Hints shown before guessing
- Normal: Hints available on request
- Hard: No hints available
The game enforces fair play by blocking unrealistic strategies:
❌ Blocked Examples: AEIOU, AAEIO, AAAAB
✅ Fair Examples: HOUSE, BOARD, STEAM, QUICK
The game includes comprehensive statistics tracking, multi-user support, and audio customization options accessible through the game interface.
- BOARD - Excellent consonant/vowel balance
- STEAM - Tests common letter patterns
- FLING - Multiple consonant combinations
- CHORE - Balanced letter distribution
- ✅ Use balanced vowel/consonant ratios
- ✅ Include multiple different consonants
- ✅ Test common letter patterns (TH, ST, ING)
- ✅ Focus on real English words
- ✅ Use hints strategically when stuck
- Primary API:
random-word-api.herokuapp.com - Backup API:
random-word-api.vercel.app - Fallback API:
random-words-api.vercel.app - Local Words: Built-in word lists (400+ words) for offline play
- Authentication Protection - Secure token-based access
- Intelligent Polling - Adaptive refresh rates
- Error Recovery - Automatic backoff and reconnection
- Activity Tracking - Optimized performance
- No Data Collection - Everything stays local to your HA instance
- No External Accounts - Zero registration required
- Secure Token Authentication - Protected API access
- Local Fallbacks - Works completely offline
- Safe API Usage - Smart request limiting
- Home Assistant: 2023.1.0 or newer
- Browser: Modern browser with JavaScript enabled
- Network: Internet connection for word APIs (optional)
- Configuration: Long-lived access token required
- Dutch (NL) - Netherlands localization
- Italian (IT) - Italian word support
- Portuguese (PT) - Portuguese language addition
- Full UI Internationalization - Ready for supported Languages
We welcome community contributions for additional language APIs! Character-based languages (Chinese, Japanese, etc.) are not planned due to gameplay mechanics.
Current Languages: English, Spanish, French, German ✅
- Custom Word Lists - User-defined word collections
- Word Length Game Stats - Full word length game stats for each word length game. (currently global all word lenth games together)
- Multiplayer Modes - Family tournaments and challenges
- Advanced Themes - More visual customization options
- Sound Effects - Optional audio feedback (respects HA quiet hours)
Want to help? Contribute language APIs or suggest features!
We welcome contributions! Areas of interest:
- Language Support - Add word APIs for other languages
- UI Enhancements - Improve visual experience and animations
- Game Modes - Additional play styles and difficulty options
- Performance - Optimization and efficiency improvements
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Community: Home Assistant Forum
MIT License - See LICENSE file for details.
- Inspired by Josh Wardle's original Wordle
- Built for the Home Assistant community
- Uses Free Dictionary API and multiple Random Word APIs
- Special thanks to HACS for distribution support
🎮 Ready to play? Follow the installation guide to get started!
Note: This integration is not affiliated with the original Wordle game or The New York Times. ** It is My take upon a word guessing game, My code, My icon, My Hard Work.. ** ps. I never wrote a single line of code. I challenged myself to use online Ai to do everything. all of the code was generated by Anthropic Claude Sonnet 4 & Opus 4. We fell out quite a few times but here it is. do not get me started on the totally screwed up Anthropic Artifact system in projects that should be scrapped or completely re written as it is beyond a joke.