Guía

Configuración

Todos los ajustes se almacenan en un archivo TOML y se editan a través de Preferencias en la ventana de control. No necesitas editar el archivo manualmente.

El diálogo de Preferencias

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

Evento milonga

Ajuste Descripción
Nombre del TDJ Mostrado en el bandeau 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 a [Lugar].
Nombre de la milonga Usado con el nombre del DJ: Esta noche para la [Nombre de la milonga] damos la bienvenida a [Nombre del TDJ].

Fuentes

Fuente activa — elige Traktor o VirtualDJ en el selector de la ventana de control. Solo una fuente funciona a la vez.

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 en la ventana de control para empezar a escuchar.

En Preferencias → Fuentes → Traktor, puedes ajustar el puerto y, opcionalmente, indicar a Milonga la ubicación de tu colección Traktor exportada (ver Dar más información al motor).

VirtualDJ

Cuando seleccionas VirtualDJ en el selector de fuente, Milonga se inicia automáticamente — no se necesita botón Iniciar. Vigila el archivo de historial diario de VirtualDJ (History/YYYY-MM-DD.m3u en el directorio de datos de VirtualDJ) usando el sistema de archivos y recoge cada nueva pista en cuanto se escribe.

En Preferencias → Fuentes → VirtualDJ puedes consultar las rutas autodetectadas para el directorio de historial y tu database.xml (la base de datos local de pistas de VirtualDJ, leída por Milonga para enriquecer los metadatos).


Ciclo de tandas

La tira del carrusel en la parte superior de la pantalla muestra la posición actual en el ciclo de tandas. La secuencia por defecto es:

Tango · Tango · Vals · Tango · Tango · Milonga

En Preferencias → Ciclo de tandas 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 guiones al inicio), o
  • ninguna coincidencia en la base supera 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. Puede desactivarse en Preferencias → Correspondencia para los DJ que la tocan en medio del evento (ver más abajo).


Correspondencia

Ajuste Por defecto Descripción
Puntuación mínima de correspondencia 68 Umbral de correspondencia 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 el estado Cumparsita. Desactívalo para tratarla como un tango ordinario.
Aprender de correcciones activado Carga tu biblioteca personal de ortografías y grabaciones aprendidas: las pistas ya confirmadas 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 correspondencia rápida.

Las pistas resueltas por prefijo de confianza (nombres en estilo lista como 1V-Troilo - Ruiz - Flor de Lino) también se guardan automáticamente en una base personal learned_recordings.db en la carpeta de datos de Milonga. Esta base crece con el tiempo y proporciona al motor general grabaciones adicionales — útil cuando una grabación no está en la base principal.


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

Fuente: tango.info.


Idioma

La interfaz está disponible en español, inglés y francés. Selecciona Idioma del sistema para seguir el idioma del sistema operativo. Se necesita reiniciar tras cambiar el idioma.


Disposición

Los cuatro paneles de visualización se pueden reposicionar y redimensionar usando el editor de disposición en la ventana de control. 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 %) escala el panel de pista independientemente de la disposición.