Christian Krakau-Louis
204941a1dc
- Created a detailed database schema document outlining tables, relationships, and key fields. - Added OAuth integration documentation covering Spotify and Dropbox authentication processes. - Introduced a FAQ section addressing common user inquiries about the application. - Developed a user-friendly index page for easy navigation of the documentation. - Specified documentation dependencies in requirements.txt for building the documentation site. - Expanded user guide with sections on account management, creating rounds, exporting rounds, getting started, importing songs, and user interface navigation. - Updated mkdocs.yml for improved site structure and navigation.
5.3 KiB
Frequently Asked Questions
General Questions
What is Quizzical Beats?
Quizzical Beats is a web application designed to help quiz hosts create music quiz rounds. It integrates with Spotify to access a vast music library and provides tools for round generation, song management, and export options.
Is Quizzical Beats free to use?
Quizzical Beats is free for personal use. Depending on your deployment, your administrator may have established specific licensing terms for your organization.
Which browsers are supported?
Quizzical Beats works with all modern browsers including Chrome, Firefox, Safari, and Edge. For the best experience, we recommend keeping your browser updated to the latest version.
Account Management
How do I create an account?
You can create an account by visiting the login page and clicking "Register." You can sign up with an email and password or use OAuth providers like Spotify, Google, or Authentik (if enabled by your administrator).
Can I change my password?
Yes, you can change your password by going to Profile > Security > Change Password.
I forgot my password. How do I reset it?
On the login page, click the "Forgot Password" link and follow the instructions sent to your email.
How do I connect my Spotify account?
Go to Profile > Connected Accounts and click "Connect" next to Spotify. You'll be redirected to Spotify to authorize the connection.
Why should I connect my Dropbox account?
Connecting your Dropbox account allows you to export quiz rounds directly to your Dropbox, making it easy to access them from any device or share them with others.
Song Management
How many songs can I import at once?
You can import up to 100 songs at once when importing from a Spotify playlist. For CSV imports, there's a limit of 500 songs per file.
Why are some of my songs missing preview URLs?
Spotify doesn't provide preview URLs for all tracks. If a song doesn't have a preview URL, you'll need to add your own audio snippet or find an alternative version of the song.
How can I edit song metadata?
Select the song from your library and click "Edit." You can then modify its metadata including title, artist, album, and year.
Can I add my own songs not found on Spotify?
Yes, you can manually add songs to your library by going to Songs > Add New Song and filling in the details. You can also upload your own MP3 snippet.
Round Creation
How many rounds can I create?
There's no fixed limit on the number of rounds you can create, though performance may decrease with very large numbers of rounds (1000+).
What's the ideal number of songs in a round?
Most quiz hosts find 8-10 songs per round works well, providing enough variety without making the round too long.
Can I reuse songs across multiple rounds?
Yes, you can add the same song to multiple rounds. The song library keeps track of all your songs, allowing you to reuse them as needed.
How do I create a themed round?
Use the filter options when creating a round to focus on specific genres, decades, or artists. You can also create a custom round by manually selecting songs that fit your theme.
Exporting
What export formats are available?
Quizzical Beats supports exporting rounds as PDF (questions and answers), MP3 (audio files), ZIP (combined package), and CSV (raw data).
How do I export directly to Dropbox?
Connect your Dropbox account, then when exporting a round, select "Export to Dropbox" as the destination. You can then choose which folder to export to.
Can I customize the exported PDFs?
Yes, you can customize the PDF header, footer, and overall layout in Settings > Export Preferences.
Why is my export taking a long time?
Exports with many rounds or large audio files may take longer. MP3 generation and packaging can be resource-intensive.
Troubleshooting
Spotify connection isn't working
Try disconnecting and reconnecting your Spotify account. If the issue persists, ensure that your Spotify account is active and that you've granted all the required permissions.
The application seems slow
Performance depends on several factors including your device, internet connection, and the size of your song library. Try clearing your browser cache or using a different browser.
Audio playback issues
If you're experiencing audio playback issues, check your device volume, try a different browser, or ensure that you have a stable internet connection.
I found a bug. How do I report it?
Contact your system administrator or send an email to support@kaufdeinquiz.com with details about the bug and steps to reproduce it.
Administration
How do I back up my data?
Administrators can create backups through the Admin > System > Backup interface. Backups can be scheduled or created manually.
How do I restore from a backup?
Go to Admin > System > Restore, select the backup file, and follow the instructions to restore your data.
Can I run Quizzical Beats offline?
Quizzical Beats requires internet access to connect to Spotify and other services. However, once songs are imported, you can use some features offline.
How do I update Quizzical Beats?
Administrators can update the application by pulling the latest version from the repository and restarting the application. For Docker installations, update the container image.