Installation

Milonga ships as a self-contained application. No Python installation or dependencies are required.

macOS

1. Download Milonga.zip from the Download page.
2. Double-click the archive to unzip it.
3. Drag Milonga.app to your Applications folder.
4. Double-click to launch.

macOS Gatekeeper warning — Apple requires developers to pay a $99/year fee to obtain a notarization certificate. Milonga is a free application developed by a volunteer with no intention of charging anyone, so this fee will not be paid. As a consequence, macOS will refuse to open the app on the first launch and display a warning about an "unidentified developer." This is Apple's policy, not a problem with the application.

To open it anyway: go to System Settings → Privacy & Security, scroll down to the Milonga entry, and click Open Anyway. You will be asked once — macOS remembers your choice for all future launches.

Requires macOS 12 Monterey or later — Intel and Apple Silicon.

Windows

1. Download Milonga-windows.zip from the Download page.
2. Unzip the archive. (If Windows blocks it, right-click the .zip → Properties, tick Unblock at the bottom, then unzip.)
3. Open the unzipped Milonga folder and run Milonga.exe.

Keep the whole folder together. Milonga.exe relies on the _internal folder next to it — move or copy the entire Milonga folder, not just the .exe. You can put it anywhere (Desktop, Documents, even a USB stick).

The app is not code-signed, so on the first launch Windows SmartScreen may show "Windows protected your PC." Click More info → Run anyway. This only happens the first time.

Some antivirus programs mistakenly flag self-contained apps like this one. Milonga is safe; if it is quarantined, restore it and allow Milonga.exe.

Requires Windows 10 or later (64-bit).

First launch

Milonga opens two windows:

Open Preferences → Milonga event and fill in your DJ name, venue, and milonga name. Then go to the Listeners tab and select your DJ application.

Next: Quick start