Additional and Override Setup

Usine allows a special mode to create a customized setup which is read at startup and overrides the built-in setup.

Setup files in Usine are:

  • Default-setup.ini: Contains all the settings chosen by Users with the setup-panel. This file is always located in the /Config/ folder.

  • Additional-setup.ini: This optional file contains some settings that you can define for your application. All those options will override options of Default-setup.ini. The user still have access to some settings, but all Additional-setup.ini settings are loaded at the startup of Usine. This file can be anywhere in the package's folder or in the /Deploy/ folder.

  • Override-setup.ini: This optional file contains all settings of Usine and override all the settings chosen by the user. It's recommended for fixed installations where you want to prevent any setup modification. This file can be anywhere in the package's folder or in the /Deploy/ folder.

  • Override-setup.Encrypted.ini: Encrypted version of the Override-setup.ini. See bellow. This file is always located in the /Config/ folder.

Additional setup

To activate the additional setup mode add a file Additional-setup.ini anywhere in the package folder or in the /Deploy/ folder.

When an additional setup file is set, the "normal" Default-setup.ini setup is merged with the Additional-setup.ini to produce a customized version of the setup. All options contained in the Additional-setup.ini will override options Default-setup.ini.

Example of an Additional-setup used for the motion kit project:

[SETUP]
startpage logo=logo motionkit.png
splash image=progressbar motionkit.png
display range knob on tlet=0
disable draw selection square=1
disable locate audio files=1
disable warning locked objects=1
disable internet connection=1
disable upgrade message=1
application name = MotionKit
application version = 1.2
startpage items size=60

Override setup

To activate the override setup mode add a file Override-setup.ini anywhere in the package folder or in the /Deploy/ folder.

When an override-setup is configured, the built-in setup can be modified but is never saved.

[SETUP]

remote ID=A00001

:: ASIO
fullasio=1
soft clipping=1
pre-listen gain=0
...

This file contains all available settings of the traditional setup but also extra settings described bellow.

setup encrypted

The override-setup.ini file is automatically encrypted at the next restart of Usine and will impossible to read or modify. It's encrypted according the hardware configuration of the local machine so it will be impossible to read or use the setup on an other computer.

Its the best way to encrypt the setup and be sure that it will work only on the dedicated machine.

noaudio

Usine starts without audio driver and the setup-panel-tab-audio is not visible.

novideo

Usine starts without video engine and the setup-panel-tab-video is not visible.

nolight

Usine starts without light engine and the setup-panel-tab-light is not visible.

fullasio

Usine is launched with ASIO audio driver.

fullasiochannels

Max number of audio channels opened in fullasio mode. If not specified, all available ASIO channels of the sound card will be opened.

fullasiodriver

If the computer has several ASIO drivers available, index of the driver opened in fullasio mode. If not specified, the first available is opened (index 0).

master volume

Value of the master volume in the master-panel. If this setting is omitted the master volume is set to -6dB.

splash image

You can change the default splash image which appears at the startup of Usine. The size of the image must be 465x168 pixels.

progressbar

splashimage=mynewsplash.png

The image file has to be located somewhere in the package of Usine.

disable all key learn

Disables all key learn in Usine, for example the space-bar to stop the audio engine is disabled.

disable show trace on error

Disables the trace errors popup window.

fileListerDisabled

Disables the scan of the file lister, recommended because on the kiosk, files paths are potentially different.

workspace settings

Option for the loaded workspace.

  • fullscreen
  • auto play at startup
  • auto play grid at startup
  • show grid at startup
  • show interface builder at startup

example of a complete override-setup

[SETUP]

:: ENCRYPTION
setup encrypted=0

:: ASIO
fullasio=1
soft clipping=1
pre-listen gain=0
fullasiochannels=36
fullasiodriver=0

:: Splash Image
:: must be 465x168
splashimage=splashwfs.png

:: Volume master in dB
mastervolume=0

:: deactivate all key learn
disable all key learn=1

:: PROTECT
kiosk password=PROTECT
hide main on-off=1
hide master=1
hide global synchro=1
hide contextual menu=1
hide rec automation=1
hide midi learn=1
hide zoom=1
hide save workspace=1
hide open workspace=1
deploy workspace is read only=1
hide setup=1
hide fullscreen=1
hide color palette=1
hide devices button=1
hide start page button=1

:: STARTUP
fullscreen=1
auto play at startup=1
auto play grid at startup=0
show grid at startup=0
show interface builder at startup=1

:: VARIOUS
disable internet connection=1
disable show trace on error=1

:: NETWORK
network active=1
network speed=20
network opened ports=2002
network buffer size=32768
share active=1
share port=2004
share broadcast mask=255.255.255.255
send tempo and synchro info=0
send sections info=0
send playlist info=0
enable remote control=0
remote port=80
remote ID=A00001
send global array on connexion=1

:: GLOBAL
main language=0
color style=0
global zoom scale=1
hardware acceleration=0
buffered drawing=0
fast text canvas=0
low graphic quality=0
refresh speed=1
max number of threads=64
disk buffer size=2000
:: 100% means no protection
CPU load max=100

:: FLOATING WINDOWS
floating window for patches=0
floating window for settings=0
floating window for grid=0
floating window for popups=0

:: VIDEO
video active=0
HD USB Camera=0
video_format0=0
out format=0
video frame rate=100
mix strategy=0

:: MODULAR
wire opacity=0.800000011920929
wire gravity=0.400000005960464
wire width=4

:: MIDI
memorize device name in learn=0
MIDI feedback to all devices=0
send all notes OFF on stop sync=1
ignore active sensing messages=1
MSC device ID=0
MSC group=0
MSC format=0

:: LIGHT
num of plots=2
DMX active=0
ArtNet active=0
ArtNet port out=6454
ArtNet port in=6454
ArtNet automatic poll=0
DMX frame rate=40
clear on stop=1

:: TOUCH SCREEN
enable touch screen=1
activate double click=0
trace gesture=0
use virtual keyboard=1

:: EXPERT
settings width=220
adapt audio files pitch to sample rate=1
export separated rack/patch=0
bezier curves in patches=1
disable remote hilite=1
disable mouse over effect=0
disable hints=0
disable tips=0
disable locate audio files=0
disable warning locked objects=0
disable draw selection square=0
disable upgrade message=0
disable hidden strings=0
disable mouse wheel zoom=0
legacy color scheme=0
max nb opened files=150
god mode=0
debug mode=0
replace no found wav by rnd=0
replace no found img by rnd=0
force samplers on disk=0
disable script compile=0

See also

version 5.2.221206

Edit All Pages