Bitwig

At a glance

• Integration: native, through the Gooroo Controllers Bitwig extension. GoorooLink is not required.
• Features: song list, setlists, transport, autonext, autostop, loop, redundancy.
• Needed: the Bitwig extension (see Covered versions).

Setup

Add the Bitwig extension on macOS

Unzip the extension folder into /Users/<username>/Documents/Bitwig Studio/Extensions.

Add the Bitwig extension on Windows

Unzip the extension folder into <username>/Documents/Bitwig Studio/Extensions.

Load the extension in Bitwig

1. Connect the LIOBOX² to the computer and start Bitwig.

2. In File → Settings, select Controllers.

   

3. Select Add Controller, and look for Gooroo Controllers in the Hardware Vendor list.

   

4. Choose whether the LIOBOX² takes the Master or Spare role and click Add.

   

5. Assign the MIDI IN and MIDI OUT of the extension to the LIOBOX² MIDI ports, and make sure the extension is enabled.

   

The extension works the same way in Mix and Arrangement view.

Script advanced features

The Bitwig script supports advanced features:

1. Autonext: a marker that asks the LIOBOX² to launch the next song. The command is executed by the LIOBOX².
2. Autostop: a marker that stops playback.
3. Loop

Autonext

Autonext sends a "Next" request that launches the next marker of the LIOBOX² (not the next marker of the session).

To use this feature, add a (NEXT) marker in your session. The command is executed when the playhead passes over it.

Autostop

Similarly, the "Stop" marker triggers a STOP in Bitwig itself (not from the LIOBOX²).

To use this feature, simply add a (STOP) marker in your session. The command is executed when the playhead passes over it.

Loop

LOOP markers automate the Bitwig loop section:

• (LOOP): creates a 4-beat infinite loop
• (LOOP X): creates an infinite loop of X beats
• (LOOP X // Y): creates a loop of X beats that repeats Y times and then deactivates

Loops can also be created on the fly from the LIOBOX², see Loop on-the-fly.

Loop on-the-fly

The LIOBOX² pads can control the Bitwig loop:

• Loop in: sets the loop start marker. The marker is set to the previous bar/beat.
• Loop out: sets the loop end marker. The marker is set to the next bar/beat.
• Loop in/out: alternates between the two. If loop in was set, the next press sends loop out, and the other way around.
• Loop on/off: turns the loop on or off.
• Loop create X: creates a loop of a predefined length of X beats (X from 1 to 127).

note

Loop out always turns the loop on once it is created. When the playhead reaches the loop end marker, it jumps back to the loop start marker, and keeps looping until you turn the loop off.

Assign these features to pads in Pad config. By default, "Loop In" snaps to the closest previous bar. You can change this to beat in the advanced settings.

LIOBOX² modes

Select the BITWIG mode in MENU → MODE.

All tracks mode

Switch to ALL TRACKS mode from the Mode menu.

Ableton	Reaper

ALL TRACKS mode gives access to all the songs of the DAW session, in session order, so you can move to and launch any song of your set.

If Error on duplicate track is enabled, the LIOBOX² checks the song names and warns you when two songs (scenes/locators) have the same name, so you can correct them.

Setlist mode

SETLIST mode lets you choose and reorder the songs: the LIOBOX² only displays the songs of the show's setlist, in the order you want. All this without modifying the DAW session or touching the computer.

Setlists can be renamed and are saved in the internal memory of the LIOBOX².

Switch to Setlist mode from the Mode menu:

Ableton	Reaper

Setlist creation

To create a setlist, select + ADD [MODE] SETLIST in MENU → SETLIST. First select the mode (Bitwig) in MENU → MODE.

The first letter of the mode (A/B for Ableton/Bitwig, R for Reaper, …) is added at the start of the setlist name, to show which mode it belongs to.

As songs are added, the total duration is displayed at the top of the window, next to the setlist name.

Add songs to the setlist

Once the setlist is created, you can add songs. The song list is loaded directly from the active Bitwig project.

To add a song, open the setlist, select MODIFY, then + ADD TRACK. The list of loaded songs appears: click a song to add it. The same song can be added several times.

The duration of each song is shown next to its name (it comes from the song title, see the naming convention).

Setlist menu	Setlist / MODIFY menu	ADD TRACK menu	Setlist / MODIFY menu

Songs already in the setlist appear in green.

Manage and load setlists

A setlist can be renamed (12 characters maximum), duplicated and modified at any time. See Setlists.

If a song in the loaded setlist is not present in the DAW session, it is displayed in red on the Play screen. Up to 9 setlists can be created.

To use a setlist, select SETLIST mode in the MODE menu and load the setlist.

The setlist name appears in red on the Play screen if the loaded setlist's mode is different from the active mode.

Track position in session/setlist

The position of the current song in the session or setlist is constantly displayed at the top of the screen.

Track naming convention

The LIOBOX² can display the BPM, key and duration of each song. Enter them in the song name using this naming convention:

song_name ; bpm ; key ; duration

• Write the duration as mm:ss.
• If you do not need a value, leave the field empty and omit the ;.
• To keep a song from being sent to the LIOBOX², start its name with (). Example: ()song number 1.

Compatible characters

The following characters are compatible with the LIOBOX². Any other character is filtered out.

• Upper case: A to Z
• Numbers: 0 to 9
• Parentheses: ( )
• Square brackets: [ ]
• Hashtag: #
• Ampersand: &
• Plus: +
• Slash: /
• Space

Names that are not transmitted

A name starting with one of the following is not transmitted to the LIOBOX²:

• ()
• []
• (LOOP
• _
• **
• >
• >>
• +
• LOOP

The following marker names are also filtered out from the marker list received by the LIOBOX²:

• AUTOSTOP
• (STOP)
• (NEXT)
• STOP
• SONG END
• PLAYNEXT
• STOPBOT
• EASY LOOPER
• NEXTCUE

Pad features

Pads can be reassigned from MENU → PAD CONFIG (see Pad config). In Bitwig mode, the following features are available:

• NONE
• PLAY LIOBOX MARKER
• PLAY (TRANSPORT)
• PAUSE
• STOP
• PREV LIOBOX MARKER
• PREV MARKER (TRANSPORT)
• FAST-REWIND
• RESTART MARKER
• NEXT LIOBOX MARKER
• NEXT MARKER (TRANSPORT)
• FAST-FORWARD
• LOOP IN/OUT, LOOP IN, LOOP OUT, LOOP ON/OFF, LOOP CREATE X
• CUSTOM MIDI

Notes:

• Play or Play (Transport) corresponds to the DAW Play.
• Play LIOBOX Marker plays the next song.
• Fast-Rewind and Fast-Forward can only be assigned to the Long press pad event.
• Next or Prev Marker (Transport) corresponds to the DAW Next event (next/previous in the project).
• Next or Prev LIOBOX Marker selects the next or previous marker from the setlist.
• The loop features are described in Loop on-the-fly.

Bitwig shares its pad memory with Ableton: a pad assignment made in one mode also modifies the assignment in the other.

Redundancy

On the second computer, choose the Spare role when adding the controller (step 4 above). The LIOBOX² compares the song lists of the Main and Spare computers to ensure that the sessions are identical. See Redundancy.

Troubleshooting

If the LIOBOX² does not show the green check icon or the song names, see Troubleshooting.