Welcome to SoundWave
SoundWave is a web-based music player that integrates with Spotify and YouTube, giving you multiple ways to search, play, and download your favorite music. This guide will get you started quickly.SoundWave consists of three different player interfaces, each designed for a specific use case. Choose the one that fits your needs!
Choose Your Player
SoundWave offers three distinct player interfaces:Spotify Player
Search and stream music using Spotify’s embedded player
YouTube Player
Search and play music from YouTube with advanced filtering
Download Generator
Generate direct download links from Spotify tracks
Spotify Player
The Spotify Player (index.html or index3.html) provides a clean interface for searching and playing Spotify tracks.
Accessing the Spotify Player
Open the Player
Navigate to
index.html (fixed-width desktop version) or index3.html (responsive version) in your web browser.Search for Music
Enter a song name, artist, or album in the search bar and click Buscar (Search).The player will display matching results from Spotify’s catalog.
How It Works
The Spotify Player uses the Spotify Web API to search for tracks and displays them using Spotify’s embedded iframe player.User Interface
The Spotify Player features:- Search Bar: Enter your search query (song, artist, or album)
- Results List: Clickable list of matching tracks in Spotify green (
#1db954) - Embedded Player: Spotify iframe player that loads selected tracks
- Dark Theme: Spotify-inspired dark background (
#121212)
The player automatically obtains a Spotify access token when the page loads, so you can start searching immediately without any authentication steps.
YouTube Player
The YouTube Player (scripts.js with styles.css) offers advanced search capabilities with real-time suggestions and smart filtering.
Accessing the YouTube Player
Type to See Suggestions
Start typing in the search field. Real-time suggestions will appear as you type, powered by YouTube/Invidious search.The player uses a 300ms debounce to avoid excessive API calls.
Click a Suggestion or Search
Either click on a suggestion to auto-fill and search, or press the Buscar button to search manually.
Browse Results
Results are displayed in groups of 5. Use the navigation buttons (
< and >) to browse through multiple pages of results.Advanced Features
Key Capabilities
The YouTube Player includes several advanced features:- Real-time Suggestions: See suggestions as you type with intelligent debouncing
- Smart Filtering: Automatically filters results to match your search term and excludes “official” videos
- Multi-Page Search: Searches up to 6 pages of results (30 tracks)
- Grouped Results: Results are organized in groups of 5 for easy browsing
- Auto-Play: Automatically fetches and plays audio when you select a track
- Fallback URLs: Uses multiple Invidious instances for reliability
Download Generator
The Download Generator (index2.html) converts Spotify track URLs into direct download links.
Using the Download Generator
Generate Download Link
Click Get Download Link to process the URL.The backend service will fetch the track and generate a direct download link.
Implementation Details
User Interface
The Download Generator features a clean, minimal design:- Light Theme: White background with subtle shadows
- Simple Form: Single input field for Spotify URLs
- Green Button: Prominent “Get Download Link” button (
#4CAF50) - Integrated Player: HTML5 audio player that appears with the download link
- Error Handling: Clear error messages for invalid URLs or failed requests
API Backend
All three players rely on a Node.js backend hosted athttps://jsnode-ab0e.onrender.com that provides:
Endpoints
| Endpoint | Method | Purpose |
|---|---|---|
/ | POST | Get Spotify access token (index.html) |
/get-token | POST | Get Spotify access token (index3.html) |
/search | GET | Search Spotify catalog |
/get-download-link | POST | Convert Spotify URL to download link |
CORS Proxy
The YouTube Player useshttps://api.allorigins.win/raw?url= as a CORS proxy to fetch content from Invidious instances (inv.nadeko.net and yewtu.be).
Quick Reference
File Structure
Styling
All players use consistent color schemes:Next Steps
Architecture Overview
Learn about the technical architecture and API integrations
Styling Guide
Understand the styling system and design
All players work out of the box without any configuration. Simply open the HTML files in a modern web browser and start searching for music!