Quick start

Follow these steps in order to go from the box to your first song launched from the LIOBOX². Each step links to the detailed page if you need more.

What you need

• The LIOBOX² and the USB cable provided.
• Your DAW installed on the computer. Ableton, Bitwig and Reaper work on macOS and Windows.
• A Mac with an internet connection for GoorooLink. GoorooLink is required for Pro Tools, Logic Pro, Cubase and QLab, and recommended for the other DAWs (firmware and script updates).

1. Connect the LIOBOX²

1. Plug the LIOBOX² into the computer with the cable provided.
2. On macOS, click Allow when the computer asks "Allow accessory to connect?". If Don't Allow was clicked by mistake, see LIOBOX² not detected.

To learn the pads, the knob and the ports, see the LIOBOX² description.

2. Install GoorooLink (Mac)

1. Open the .dmg file and drag the GoorooLink shortcut to the Applications folder.
2. Launch GoorooLink and grant the macOS permissions it asks for (App Management and Files & Folders).

Details: Install GoorooLink.

3. Update the firmware

Always start from the latest firmware.

1. Connect the LIOBOX² directly to the Mac, on its USB B port (the one recognized as "Liobox SPARE"), with no USB hub in between. Only this port allows a firmware update.
2. In GoorooLink, open DEVICE → DEVICES and select your LIOBOX² in the Known Devices list.
3. In the Device update section, keep the Auto mode and click Download if a newer firmware is proposed.
4. Click Start Firmware Update. The update takes between 10 and 20 seconds.

danger

Do not disconnect the LIOBOX² or let the computer go to sleep during the update.

If the update fails or hangs, see Firmware update problems. The full procedure is in Device update.

4. Set up your DAW

Select your DAW for the short version of its setup, then follow the link to its complete guide.

Ableton

1. Copy the LIOBOX² script folders matching your Ableton version into Ableton's MIDI Remote Scripts folder (GoorooLink can do it for you).
2. Connect the LIOBOX² and start Ableton.
3. In Options → Settings → Link, Tempo & MIDI, pick the Liobox script in a Control Surface slot and assign Liobox Port 1 to Input and Output.

Complete Ableton guide

Bitwig

1. Unzip the Gooroo Controllers extension into Documents/Bitwig Studio/Extensions.
2. Connect the LIOBOX² and start Bitwig.
3. In File → Settings → Controllers, Add Controller, choose Gooroo Controllers, pick Master and assign the MIDI IN and OUT to the LIOBOX² ports.

Complete Bitwig guide

Reaper

1. Install the SWS/S&M extension.
2. In Options → Preferences, apply the settings listed in the guide, and enable the LIOBOX² MIDI input and output.
3. In the Reaper Actions list, load LioboxMaster.lua with New action… → Load ReaScript… and run it (it can also run at startup).

Complete Reaper guide

Pro Tools

1. In GoorooLink, open APP → BRIDGE, select Pro Tools and your LIOBOX². Keep GoorooLink running.
2. In Pro Tools, enable the Gooroo Bridge ProTools MMC MIDI input, set the MTC Generator Port to Gooroo Bridge ProTools MTC, and enable MIDI Machine Control Remote with ID 127.
3. Make sure every marker's reference is Absolute.

Complete Pro Tools guide

Logic Pro

1. In GoorooLink, open APP → BRIDGE, select Logic Pro and your LIOBOX². Keep GoorooLink running.
2. In Logic Pro, enable the Gooroo Bridge Logic MMC MIDI input and activate MTC and MMC synchronization in the project settings.
3. Copy the Logic Pro marker list and import it in GoorooLink with Import Markers.
4. Deactivate Play from Cycle.

Complete Logic Pro guide

Cubase

1. In GoorooLink, open APP → BRIDGE, select Cubase and your LIOBOX². Keep GoorooLink running.
2. In Cubase, configure the Gooroo Bridge MMC input (device ID 127) and MTC output, and set the Timecode Source to Internal Timecode.
3. Export your markers (MIDI file or Selected Tracks file) and load them in GoorooLink with Load Marker File.

Complete Cubase guide

QLab

1. In GoorooLink, open APP → BRIDGE, select QLab and your LIOBOX². Keep GoorooLink running.
2. In QLab, open File → Workspace Settings → Network → OSC Access, allow OSC connections with "No Passcode" and keep the port 53000.

Complete QLab guide

MIDI

1. Connect the LIOBOX² to your DAW or instrument over USB.
2. Assign each pad a Custom MIDI Note, Control Change or Program Change in MENU → PAD CONFIG.

Complete MIDI guide

5. Select the mode on the LIOBOX²

1. Press the MENU pad (E) and choose MODE.
2. Select the mode of your DAW (for example ABLETON, PRO TOOLS or QLAB) and the ALL TRACKS list.

The LIOBOX² screen shows a green check mark once it communicates with the DAW (a red cross means the DAW or the script is not started). See Connection status.

6. Play

• Turn the knob to select the next song and click it to launch it.
• Pad A plays, B rewinds or goes to the previous song, C forwards or goes to the next song, D pauses.
• Pad F changes the pad bank, pad E opens the menu.

Song names, BPM, key and duration come from your project: see the track naming convention in the guide of your DAW.

Next steps

• Build a show with setlists: reorder songs without touching your project.
• Reassign the pads in Pad config.
• Add a second computer for redundancy.
• Something does not work? See Troubleshooting.