Getting Started

System requirements

macOS 13 Ventura or later
An external monitor for the dancer display (optional but recommended)
Music.app — only required when using the Music.app, Swinsian, or Embrace player sources. Not needed with the built-in player.

Go to the Releases page
Download TangoDisplay-v3.8.0-universal.zip
Unzip and drag TangoDisplay.app to /Applications
Right-click › Open on first launch — macOS will warn that the app isn't notarised; click Open to proceed

You need Xcode Command Line Tools (xcode-select --install).

git clone https://github.com/richardsladetdj-creator/TangoDisplay.git
cd TangoDisplay
./Install.sh

Install.sh builds a release binary, assembles the .app bundle, code-signs it, and installs it to /Applications.

When TangoDisplay starts it appears as a small display icon in the menu bar.

Click the icon to reveal the menu:

Show Display Window — brings the presentation window to the front
Show Settings Window — opens the main control window
Show Setlist — opens the control window and jumps directly to the Setlist tab
Quit TangoDisplay — exits the app

macOS may ask for up to two permissions depending on which features you use:

Permission	When	Why
Automation › Music	First poll (Music.app, Swinsian, or Embrace sources only)	TangoDisplay reads the currently playing track, artist, genre, playlist position, and upcoming tracks via AppleScript. Not required when using the Built-in Player.
Input Monitoring	First hotkey use	Required so global keyboard shortcuts (`⌘⇧O`, `⌘⇧P`, `⌘⇧R`) work while other apps are in focus.

To grant Input Monitoring manually: System Settings › Privacy & Security › Input Monitoring → enable TangoDisplay.

If Input Monitoring is denied, hotkeys silently do nothing. All other features work normally.