Get started
You need a Mac with macOS 11 or newer and Ableton Live 11 or 12 (Intro, Standard or Suite).
- Install. Quit Live, open the download and double-click SongHunt 2 Installer.pkg. If your Mac says it can't be opened, open System Settings › Privacy & Security, scroll down and click Open Anyway.
- Activate. The Activate SongHunt 2 window opens. Paste the licence key from your Gumroad receipt and click Activate. You need the internet once; after that it works offline. A key works on 2 Macs.
- Turn it on in Live. Open Live › Settings › Link, Tempo & MIDI. In an empty Control Surface slot choose SongHunt2, with Input and Output set to None.
- Your songs. SongHunt 2 can find your songs from your scene names: click Find my songs, tick the songs, done. Or name a track Song List and give each song's clip a
> in front, like >September.
- Open SongHunt. Click the SongHunt icon in the menu bar › Open SongHunt. The light at the bottom left says Live linked.
Soundcheck: the two lights at the bottom left tell you Live is linked and is running the newest SongHunt script. Click them for details.
Phones and tablets
Any phone or tablet with a web browser works: iPhone, iPad, Android, Surface. It must be on the same Wi-Fi as the Mac. No app to install, no internet needed.
There are two QR codes, in the SongHunt 2 status window and under ⋯ More › Connect:
MD code
Full control: pick songs, launch, stop, loop, tempo, mixer, band messages. For you, the musical director. Up to two MD screens at a time.
Band code
View only, for the players. Each player picks their part (Vocals, Keys, Guitar…) and sees their own charts. The Band code can never sign in as MD.
- Point the phone's camera at the code and tap the link. When both codes are on screen, cover the one you don't want.
- The phone remembers it. Next time it opens straight away, also from a Home Screen icon.
- No camera? Type the address shown under the codes and the PIN.
Switching: scanning a code again starts fresh and asks Whose charts? again. To change your part, tap the part name at the top of the screen.
Running the show
On the Mac, or on your phone with the MD code.
- Type
- Search. Typos are fine: "dont" finds "Don't".
- Enter
- Picks the song: Live jumps to its row.
- ↑ ↓
- After a pick: steps through the song's sections (Intro, Verse, Chorus…). The one that's next shows READY.
- Enter again
- With Enter Launch on: plays what's READY.
- Space
- With Enter Launch on, in the empty search: stops Live.
- Loop: the ⟳ on a section keeps it going. Press Enter to go on to the next section, timed by Live.
- Tempo: the arrows next to BPM change Live's tempo for this song while it plays. Nothing is saved.
- Click: Live's metronome on / off.
- Message (the envelope): sends "Repeat", "Last time", "Next song: …" or your own words, big on the band's screens. Pick Everyone or one part. ✎ Edit buttons makes your own list.
- Band Ready?: shows at the bottom left once a band screen is connected. Every player gets a big "I'm ready" button; you see who's ready.
- Notes: pick a song and type in its Notes box. It saves by itself.
- Arrangement: switch to Arrangement to run a show laid out on Live's timeline.
For the band
- Scan the Band code and pick your part.
- Your chart follows the song Live is playing, section by section. The words stay still until the MD presses play.
- Scroll rolls the words by itself at the speed you choose. Full screen shows only the words.
- Bigger or smaller text with A− / A+. Search any line of any song.
- Your own note per song ("Capo 2", "Patch 14") with the Note button.
- The MD's messages pop up big for 8 seconds. Tap to close.
Lyrics and charts
Every part has its own charts. A song's file or note name is the song's name, spelled as in the show. Section names in square brackets, like [Verse 1] and [Chorus], let the words follow the band.
SEPTEMBER
[Verse 1]
Do you remember…
[Chorus]
…
On the MD's Mac, for everyone
Shared lyricsPut text or PDF files in Documents › SongHunt Charts › Lyrics (September.txt), or notes in the Mac's Notes folder SongHunt Lyrics. Every player sees them unless they have their own.
iPhone or iPad: from Notes
Private to that deviceKeep one note per song in a Notes folder SongHunt Lyrics. In SongHunt: chart › Edit › Load all my songs from Notes › Get the Shortcut (once). Then run the Shortcut, paste, Load.
Surface or PC: Word files
Private to that deviceChart › Edit › Load my lyric files (Word / text), select all files (Ctrl+A). One file per song, or one big file with each title as a heading. Save old .doc files as .docx first.
Paste, PDF or photo
Any deviceChart › Edit: paste the words, or Add a PDF or a photo. Use Mark sections to tell it where each part starts.
The Notes Shortcut, step by step
- In Notes, make a folder SongHunt Lyrics with one note per song. The note's first line is the song's name.
- In SongHunt: open the chart, tap Edit › Load all my songs from Notes › Get the Shortcut, then Add Shortcut. Pick your SongHunt Lyrics folder if it asks.
- Whenever your lyrics change: run SongHunt: copy my lyrics, come back to SongHunt, tap Load all my songs from Notes, hold in the box, Paste, Load.
Private lyrics stay in that phone's browser and are never sent to the Mac. Clearing Safari's website data removes them: load them again from Notes or your files.
Coming from SongHunt 1
- Your songs (tempo, time signature, notes) come over by themselves the first time SongHunt 2 runs.
- Your playlists live inside your Live Sets. Open PLAYLIST and click ⇣ From SongHunt 1 and pick a Live Set (.als). Its playlists come over with all their songs.
- SongHunt 1 keeps working. Both can be installed at the same time.
Updates
- Download the new version from your Gumroad Library.
- Quit Live and run the installer. SongHunt 2 closes and opens again by itself.
- Open Live again, so it loads the new SongHunt script.
The version is shown under the SongHunt logo. Your songs, playlists, charts and activation are kept.
If something's wrong
It says "Live disconnected" or "Not connected"
Live hasn't answered for 3 seconds. Check Live is open and SongHunt2 is chosen as a Control Surface (Settings › Link, Tempo & MIDI). If you just installed an update, quit and reopen Live.
SongHunt2 isn't in Live's Control Surface list
Quit Live and double-click Fix SongHunt 2 Control Surface.command from the download. This often happens when Live's library is on an external drive, or Live points at another user's library: check Live › Settings › Library.
A phone can't connect
The phone must be on the same Wi-Fi as the Mac, and SongHunt 2 must be open on the Mac. If the name address doesn't open, use the number address shown under the QR codes.
A band member signed in as MD
They scanned the MD code. Ask them to scan the Band code instead: it asks for their part and can't control the show.
Band Ready isn't showing
It shows once a band screen is connected: a phone or tablet that scanned the Band code and picked its part.
The version under the logo didn't change after updating
The old SongHunt 2 was still running. Click the SongHunt icon in the menu bar › Quit, then open SongHunt 2 again. Installers from 2.0.22 do this for you.
A phone says "SongHunt 2 isn't activated yet"
Activate SongHunt 2 on the Mac: menu bar SongHunt icon › Activate SongHunt 2, paste your key. Then reload the phone's page.
Lyrics show for the wrong song, or not at all
The note or file name must match the song's name in the show. "Not in tonight's Set" lists the ones that don't: rename them and load again.
Still stuck?
Write to songhuntplugin@gmail.com with a photo of the screen. We reply fast.