JavaScript

Analisi AI · Italiano

openai · gpt-4o-mini

Sintesi

Cupid Music Player è un lettore musicale desktop dall'estetica pixel-art, costruito con Electron, Vite e React. Offre un'interfaccia utente distintiva con animazioni a tema vinile, supporta la riproduzione di MP3 locali, e si integra con Spotify e Apple Music per lo streaming di playlist, recuperando l'audio tramite yt-dlp. Il progetto si distingue per il suo design retrò e le funzionalità cross-platform.

Casi d'uso

→Ascoltare musica locale MP3 con un'interfaccia utente unica e personalizzabile.
→Accedere e riprodurre playlist di Spotify e Apple Music senza la necessità di abbonamenti premium, sfruttando lo streaming da YouTube.
→Personalizzare l'esperienza di ascolto su desktop con temi visivi pixel-art e animazioni retrò.
→Sviluppare applicazioni desktop con Electron e React, prendendo ispirazione per interfacce utente innovative e integrazioni di servizi terzi.

Idee SaaS / Business

Piattaforma di Streaming Personalizzata Retrò

Una piattaforma SaaS che permette agli utenti di creare e personalizzare il proprio lettore musicale desktop con varie skin pixel-art e funzionalità. Potrebbe includere piani premium per skin esclusive, integrazioni aggiuntive o funzionalità sociali.

API di Metadati Musicali Avanzati

Un servizio API basato sulla logica di estrazione dei metadati di Cupid Player (come music-metadata) offrendo un'estrazione robusta e standardizzata per sviluppatori musicali che cercano metadati di alta qualità per i loro file audio locali e integrazioni con servizi di streaming.

Servizio di 'Playlist Mixer' Cross-Platform

Un servizio web che consente agli utenti di unificare e gestire le proprie playlist da diverse piattaforme (Spotify, Apple Music, file locali) e di esportarle o riprodurle tramite un'interfaccia unica, magari con un player desktop companion nello stile di Cupid.

Target utenti

Amanti della musica, nostalgiaci dello stile pixel-art, sviluppatori e appassionati di personalizzazione desktop che cercano un lettore musicale funzionale con un estetismo distintivo e integrazioni avanzate.

Categoria

Electron, Vite, React

Monetizzazione

Potenziale per modelli freemium con funzionalità premium (skin esclusive, temi avanzati, più integrazioni), donazioni, o un marketplace di temi e animazioni creato dalla community.

Licenza

Non specificata

Trend: La tendenza per le interfacce utente retrò e la personalizzazione desktop è in crescita, così come l'interesse per soluzioni che unificano l'esperienza di streaming musicale.

README · tradotto in italiano

Cupid Music Player

Un lettore musicale desktop in pixel-art costruito con Electron, Vite e React.

Caratteristiche

Caratteristica	Descrizione
UI Pixel-art	Interfaccia con giradischi animato, vinile che gira e puntina.
Animazione vinile	Animazione di cambio disco (vinile rosa/blu alternato) al cambio brano.
Barra di progresso	Interattiva con indicatore a stella trascinabile.
Scorrimento titoli	Scorrimento a "marquee" per titoli di brani lunghi.
Temi	Commutazione tra temi rosa e blu con preferenza persistente.
Integrazione Spotify	Naviga le tue playlist e riproduci brani tramite yt-dlp.
Integrazione Apple Music	Naviga le playlist della tua libreria tramite MusicKit JS.
MP3 locali	Riproduzione di file MP3 locali.
Finestra personalizzata	Finestra senza cornice, trascinabile e ridimensionabile.
Icona dinamica	Icona della dock/taskbar che si abbina al tema attivo.

Iniziare

npm install
npm run dev

Aggiunta di file audio locali

Crea una cartella audio/ nella directory radice del progetto (se non esiste).
Inserisci i tuoi file .mp3 nella cartella audio/.
Assicurati che i tuoi file MP3 abbiano metadati incorporati (titolo, artista, copertina album) — il lettore li legge automaticamente.
Riavvia l'applicazione.

Il lettore utilizza la libreria music-metadata per estrarre informazioni sulla traccia e copertine album dai tuoi file MP3. I file senza metadati verranno comunque riprodotti ma potrebbero essere mostrati come "Sconosciuto".

Formati supportati

.mp3 — consigliato, ampiamente supportato con tag ID3.

Aggiunta di metadati ai tuoi MP3

Se i tuoi file non hanno metadati, puoi aggiungerli con strumenti come:

MP3Tag (Windows)
Kid3 (Mac/Linux/Windows)
iTunes/Music.app — clicca con il destro su una canzone > Ottieni informazioni.

Configurazione Spotify

Riproduci qualsiasi brano dalle tue playlist Spotify. L'audio viene recuperato da YouTube tramite yt-dlp, quindi Spotify Premium non è richiesto.

Crea un'applicazione Spotify su developer.spotify.com/dashboard.
Aggiungi http://127.0.0.1:5173/callback come URI di reindirizzamento.
Copia .env.example in .env e aggiungi il tuo Client ID.
Aggiungiti in Impostazioni > Gestione utenti.
Clicca sull'icona delle impostazioni nel lettore > accedi.

Consulta SPOTIFY_SETUP.md per istruzioni dettagliate e risoluzione dei problemi.

Configurazione Apple Music

Naviga le playlist della tua libreria Apple Music. Richiede un account sviluppatore Apple. L'abbonamento ad Apple Music non è richiesto per la riproduzione.

Crea una chiave MusicKit su developer.apple.com/account/resources/authkeys.
Scarica il file chiave .p8 e posizionalo nella directory radice del progetto.
Aggiungi APPLE_TEAM_ID e APPLE_KEY_ID al tuo .env.
Clicca sull'icona delle impostazioni > passa ad Apple > accedi.

Consulta APPLE_MUSIC_SETUP.md per istruzioni dettagliate e risoluzione dei problemi.

Build

npm run package

Installazione come App Desktop

macOS:

cp -r "out/mac-arm64/Cupid Player.app" /Applications/

Windows: Esegui l'installer da out/Cupid Player Setup.exe. Se npm run package fallisce al passaggio NSIS con "Cannot create symbolic link," abilita la Modalità Sviluppatore in Impostazioni → Sistema → Per sviluppatori, quindi esegui di nuovo. L'app non imballata in out/win-unpacked/Cupid Player.exe è completamente eseguibile nel frattempo — nessun installer richiesto.

Linux: Esegui l'AppImage da out/.

Nota: La build per macOS non è firmata. Al primo avvio potrebbe essere necessario fare clic con il tasto destro > Apri, o andare in Impostazioni di Sistema > Privacy e Sicurezza per consentirla.

Stack Tecnologico

Tecnologia	Uso
Electron	Shell dell'app desktop (finestra senza cornice, IPC, systray).
Vite	Strumento di build e server di sviluppo.
React	Framework UI.
HTML5 Audio	Riproduzione MP3 locale.
yt-dlp	Streaming audio da YouTube per tracce Spotify/Apple Music.
Spotify Web API	Recupero playlist e metadati (OAuth PKCE).
Apple MusicKit JS	Accesso alla libreria delle playlist (autenticazione JWT).
CSS	Proprietà personalizzate per il tema, scalatura responsiva basata su calc().
Node.js	Processo principale (generazione JWT, esecuzione yt-dlp).
jsonwebtoken	Generazione di token sviluppatore Apple Music.
music-metadata	Estrazione tag ID3 MP3 (titolo, artista, copertina album).

Attività commit · ultime 26 settimane

stima

Approfondimenti AI

L'AI sta preparando gli approfondimenti…

Chiedi al repo

AI · contesto README + issue

Fai una domanda sul progetto. L'AI legge README e issue recenti.

Sponsor · Sconto esclusivo RepoRadar AI

Hai bisogno di un server per far girare cupidbity/cupid-music-player?

Abbiamo testato decine di provider e Hostinger VPS è il miglior rapporto qualità/prezzo per self-hostare le repo che trovi qui. Setup in 1 click, pannello semplice e supporto 24/7.

Deploy in 1 click

2 vCPU · 8 GB RAM · NVMe

Backup + DDoS inclusi

Attiva sconto Hostinger VPSLink affiliato — supporti RepoRadar senza costi extra per te.

Compatibile con Lovable · Invito esclusivo

Integra cupidbity/cupid-music-player in un progetto Lovable

Questa repo è compatibile con lo stack di Lovable. Importala in un nuovo progetto o aggiungila a uno esistente: Lovable si occupa di setup, deploy, backend e auth — tu chiedi in linguaggio naturale e l'AI scrive il codice.

Setup zero-config

Backend + Auth inclusi

Deploy con 1 click

Motivo compatibilità

Abbiamo rilevato segnali che indicano uno stack supportato da Lovable:

langJavaScript

Registrati gratis su LovableLink invito — bonus crediti per chi si registra da RepoRadar.

Questo progetto esiste grazie a voi

RepoRadar AI è gratis e senza pubblicità. Le donazioni coprono server, API e modelli AI.

Ogni analisi tradotta che leggi costa qualche centesimo di chiamate al modello. Se RepoRadar ti ha fatto risparmiare tempo, considera una piccola donazione cripto — anche pochi euro aiutano a mantenere il servizio libero per tutti.

Ethereum

ETH

0x86ECDF546d8dFc0739d44c066A6110F11cdB7773

Bitcoin

BTC

bc1qqe0wcmhnt78enk8ql0lxvey4z8hquxsxjtyz8r

Solana

SOL

EtTK61Lz7kfdDM8543TMMiAUUTbFVpzX5tvPEcBtZ3aj

Grazie di cuore — ogni contributo conta.