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.
72 lines
2.6 KiB
Markdown
72 lines
2.6 KiB
Markdown
# 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:
|
|
|
|
1. Navigate to the Rounds page
|
|
2. Select the round you want to view
|
|
3. 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
|
|
|
|
1. Go to your Profile page
|
|
2. Find the "Connected Services" section
|
|
3. Click "Connect Dropbox"
|
|
4. Follow the authorization prompts from Dropbox
|
|
5. Once connected, your Dropbox status will show as "Connected"
|
|
|
|
### Setting Your Dropbox Export Path
|
|
|
|
1. Go to your Profile page > Edit Profile
|
|
2. Find the "Dropbox Export Path" field
|
|
3. Enter your preferred folder path or use the default "/QuizzicalBeats"
|
|
4. If your account is connected, you can click "Browse" to select a folder
|
|
5. Save your changes
|
|
|
|
### Exporting Rounds to Dropbox
|
|
|
|
1. Navigate to the Rounds page
|
|
2. Select the round you want to export
|
|
3. Click "Export to Dropbox" button in the export options section
|
|
4. In the export modal, choose whether to include MP3 files
|
|
5. 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
|
|
1. Check your Dropbox connection status in your Profile
|
|
2. If your token has expired, reconnect your Dropbox account
|
|
3. If the export fails because MP3 generation is required, click the provided link to generate the MP3 first
|
|
4. Verify you have sufficient Dropbox storage space
|
|
5. Check for any error messages displayed during the export process
|
|
|
|
### MP3 Export Issues
|
|
1. Ensure all songs in the round have valid preview URLs
|
|
2. Try regenerating the round MP3 by clicking the "Generate MP3" button on the round page
|
|
3. If some songs lack preview URLs, you may need to edit those songs to add valid URLs |