# Bleme · Funciones

Bleme es una aplicación de escritorio para DJs que organiza tu biblioteca de música por características sonoras, no por metadata manual. Esta página describe **qué hace** cada función, con casos de uso típicos.

---

## Semilla

**Qué hace:** elegís un track de tu biblioteca como referencia y Bleme devuelve una lista con los tracks que mejor le encajan sonoramente · mismo mood, energía y textura.

**Entrada:** un track de la biblioteca.
**Salida:** una lista ordenada de tracks parecidos, con un score de afinidad.

**Casos de uso típicos:**
- Armar un set alrededor de una idea o un track de referencia.
- Encontrar continuaciones naturales para una transición.
- Descubrir tracks que combinan sin depender de tags manuales.
- Reemplazar un track por otro similar sin romper el mood del set.

---

## Cluster

**Qué hace:** muestra toda tu biblioteca como un mapa navegable en tres dimensiones. Los tracks que suenan parecido quedan cerca; los que suenan distinto quedan lejos.

**Entrada:** tu biblioteca completa (o un subset filtrado).
**Salida:** un espacio 3D navegable con el mouse. Cada punto es un track. Pasás el mouse por encima para ver título y datos; hacés click para reproducir.

**Casos de uso típicos:**
- Explorar visualmente qué grupos existen dentro de tu biblioteca.
- Encontrar nichos y microgéneros que armaste sin darte cuenta.
- Redescubrir tracks olvidados en las zonas menos frecuentadas del mapa.
- Ver qué tan homogénea o dispersa es una selección puntual.

---

## Export & Sync

**Qué hace:** todo lo que armás dentro de Bleme (playlists, cues, ratings, metadata editada) se puede exportar directo a los software con los que pinchás. No pisa lo que ya tenías.

**Entrada:** playlists y tracks trabajados dentro de Bleme.
**Salida:** los mismos datos disponibles en la biblioteca de Traktor o Rekordbox, con backup automático previo.

**Casos de uso típicos:**
- Migrar sets armados en Bleme al software que usás en cabina.
- Mantener metadata y cues sincronizados entre Bleme, Traktor y Rekordbox.
- Trabajar con tracks nuevos en Bleme y verlos aparecer en tu plataforma sin importarlos manualmente.

---

## Monitoreo de carpetas

**Qué hace:** apuntás a una o varias carpetas donde descargás música, y Bleme detecta los tracks nuevos automáticamente. Los analiza y agrega a la biblioteca sin intervención.

**Entrada:** una o más carpetas del sistema de archivos.
**Salida:** tracks nuevos aparecen analizados y clasificados en la biblioteca, listos para semilla y cluster.

**Casos de uso típicos:**
- Comprás tracks nuevos y aparecen listos para usar sin importación manual.
- Enchufás un disco externo y sus tracks nuevos entran a la biblioteca en background.
- Mantenés la biblioteca al día sin trabajo repetitivo.

---

## Funciones de soporte

### Detección de cover art
Detecta y muestra la portada de cada track.

### Grid / BPM / Key
Detecta el tempo (BPM), la tonalidad (key) y el beat grid de cada track. Estos datos se persisten y se exportan al software del usuario.

### Editor de cues
Editor de hot cues y memory cues. Los cues sincronizan con Traktor y Rekordbox.

### Filtros y búsqueda
Filtrado en tiempo real por título, artista, género, BPM, key, tags, rating y otros campos. Combinables entre sí.

### Rating y tagging
Sistema propio de puntuación (0–5 estrellas) y tags de texto libre. Se exportan a Traktor y Rekordbox.

### Cover flow y player
Vista de la biblioteca con miniaturas de cover art, player integrado con play/pause, seek y volumen. Soporta MP3, WAV, AIFF y FLAC.

---

## Integraciones

| Plataforma | Lee | Escribe | Elementos sincronizados |
|-----------|-----|---------|-------------------------|
| Traktor | ✅ | ✅ | Playlists, hot cues, memory cues, ratings, tags, metadata |
| Rekordbox | ✅ | ✅ | Playlists, cues, metadata |
| iTunes | ✅ | · | Biblioteca (solo lectura) |

Todas las escrituras hacen backup automático antes de tocar la biblioteca.

---

## Plataformas soportadas

- **Windows** · versión estable.
- **macOS** · en desarrollo.

---

## Modelo de trabajo

Bleme funciona encima de tu biblioteca actual · **no la mueve, no la renombra, no la reorganiza en el sistema de archivos**. Los cambios sonoros y de clasificación viven dentro de Bleme y se propagan a los software que elijas.

Si dejás de usar Bleme, tu biblioteca queda exactamente como estaba antes: nada perdido, nada corrupto.

---

## Preguntas frecuentes

Ver [FAQ](/faq.md).
