gitea-admin/gh-christianlouis-quizzicalbeats

Files

T

Christian Krakau-Louis 204941a1dc Add comprehensive documentation for Quizzical Beats

- 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.

2025-05-13 11:25:20 +02:00

2.8 KiB

Raw Blame History

Importing Songs

This guide explains the various methods for importing songs into Quizzical Beats to build your music quiz library.

Music Service Integrations

Quizzical Beats supports importing songs from popular streaming services:

Spotify Integration

Connecting Your Spotify Account

For full functionality, you'll need to connect your Spotify account
Login to Quizzical Beats and authorize the Spotify connection
Once connected, you can access and import songs from Spotify

Importing from Spotify

There are several ways to import songs from Spotify:

Import Official Playlists:
- Navigate to Import > Official Playlists
- Browse playlists from official Spotify accounts
- Filter by keywords if needed
- Click "Import" on the playlist you want to add
Import Your Playlists:
- Navigate to Import > From Playlist
- Enter a Spotify playlist URL or ID
- Click "Import Playlist"
- The songs will be added to your library
Import Individual Albums or Tracks:
- Navigate to Import > Album or Import > Song
- Enter the Spotify URL or ID of the album/track
- Click "Import" to add the songs to your library

Deezer Integration

Quizzical Beats also supports importing songs from Deezer:

Import Deezer Playlists:
- Navigate to Import > From Playlist
- Select "Deezer" as the platform
- Enter a Deezer playlist URL or ID
- Click "Import Playlist"
Import Deezer Albums or Tracks:
- Navigate to Import > From Deezer
- Choose to import an album or track
- Enter the Deezer URL or ID
- Click "Import" to add to your library

Creating Rounds from Imported Songs

You can create rounds directly from imported playlists:

Navigate to Import > From Playlist
Enter the playlist URL and select the platform (Spotify or Deezer)
Optionally provide a name for your round
Click "Import Playlist"
Review the generated round
Click "Save This Quiz" to create the round

Viewing Imported Songs

After importing songs:

Go to the Songs page to see your newly imported music
The songs will be displayed with available metadata including:
- Title and artist
- Album and year
- Genre (when available)
- Preview URLs

Troubleshooting Import Issues

Missing Audio Previews: Some tracks may not have preview URLs available. In this case:

Try importing from a different source (Spotify vs. Deezer)
Look for an alternative version of the song
Some songs may not have preview URLs available from any source

Duplicate Songs: The system will automatically detect duplicates based on:

Spotify/Deezer IDs
ISRC codes when available

Limited Imports: For performance reasons, when creating rounds from playlists:

Only a limited number of songs (typically 8-10) will be included in a round
All songs are saved to your library for future use

2.8 KiB Raw Blame History