# Welcome to Quizzical Beats Documentation

![Quizzical Beats Logo](static/img/logo.png){ align=center }

## Music Quiz Round Generator

**Quizzical Beats** is a comprehensive web application for creating engaging music quiz rounds. Leveraging APIs from services like Spotify and Last.fm, it allows quiz hosts to generate rounds based on specific genres, decades, or completely random criteria, making your music quizzes dynamic and entertaining.

## Features

- **Spotify Integration**: Import songs and playlists directly from Spotify
- **Dynamic Round Creation**: Generate rounds based on genres, decades, or tags
- **Export Options**: Download as PDFs or playable MP3s
- **Dropbox Integration**: Export rounds directly to your Dropbox
- **User Accounts**: Personal settings, custom audio intros/outros
- **Multiple Authentication Methods**: Local, Google, and Authentik OAuth
- **System Backup & Restore**: Comprehensive backup solution with scheduling
- **Admin Dashboard**: Monitor system health and manage users

## Documentation Structure

This documentation is organized into several sections:

- **[User Guide](user-guide/getting-started.md)**: Learn how to use Quizzical Beats
- **[Admin Guide](admin-guide/installation.md)**: Installation and maintenance information
- **[Developer Guide](developer-guide/architecture.md)**: Technical documentation for developers
- **[FAQ](faq.md)**: Frequently asked questions
- **[Changelog](changelog.md)**: Version history and feature additions

## Getting Started

To get started with Quizzical Beats, visit the [Getting Started](user-guide/getting-started.md) guide.

## Support

If you need help using Quizzical Beats, please check the [FAQ](faq.md) first. If your question isn't answered there, contact support at [support@kaufdeinquiz.com](mailto:support@kaufdeinquiz.com).