Desktop app · Free beta

Download Light Helper AI

The desktop app measures the beat grid, bars and sections of a track, puts the cues on a timeline you can edit, and sends them to grandMA2 over the network. The beta is free; you sign in with your Telegram account.

Version 0.3.0

Windows Windows 10 or 11, 64-bit .exe Your system macOS macOS 12 or later, Intel and Apple silicon .dmg Your system Linux 64-bit, AppImage .AppImage Your system
The beta builds are not signed yet. Windows and macOS will warn you the first time you open the app. The steps below show how to open it anyway. Download the app only from this page.

Install

Windows

  1. Run LightHelperAI-…-win-x64.exe.
  2. If you see Windows protected your PC, click More info, then Run anyway.
  3. Choose the install folder and finish the installer. The app appears in the Start menu.

macOS

  1. Open the .dmg and drag Light Helper AI into Applications.
  2. Open the app. macOS says it can't check the app for malicious software: click Done.
  3. Open System Settings → Privacy & Security, scroll down and click Open Anyway next to Light Helper AI. Confirm with your password. You only do this once.

If the button doesn't appear, run this in Terminal and open the app again:

xattr -dr com.apple.quarantine "/Applications/Light Helper AI.app"

Linux

  1. Make the file executable and run it:
chmod +x LightHelperAI-*-linux-x86_64.AppImage
./LightHelperAI-*-linux-x86_64.AppImage

If it doesn't start on Ubuntu 22.04 or later, install FUSE 2: sudo apt install libfuse2t64 (on 22.04: libfuse2).

Sign in

  1. Click Log in with Telegram. The app shows an 8-character code and opens the bot @light_control_ai_bot.
  2. In Telegram press Start. Check that the code in the bot matches the code in the app, then press Confirm.
  3. The app signs you in within a few seconds. The code is valid for 5 minutes.
Only confirm codes you started yourself. If the bot shows a code you don't see in your own app, press Cancel: someone may be trying to sign in to your account.

Analyze a track

  1. Open Audio Analysis in the sidebar.
  2. Drop an audio file or click to choose one: MP3, WAV or FLAC, up to 20 MB and 10 minutes.
  3. Click Upload & Analyze. After 20–60 seconds you see the BPM, the beats, the duration and the list of sections.
Tip. Analyze exactly the file that will be played at the show. A different edit or extra silence at the start shifts every time.

Edit the cues

  1. Under the results, click Generate Timecode Cues. Each section start becomes a cue on a downbeat.
  2. Accept the cues one by one or click Accept All.
  3. On the Timeline, play the track, drag a cue when your ear disagrees, add a cue with Add Cue, and zoom in for precise placement.

Section names are suggestions. The times are what matter: rename cues as you like.

Export a macro

  1. In Macro Export, choose the console (grandMA2 or grandMA3), the frame rate, the sequence number and the fixture range.
  2. Choose the format: grandMA XML macro, plain command lines or CSV.
  3. Click Download to save the file, or Copy to paste the commands into the console command line.

To import an XML macro on grandMA2, copy it to the importexport folder (on a USB stick: gma2/importexport) and import it from the Macros pool. Check first that the sequence number is free.

Send live to grandMA2 Beta

The live link works with grandMA2 consoles and grandMA2 onPC on the same network as your computer.

  1. On the console: Setup → Console → Global Settings, set Telnet to Login Enabled.
  2. Note the console's IP address (Setup → Network). On onPC, use the IP of that computer, or 127.0.0.1 if onPC runs on the same machine.
  3. In the app, open Console Connection. Pick a console found on the network, or add a profile with the IP, port 30000 and the console user and password (by default administrator with no password).
  4. Click Connect. When the status is connected, go back to Macro Export and click Send to Console.
Try it on onPC or a test showfile first. The app types commands into the console exactly as you would: save your show before sending.

Updates

On Windows and Linux the app downloads updates by itself and installs them when you restart it. On macOS the app tells you when a new version is out, and you download it from this page.

Troubleshooting

  • Sign-in code doesn't appear. Check your internet connection and that a firewall doesn't block api.lighthelper.ru.
  • The bot doesn't react to Start. Make sure you opened @light_control_ai_bot from the app, so the message contains your code. If the code expired, click sign in again.
  • Can't connect to the console. Check that Telnet is set to Login Enabled, that the IP and port 30000 are right, and that both machines are on the same subnet.
  • Anything else. Write to the community chat: tell us your system, the app version and what you did.