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.
2.6 KiB
2.6 KiB
Exporting Rounds
This guide explains the available methods for exporting your music quiz rounds from Quizzical Beats.
Available Export Options
Quizzical Beats currently supports the following export options:
- PDF: Round document with questions, answers, and song information
- MP3: Audio file with all songs concatenated for playback during your quiz
- JSON: Metadata about the round and songs (exported automatically with Dropbox exports)
Local Export
To export a round to your local device:
- Navigate to the Rounds page
- Select the round you want to view
- Click the "Download MP3" or "Download PDF" button to save the respective file
Dropbox Export
Quizzical Beats integrates with Dropbox to easily store your rounds in the cloud:
Connecting to Dropbox
- Go to your Profile page
- Find the "Connected Services" section
- Click "Connect Dropbox"
- Follow the authorization prompts from Dropbox
- Once connected, your Dropbox status will show as "Connected"
Setting Your Dropbox Export Path
- Go to your Profile page > Edit Profile
- Find the "Dropbox Export Path" field
- Enter your preferred folder path or use the default "/QuizzicalBeats"
- If your account is connected, you can click "Browse" to select a folder
- Save your changes
Exporting Rounds to Dropbox
- Navigate to the Rounds page
- Select the round you want to export
- Click "Export to Dropbox" button in the export options section
- In the export modal, choose whether to include MP3 files
- Click "Export Round" to send the files to your configured Dropbox folder
The system will create a folder structure in your Dropbox with the following format:
/[Your Export Path]/Round_[ID]_[Round Name]/
├── round_[ID].mp3 (if MP3 option was selected)
├── round_[ID].pdf
└── Metadata/
└── round_[ID]_metadata.json
After the export completes successfully, you will see shared links to access each exported file directly.
Troubleshooting Exports
Failed Dropbox Export
- Check your Dropbox connection status in your Profile
- If your token has expired, reconnect your Dropbox account
- If the export fails because MP3 generation is required, click the provided link to generate the MP3 first
- Verify you have sufficient Dropbox storage space
- Check for any error messages displayed during the export process
MP3 Export Issues
- Ensure all songs in the round have valid preview URLs
- Try regenerating the round MP3 by clicking the "Generate MP3" button on the round page
- If some songs lack preview URLs, you may need to edit those songs to add valid URLs