Configuración
La mayoría de los ajustes viven en la pestaña Configuración de la ventana de control, donde los ajustas mientras preparas un evento. Un puñado de opciones que rara vez se tocan viven en Preferencias (Archivo → Preferencias). Todo se guarda en un archivo TOML automáticamente — nunca necesitas editarlo a mano.

| Plataforma | Ubicación del archivo de configuración |
|---|---|
| macOS | ~/Library/Application Support/milonga/config.toml |
| Windows | %APPDATA%\milonga\config.toml |
| Linux | ~/.config/milonga/config.toml |
Dónde vive cada ajuste
| En la pestaña Configuración | En Preferencias |
|---|---|
| Datos del evento (nombre del DJ, lugar, nombre de la milonga) | General (idioma, créditos de bienvenida, carpeta de sesión) |
| Aplicación DJ y sus ajustes | Coincidencia (puntuación, La Cumparsita, aprendizaje) |
| Ciclo de tanda | Base de datos (archivo de grabaciones) |
| Ventana de reproducción y ajustes de disposición | Visualización (imágenes de fondo, opacidad, reglas de texto) |
Datos del evento
En Configuración → Evento:
| Ajuste | Descripción |
|---|---|
| Nombre del TDJ | Mostrado en el banner del nombre del DJ en la parte inferior de la pantalla. Se actualiza en vivo — no es necesario reiniciar. |
| Lugar | Usado en el mensaje de bienvenida: Bienvenidos en [Lugar]. |
| Nombre de la milonga | Usado junto al nombre del DJ: Esta noche en la [Nombre de la milonga] damos la bienvenida a [Nombre del TDJ]. |
Aplicación DJ
En Configuración → Evento, el grupo Aplicación DJ selecciona tu software. Solo una aplicación funciona a la vez; usa Iniciar / Detener para controlar la fuente.
Traktor
Milonga se conecta a Traktor mediante el broadcast traktor-nowplaying. Lanza traktor-nowplaying como subproceso y escucha en el puerto TCP configurado (por defecto: 8000). Haz clic en Iniciar para empezar a escuchar.
También puedes apuntar Milonga a tu colección Traktor exportada con Usar metadatos Traktor (ver Dar más información al motor).
VirtualDJ
Cuando seleccionas VirtualDJ, Milonga vigila el archivo de historial diario de VirtualDJ
(History/YYYY-MM-DD.m3u en el directorio de datos de VirtualDJ) y recoge cada nueva pista en
cuanto se escribe. Los ajustes muestran las rutas autodetectadas del directorio de historial y de
tu database.xml (la base de datos local de pistas de VirtualDJ, leída por Milonga para enriquecer
los metadatos).
Ciclo de tanda
La tira del carrusel en la parte superior de la pantalla muestra la posición actual en el ciclo de tanda. La secuencia por defecto es:
Tango · Tango · Vals · Tango · Tango · Milonga
En Configuración → Evento, en la tabla Ciclo de tanda, puedes añadir géneros (Tango, Vals o Milonga), eliminar entradas y reordenar arrastrando.
Detección de cortinas — una pista se trata como cortina (y el ciclo avanza) cuando:
- su título lleva un marcador de cortina (prefijo
C-,***o una secuencia de guiones al inicio), o - no se encuentra ninguna coincidencia en la base por encima de la puntuación mínima.
La Cumparsita — por tradición la milonga cierra con La Cumparsita. Cuando el título de una pista identificada es exactamente La Cumparsita, el carrusel entra en su estado de cierre Cumparsita. Esto se puede desactivar en Preferencias → Coincidencia para los DJ que tocan la pieza en medio del evento (ver más abajo).
Coincidencia
En Preferencias → Coincidencia:
| Ajuste | Por defecto | Descripción |
|---|---|---|
| Puntuación mínima de coincidencia | 68 | Umbral de coincidencia difusa (0–100). Las pistas con puntuación inferior se tratan como cortinas. Valores más bajos aceptan coincidencias más débiles; valores más altos son más estrictos. |
| Tratar «La Cumparsita» como tanda de cierre | activado | Marca una La Cumparsita identificada como tanda de cierre para que el carrusel entre en su estado Cumparsita. Desactívalo para tratarla como un tango ordinario. |
| Aprender de las correcciones | activado | Carga tu biblioteca personal de ortografías y grabaciones aprendidas, de modo que las pistas que has confirmado antes se resuelven instantáneamente y el motor mejora con el tiempo. |
El motor clasifica la cadena del DJ en campos tipados (título, orquesta, cantantes, fecha, duración), corrige la ortografía según listas de nombres curadas, y puntúa las grabaciones candidatas — favoreciendo la que coincide con más campos. Todo el índice de búsqueda se carga en memoria al inicio para una coincidencia rápida.
Base de datos
Por defecto, Milonga busca recordings.db en su directorio de soporte de aplicación. En
Preferencias → Base de datos puedes apuntar a un archivo diferente.
La base de datos incluida contiene aproximadamente 45 000 grabaciones de tango:
| Género | Grabaciones |
|---|---|
| Tango | 37 580 |
| Vals | 4 505 |
| Milonga | 3 139 |
Opciones de visualización
En Preferencias → Visualización puedes:
- Configurar la Carpeta de imágenes de orquesta y la Opacidad de la imagen que alimentan el panel Carátula — la carátula que se muestra detrás de la pista (ver La ventana de visualización → Carátula).
- Definir reglas de transformación de texto aplicadas al título de la pista y al nombre de la orquesta antes de mostrarse.
Los paneles en sí se organizan en la pestaña Configuración → Disposición.
Archivos de sesión
En Preferencias → General puedes elegir la carpeta donde se graban y se leen los historiales de sesión. Déjala en blanco para usar la predeterminada (las sesiones nuevas se graban localmente, las sesiones pasadas en Documents/Milonga Sessions). Ver Registro y estadísticas.
Idioma
La interfaz está disponible en inglés, francés y español. En Preferencias → General, selecciona Predeterminado del sistema para seguir la configuración regional del sistema operativo. Se necesita reiniciar tras cambiar el idioma.
Disposición
Los cinco paneles de la visualización se pueden reposicionar y redimensionar en la pestaña Configuración → Disposición, y guardar como ajustes con nombre. Las coordenadas se almacenan como fracciones (0.0–1.0) de la ventana de visualización, por lo que la disposición escala correctamente a cualquier resolución. El Zoom de texto (10–150 %, por defecto 75 %, en Configuración → Visualización) escala el panel de información de la pista independientemente de la disposición.