Guide

Troubleshooting

The display never updates

  1. Check the listener status dot in the control window — it must be green (● Running). If it is grey, click Start.
  2. Traktor: verify that traktor-nowplaying is installed and that the port matches the broadcast settings in Traktor.
  3. VirtualDJ: verify that VirtualDJ is open and has played at least one track in the current session (the history file is created on the first play).
  4. Hover the red ● Error dot, if shown — the tooltip carries the exact error.

"traktor_nowplaying appears to already be running"

In broadcast mode Milonga runs a small helper process on the broadcast port. If a previous session did not exit cleanly, the port stays occupied.

  • Answer Yes to the prompt and Milonga terminates the stale process for you.
  • If the port is still busy afterwards, another application is using it — change the port in Preferences → Listeners → Broadcast port (and in Traktor's broadcast settings to match).

If Traktor itself reports the port busy ("Address already in use"): turn off the broadcast in Traktor (the flashing antenna icon), quit Milonga, wait a few seconds, and relaunch.

"Database empty" warning at startup

Milonga could not find recordings.db. If you have pointed Preferences → Database at a custom file, check the path; clear it to fall back to the bundled database.

A track shows as a cortina but is a real tango

The match did not clear the minimum score — common with heavily abbreviated titles.

  • Open the History tab: if the right recording is in the candidate list, click it to display it now. With learning enabled, that decision is remembered.
  • If it happens often, lower the minimum match score slightly in Preferences → Matching (try 60), or enrich the input side — see Giving the matcher more to work with.

The wrong recording is displayed

Click the correct candidate in the History tab to fix it live. Milonga favours the interpretation matching the most fields, so adding orchestra/singer information in your DJ library tags is the durable fix.

The display opened on the wrong screen

Use ◄ Prev Screen / Next Screen ► in the control window. The buttons are enabled whenever more than one screen is connected. The position is saved for next time.

macOS: "Milonga can't be opened"

The app is not notarised. Open System Settings → Privacy & Security, scroll down, and click Open Anyway. This is needed once per installation.

The interface is in the wrong language

Preferences → Language — pick English, Français, or Español (or System default), then restart the application.