White Cat lighting board

White Cat Lighting Board Documentation

Outils pour utilisateurs

Outils du site



Open the Audioplayers window:

  • Click audioplayers or type Cntl-A



White Cat contains 4 internal audio players.

White Cat connects itself automatically to your sound card. It works uniquely with stereo output. Audio players are incorporated into White Cat for basic usage: no multicast with multichannel external card. If you need a real multicast, free software like Usine or SeqCon will take care of this. They are remote controllable in midi.

Files formats that can be read are MP3 and WAV.

The 4 players may be controlled by the mouse, in midi, and by a banger.

Audio files need to be placed in a folder you will create inside the whitecat/audio/ folder. Each folder may contain 127 audio files.


  • Audiofilename can't include SPACES or ACCENT MARKS or SPECIAL CHARACTERS in their names.
  • Same restriction for the audio folder you will create
  • Files read can only be .wav or .mp3.
  • Time positions displayed on screen of the audio file will not be correct if the audio file format is not 44100Khz.
  • There is no playlist. You must put the files in the correct order.

the 4 Audioplayers

On the left are the 4 audio players, on the right is the content of the default audio folder: Audio/Demo/. Below is the section [Affect to dock] that enables you to remotely control audio sliders with Faders on the Fader panel.


Contents of an Audioplayer


Commands will be performed ONLY if a file is loaded inside the player.

Basic player, left side

  • File loaded inside the player
  • Play / Pause button
  • Seek to begin of the file ( 0.0 second position)
  • Loop button
  • Seek and Forward buttons
  • Previous Next Track buttons
  • Slot for num file calling
  • AutoLoad and AutoPause Modes

Cue Mode, right side

  • IN point (start point) for loop in Cue Mode
  • OUT point (end point) for loop in Cue Mode
  • CUE ON button, to trigger the loop between the two points
  • Seek to Cue IN button

Player's sliders

  • A vertical slider for the level in orange
  • A horizontal slider for the panoramique (Pan)
  • A horizontal slider for the speed (Pitch)

Those levels are represented in floating point and in the 0-127 range to facilitate recording levels inside a banger.


Managing the Audio Folder

How to create a folder containing the audio files of your show

the windows explorer, go to the white_cat/audio folder.

Do a right click, select “New” and choose “Create Folder”.

Give a name to this folder, without accent marks, without spaces, and without special characters.


Copy/Paste your audio files with the mouse, all in the same format (WAV or MP3), and at the same speed (44100 Khz).


This is the structure you will have:


When saving, the name of the audio folder you are currently working with will be saved and reloaded on opening again.

Pointing to the audio folder

  • In White Cat, call the Text window by clicking [NAME] or pressing [F5]
  • type the name of an existing audio folder, without spaces or accent marks in its name
  • click the red button of the audio folder assignment.


Refreshing an audio folder's content

During creation, it is possible to add audio files inside your audio folder. Despite closing White Cat and reopening it, click [rescan].

Loading a file inside a player

  • Select the audio file by clicking it inside the list of files
  • It will appear outlined in red
  • Click the player file space to load it inside


Please note that a number appears in front of each file name ( 1 / 2 / 3 …. ) Those are the indexes that you will use when you call a file through a banger. You will assign to the banger a value ( 1/ 12/ or 44/ …), not a file name. The index is assigned based on the alphabetic order of the audio files when a scan is done.

So you have to be very careful about the names you give to audio files.

For the moment this is the way it is, a little bit constraining, I know. As banger handling is based on this index, which is the position inside the audio folder (position 1, position 2, position 3, … ), be extremely careful if you are using bangers and you insert new files: because you may offset all your banger audio programming.

Sound file organization and renaming

Generally, when the order of audio files is set for the show, before recording bangers for your cues, you will need to edit the audio files manually to create a logical order of the various files:

alleluia.mp3 is in position 1, but it is the 3rd file that needs to be read

bicylette.wav is in position 2, but it is the 1st file that needs to be read

zoorhapsodie.mp3 is seen in 3rd place, but its order should be second

You should then edit names of audio files, adding a number, with the windows explorer (right click on the file > rename):




To clear a player's content, click it without selecting a file.

General looping of a file and Cue Mode


Loop button sets the player in loop mode.

If CUE Mode is off, this loop will be done on ALL of the file (from its beginning 0.0s until its end).

Checking CUE Mode, you can use specific IN and OUT points for the loop.

To define a Cue inside for an audio file:

  • click [EDIT]
  • play your file or use Seek / Forward / Pitch, until you are on the point
  • click IN or OUT to define the Cue IN or Cue OUT point
  • time positions of those two points are displayed on screen
  • if IN is greater than OUT, OUT will be redefined
  • if OUT is less than IN, OUT will be redefined

A SeekCue button enables you to seek to the IN point. (The general Seek button will rewind to beginning of the file, in 0.0s)



AutoLoad and AutoPause Modes

There is no Playlist per player in WhiteCat.

But you can decide that a player may continue reading tracks, like a classical CD player.

  • AutoLoad (left button) enables to load next track automatically when file readed is finished, and when the Loop is not ON.
  • AutoStop stops the reading at the end of the file.

Using the two, give you exactly the AutoPause mode on CD players.

Suggestion: to create playlists for your show you can rename your files A_1_name A_2_name… where A is the player (A B C D).


Volume, Pan and Pitch manipulation

  • manipulate level with the mouse
  • first calibrate the audio output from windows, to insure you have a good signal, without too much noise
  • level is also expressed on a 0-127 scale for banger encoding convenience

For Pan, 0 is on left, 64 in middle, 127 on right. Pitch from 0 to 63 is slow speed, 65 to 127 is accelerated speed, a normal speed is 64.


Volume / Pan / Pitch MidiSendOut

By checking the midi send (red button hanging off the volume slider), you will transmit through the midi output to other software or hardware the midi signal assigned to Volume, Pan and Pitch.

This function enables certain motorized midi surfaces (BCR / BCF / DM1000, etc…. ), to refresh the physical faders' state when a manipulation is done by the mouse or with a banger.


Midi Assignment

Play / Seek / Loop , SetIN, SetOUT, CUE ON-OFF, SeekToCueIn, Volume, Pan, Pitch are remote controllable in midi.

Be aware you can't assign the audio commands in a serial manner. They are assigned solo.

To assign a midi signal:

  • Go to [MIDI CFG]
  • Select [Midi Affectation]
  • Move a fader, or a knob which emits a Ctrl-Change signal
  • Move your mouse over the player command (it will be outlined in red)
  • Click to assign it


More details here: Midi Configuration and Midi Assignments

audio_eng.txt · Dernière modification: 2014/11/26 21:56 par