Home

PlayList Converter Wiki

Welcome to the PlayList Converter wiki! Here you'll find detailed information about using and configuring the application.

Table of Contents

1. Quick Start
2. Authentication Setup
3. Using the Application
4. Troubleshooting
5. Technical Details
6. Support Resources

Quick Start

1. Landing Page: Start by choosing which platforms to connect

2. Connect Services: Click to connect your Spotify and YouTube accounts

Authentication Setup

Spotify Setup

1. Click "Connect Spotify" to authorize access

2. View your Spotify playlists

YouTube Setup

1. Click "Connect YouTube" to authorize access

2. View your YouTube playlists

Using the Application

Converting Playlists

1. Select Tracks: Choose which tracks to convert

2. Review Selection: Verify your selected tracks

3. Conversion Result: View the converted playlist

Managing API Quotas

• YouTube API has daily limits
• For a 10-track playlist:
  • Creating playlist: 50 units
  • Searching tracks: 1000 units
  • Adding tracks: 500 units

Technical Details

System Architecture

• Built with Spring Boot 2.7.18
• Uses OAuth 2.0 for secure authentication
• RESTful API integration with both platforms
• Thymeleaf templating engine
• Bootstrap 4.5.2 for responsive design

API Integration

1. Spotify API

   • Authentication: OAuth 2.0
   • Scope: playlist-read-private, playlist-modify-private
   • Rate Limits: 1000 requests/day
   • Batch Processing: Up to 50 tracks per request

2. YouTube API

   • Authentication: OAuth 2.0
   • Scope: youtube.force-ssl
   • Daily Quota: 10,000 units
   • Search Cost: 100 units/query
   • Write Operations: 50 units each

Troubleshooting

Common Issues

• If conversion fails, check YouTube API quota
• Clear browser cache for auth issues
• Ensure all redirect URIs match

Advanced Troubleshooting

OAuth Issues

• Token expired: Re-authenticate through landing page
• Invalid scope: Check API console settings
• Redirect URI mismatch: Verify URIs in both platforms

Quota Management

• Monitor usage in Google Cloud Console
• Implement batch processing for large playlists
• Use caching for frequent conversions
• Schedule conversions during off-peak hours

Performance Optimization

• Convert during non-peak hours
• Use batch processing when available
• Cache frequently accessed playlists
• Monitor API response times

Best Practices

1. Start with smaller playlists (≤10 tracks)
2. Allow delays between conversions
3. Monitor your quota usage
4. Break large playlists into chunks

Support Resources

Getting Help

• Technical Support: tech.support@playlistconverter.com
• Feature Requests: features@playlistconverter.com
• Bug Reports: bugs@playlistconverter.com

Community

• Join Discussions: Join the conversation
• Contributing: See our Contributing Guide
• Feature Requests: Submit via GitHub Issues

Need more help? Create an issue on our GitHub repository.