Monkimusic

MonkiMusic is a floating desktop music player with a pixel art mascot that dances to the rhythm of your music and reacts to your clicks and keystrokes.

Features:

• Local music player (MP3, FLAC, WAV, OGG)
• Spotify integration (bring your own API key — see below)
• 4 unlockable character skins
• 12+ dances, each unique per character
• 30+ unlockable themes with visual effects (synthwave, aurora, underwater, and more)
• Custom skindance slots — load your own sprite sheets or GIFs
• Remix system — combine dances into custom sequences
• Per-song dance and skin assignments
• Achievement system
• 9 languages supported

Everything unlocks through clicks and keystrokes — just use your computer and watch your collection grow.

How to use Spotify mode:

Due to Spotify's developer policies, MonkiMusic cannot include a built-in Spotify key for public use. Instead, each user can connect their own Spotify Developer account for free. Here's how:

1. Go to developer.spotify.com/dashboard and log in
2. Click "Create app" and give it any name
3. In your app settings, add http://127.0.0.1:8888/callback as a Redirect URI
4. Go to the "User Management" tab and add your name and Spotify email (plus up to 4 friends you want to share access with)
5. Copy your Client ID
6. In MonkiMusic, switch to the Spotify tab and paste your Client ID
7. Log in with your Spotify account — done!

Note: Spotify Premium is required for playback control. Only accounts added in "User Management" will be able to connect (max 5 per Spotify app). MonkiMusic does not store or download any music — it only controls your Spotify player.

Custom Skindances (sprite sheets & GIFs):

You can load your own animations into skindance slots. Supported formats:

• PNG sprite sheets: Horizontal strip of frames. Recommended frame size: 32x32 pixels. The app auto-detects frame count from the image dimensions (width ÷ height = number of frames). Other sizes work too — they will be scaled to fit.
• GIF: Animated GIFs are displayed as-is, scaled to fit the character container.

Note: Windows may show a security warning because the app is not code-signed yet. Click "More info" → "Run anyway" to proceed. This is normal for indie software.

MonkiMusic es un reproductor de música flotante para escritorio con una mascota pixel art que baila al ritmo de tu música y reacciona a tus clics y tecleo.

Características:

• Reproductor local (MP3, FLAC, WAV, OGG)
• Integración con Spotify (trae tu propia API key — ver abajo)
• 4 skins de personajes desbloqueables
• 12+ bailes, cada uno único por personaje
• 30+ temas desbloqueables con efectos visuales (synthwave, aurora, underwater y más)
• Slots de skindance personalizados — carga tus propios sprite sheets o GIFs
• Sistema de remix — combina bailes en secuencias personalizadas
• Asignación de baile y skin por canción
• Sistema de logros
• 9 idiomas soportados

Todo se desbloquea con clics y tecleo — solo usa tu computadora y mira cómo crece tu colección.

Cómo usar el modo Spotify:

Debido a las políticas de Spotify para desarrolladores, MonkiMusic no puede incluir una clave de Spotify integrada para uso público. En su lugar, cada usuario puede conectar su propia cuenta de Spotify Developer de forma gratuita. Así se hace:

1. Ve a developer.spotify.com/dashboard e inicia sesión
2. Haz clic en "Create app" y ponle cualquier nombre
3. En la configuración de tu app, agrega http://127.0.0.1:8888/callback como Redirect URI
4. Ve a la pestaña "User Management" y agrega tu nombre y email de Spotify (y el de hasta 4 amigos que quieras que lo usen)
5. Copia tu Client ID
6. En MonkiMusic, cambia a la pestaña Spotify y pega tu Client ID
7. Inicia sesión con tu cuenta de Spotify — ¡listo!

Nota: Se requiere Spotify Premium para controlar la reproducción. Solo las cuentas agregadas en "User Management" podrán conectarse (máximo 5 por app de Spotify). MonkiMusic no almacena ni descarga música — solo controla tu reproductor de Spotify.

Skindances personalizados (sprite sheets y GIFs):

Puedes cargar tus propias animaciones en los slots de skindance. Formatos soportados:

• Sprite sheets PNG: Tira horizontal de frames. Tamaño de frame recomendado: 32x32 píxeles. La app detecta automáticamente el número de frames según las dimensiones de la imagen (ancho ÷ alto = número de frames). Otros tamaños también funcionan — se escalan para ajustarse.
• GIF: Los GIFs animados se muestran tal cual, escalados al contenedor del personaje.

Nota: Windows puede mostrar una advertencia de seguridad porque la app aún no tiene firma digital. Haz clic en "Más información" → "Ejecutar de todas formas". Esto es normal en software independiente.