mirror of https://github.com/M4X809/list-of-lp.git synced 2025-12-25 19:12:48 +00:00

- Added a new script command "fetch-links" to package.json for fetching song links.
- Updated tsconfig.json to include "bun-types" in the types array.
- Removed the VIEW_TRANSITIONS_GUIDE.md file.
- Modified album track IDs to be more descriptive and added Spotify URLs for each track in list.ts.
- Updated ListTypes.ts to include a new field for Spotify URLs in the Track type.
- Cleaned up the AlbumDetail component by removing commented-out code for the album header.

2025-10-25 01:02:10 +02:00

2.2 KiB

Raw Blame History

Song Links Fetcher

This script fetches streaming links (Spotify, YouTube, YouTube Music, Apple Music) for all Linkin Park songs in the project using the SongLink API.

Features

🎵 Fetches links for all songs from the list.ts file using their Spotify URLs
⏱️ Respects API rate limit (10 requests per minute)
💾 Caches already-fetched songs to avoid redundant API calls
📁 Outputs both TypeScript and JSON files
📊 Shows progress and summary statistics
⏭️ Automatically skips songs without Spotify URLs
🎨 Automatically formats all generated files with Prettier

Usage

Run the script with:

bun run fetch-links

Output Files

src/lib/songLinks.ts - TypeScript file with exported songLinks object
data/song-links.json - JSON file with all song links
data/fetched-songs.json - Cache file tracking which songs have been fetched

Data Structure

The generated TypeScript file exports a songLinks object with this structure:

{
  "hybrid-theory-1": {
    "spotify": "https://open.spotify.com/track/...",
    "youtube": "https://www.youtube.com/watch?v=...",
    "youtubeMusic": "https://music.youtube.com/watch?v=...",
    "appleMusic": "https://music.apple.com/..."
  },
  // ... more songs
}

API Information

API: SongLink/Odesli API
Endpoint: https://api.song.link/v1-alpha.1/links
Parameters:
- url: Spotify track URL (encoded)
- userCountry: DE (Germany)
- songIfSingle: true (for better matching)
Rate Limit: 10 requests per minute
Delay between requests: 6 seconds

Requirements

Each track in list.ts must have a __SPOTIFY_URL__ field with a valid Spotify track URL. Tracks without this field will be automatically skipped.

Resumable

If the script is interrupted or fails for any song, you can simply run it again. It will:

Skip already-fetched songs (based on the cache file)
Continue fetching remaining songs
Preserve all previously fetched data

Clearing Cache

To re-fetch all songs from scratch, delete the cache file:

rm data/fetched-songs.json

2.2 KiB Raw Blame History