Skip to content

darkhold is a self-hosted alternative emulating the famous classroom quiz portal Kahoot.

License

Notifications You must be signed in to change notification settings

surajcm/darkhold

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

382 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Darkhold [Beta version ready]

Self-hosted quiz platform, inspired by kahoot. Please note that this is work in progress and not ready for production use. This is maintained by a single developer and contributions are welcome.

Author

👤 Suraj Muraleedharan

🐋 Docker

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. If you contribute please commit to a new branch and explain details in your pull request not in your commit.

Remember to abide by our adapted from Contributor Covenant 2.1 Code of Conduct too

Show your support

Give a ⭐️ if this project helped you!

Screenshots

Please head over to Wiki

✨ Key Features

🎮 Game Modes

  • Multiplayer - Real-time quiz with live PIN-based join
  • Practice Mode - Solo play with instant feedback
  • Team Mode - Collaborative gameplay with 3 assignment methods (Balanced, Random, Manual)

📝 Question Types

  • Multiple Choice (2-4 options, single or multiple correct answers)
  • True/False
  • Type Answer (with fuzzy matching for typos)
  • Poll (no correct answer, shows distribution)

🎨 Rich Content

  • Image support for questions
  • YouTube video embedding
  • Configurable time limits per question
  • Customizable point values

📊 Analytics & Reports

  • Detailed game results with participant statistics
  • Question-level analytics (success rate, difficulty)
  • CSV export for external analysis
  • Past games history

🌍 Internationalization

  • English (en) - Complete ✅
  • Spanish (es) - Complete ✅
  • French (fr) - Partial (contributors welcome!)
  • German (de) - Partial (contributors welcome!)

🎨 Modern UI/UX

  • Dark/Light mode toggle
  • Sound effects and animations
  • PWA support for mobile
  • Fully responsive design
  • Accessibility features (ARIA, keyboard navigation)

🔧 Technical

  • Spring Boot 4.0 with WebSocket/STOMP for real-time gameplay
  • PostgreSQL or H2 database support
  • Docker & Docker Compose ready
  • Comprehensive test suite (427 tests, 51% coverage)

For detailed installation guides and system requirements, please head over to Wiki.

About

darkhold is a self-hosted alternative emulating the famous classroom quiz portal Kahoot.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5