Skip to content

Getting Started

Jump to bottom
richardsladetdj-creator edited this page Apr 26, 2026 · 8 revisions

Getting Started

System requirements

  • macOS 13 Ventura or later
  • Music.app running with a named playlist
  • An external monitor for the dancer display (optional but recommended)

Installation

Option A — Download (easiest)

  1. Go to the Releases page
  2. Download TangoDisplay-v1.6.0.zip
  3. Unzip and drag TangoDisplay.app to /Applications
  4. Right-click › Open on first launch — macOS will warn that the app isn't notarised; click Open to proceed

Option B — Build from source

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.

First launch

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

Menu bar icon

Click the icon to reveal the menu:

Menu bar menu

  • Show Display Window — brings the presentation window to the front
  • Show Settings Window — opens the main control window
  • Quit TangoDisplay — exits the app

Permissions

macOS will ask for two permissions on first use:

Permission When Why
Automation › Music First poll TangoDisplay reads the currently playing track, artist, genre, playlist position, and upcoming tracks via AppleScript
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.

Next steps

Clone this wiki locally