gitea-admin/gh-christianlouis-quizzicalbeats
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update FAQ to include Deezer integration; clarify licensing terms; enhance song import and export details; improve troubleshooting guidance.

Browse Source
This commit is contained in:
Christian Krakau-Louis
2025-05-13 21:23:39 +02:00
parent 04adfea0d0
commit 9d3065beab
1 changed files with 12 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/faq.md
+12 -12
View File
@@ -3,10 +3,10 @@
## 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.
Quizzical Beats is a web application designed to help quiz hosts create music quiz rounds. It integrates with Spotify and Deezer to access vast music libraries 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.
Yes, Quizzical Beats is free to use and is released under the MIT license, which allows for both personal and commercial use. You can find the full license details in the LICENSE file in the project repository.
### 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.
@@ -31,16 +31,16 @@ Connecting your Dropbox account allows you to export quiz rounds directly to you
## 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.
You can import up to 100 songs at once when importing from a Spotify or Deezer 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.
Some streaming services don't provide preview URLs for all tracks. If a song doesn't have a preview URL, you'll need to find an alternative version of the song that has a preview available.
### 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.
### Can I add my own songs not found on Spotify or Deezer?
No, currently Quizzical Beats does not support uploading your own MP3 files. All songs must be imported from supported streaming services like Spotify or Deezer.
## Round Creation
@@ -59,21 +59,21 @@ Use the filter options when creating a round to focus on specific genres, decade
## 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).
Quizzical Beats supports exporting rounds as PDF (questions and answers), MP3 (audio files), ZIP (combined package), and JSON (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.
No, the PDF export format is standardized and cannot be customized. All PDFs follow a consistent layout that includes round information, song details, and answer fields.
### 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.
### Spotify or Deezer connection isn't working
Try disconnecting and reconnecting your account. If the issue persists, ensure that your 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.
@@ -87,13 +87,13 @@ Contact your system administrator or send an email to support@kaufdeinquiz.com w
## 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.
Administrators can create backups through the Admin > System > Backup interface. Backups can be scheduled or created manually and include the database, media files, and configuration.
### 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.
Quizzical Beats requires internet access to connect to Spotify, Deezer, 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.