MeowP3

Reproductor de música de escritorio con estética kawaii oscura

---

✨ Características

• ▶️ Play / Pause
• ⏭️ Siguiente / ⏮️ Anterior
• 🔁 Modo repetir
• 🔀 Modo aleatorio
• 📋 Lista de canciones
• 🔊 Control de volumen
• 🎵 Barra de progreso interactiva
• 🌙 Tema oscuro kawaii — sin fondo, flota sobre el escritorio
• 🐱 Se detectan automáticamente los .mp3 de la carpeta music/

🛠️ Stack

Tecnología	Uso
React 18	Interfaz de usuario
Electron 28	App de escritorio (sin navegador)
Node.js + Express	Servidor local que lee la carpeta de música
HTML5 Audio API	Reproducción de audio
CSS Variables	Theming kawaii oscuro

📁 Estructura del proyecto

kawaii-player/
├── public/
│   └── index.html
├── src/
│   ├── App.jsx        # Componente principal
│   ├── App.css        # Estilos kawaii dark
│   └── index.js       # Entry point
├── package.json
└── README.md

🚀 Correr en desarrollo

Terminal 1 — servidor de música:

node server.js

Terminal 2 — app Electron:

npm run electron-dev

La app se abre como ventana flotante sin fondo, sin navegador.

🎵 Canciones incluidas

Música libre de derechos de autor de Pixabay:

Canción	Artista
Pink Candy	AI Seven
Gummy Drive	Mvno
Kawaii Pop Sparkle	Nala Subrada
Kawaii Drops	Poorkid Music

☁️ Agregar tu propia música

Solo arrastra tus archivos .mp3 a la carpeta public/music/ — el reproductor los detecta automáticamente sin tocar ningún archivo de código.

Para conectar una base de datos en la nube (uso personal privado), crea un .env.local con tus credenciales de Firebase o Supabase. Este archivo está en .gitignore y nunca se sube al repositorio.

---

Made with 🖤 and ≽^•⩊•^≼