energyXT.ini

The file energyXT.ini contains the global settings for energyXT2. It is found in the main energyXT2 folder, and is automatically created if it doesn't exist when you run energyXT2.

Most people will never need to edit the ini file. Almost all the settings can be controlled from within energyXT2. If you do edit it, use a good text editor such as Notepad++. Using Windows Notepad will mess it up. Also, always make a copy of it before editing!

Reasons to edit energyXT.ini

  • Using relative paths when running XT2 from a flash drive
  • Renaming Browser folders when more than one are defined in a section
  • Disabling audio if energyXT2 won't start due to selected audio driver
  • Resetting keyboard shortcuts to default
  • Resetting window positions in case they're off the screen

Format

As mentioned above, most text editors will alter the formatting of energyXT.ini. This is because it uses non-standard line endings (CR CR LF).

The basic format is:
[section]
parameter=value1
anotherparameter=value2

Be careful about having multiple lines defining the same parameter, because this will probably make energyXT2 destroy the ini file.

Paths

Absolute or relative paths can be used, with either forward slashes (/Unix-style/) or backslashes (C:\Windows-style\). Folder paths work with or without an ending slash.

For Browser folder paths, the format is:
C:\Path\folder=Name shown in Browser

Any whitespace in a path will be used, so there shouldn't be any space around the “=” sign. The first “=” on the line is used to separate the path from the name, so if there is one in the path, it won't work right; for example:

C:\Path\with=sign in it=Name

will point to the path C:\Path\with and will be named sign in it=Name in the Browser.

Sections

Here is an attempt to document the settings file, showing each possible line, with the default settings shown where applicable (the Windows version was used to determine defaults). Virtually all of this can be changed from within energyXT2.

[project]

last=C:\Path\To\Last\Opened\Project.xt
Full path to last opened project

[editor]

maximized=0
Whether the main window is maximized (=1) or not (=0)
left=100
Last X-position of the main window, in pixels
top=100
Last Y-position of the main window, in pixels
width=800
Last width of the main window, in pixels
height=480
Last height of the main window, in pixels

[options]

width=160
Width of the Browser, in pixels (0=hidden)
time=1
Sets whether the clock is min:sec:ms (=0) or bars:beats:ticks (=1)
tempaudiofolder=
Full or relative path to temp audio folder
page=2
Last used page in Setup: 0=Project; 1=Global; 2=Audio; 3=MIDI; 4=Browser; 5=Looks; 6=Shortcuts
savePosAndSize=0
0=Use dimensions from energyXT.ini ([editor] section); 1=Use dimensions saved in each project
rndTrackCol=1
Random track color on (=1) or off (=0)
dft=1
FFT visualizer bars in the toolbar on (=1) or off (=0)
showHint=1
Show hints in the toolbar (=1), or not (=0)
savePrompt=1
Ask to save modified project before closing (=1) or not (=0)
startwith=-1
Start with: -1=Welcome page; 0=Default project ; 1= Empty project; 2=Last project
look=1
Light (=0), Dark (=1), or loaded xtl theme (=-1)
theme=C:\Path\to last loaded\theme.xtl
Only used when look=-1

[metronome]

enabled=1
Metronome on/off
mode=6
Metronome mode: 0=(nothing); 1=Playback only; 2=Recording only; 3=Playback and Recording; 4=Count-in only; 5=Playback and Count-in; 6=Recording and Count-in; 7=Playback, Recording, and Count-in
beats=4
Metronome beats
volume=80
Metronome volume, in %

[render]

source=0
Last used render selection, either All (=0) or Left - Right locator (=1)
bits=16
Last rendered bit depth, either 16, 24, or 32
chs=2
Last settings for render to Stereo (=2) or Mono (=1)
rate=44100
Last rendered sample rate in Hz
ext=0
Last rendered file type, wav (=0), aif (=1) or mp3 (=2)
bitrate=128
Last used bitrate for mp3 rendering, in kbps

[audio]

buffersize=2048
Audio buffer size in samples
samplerate=44100
Audio sample rate in Hz
device=0
Audio device index; -1 is <no audio>
deviceRec=-1
????
driver=0
On Windows, DS (=1) or ASIO (=0)
recbits=16
Recording bit depth

[ProjectFolders]

C:\Program Files\energyXT2\projects=projects
Full or relative path to a Project folder = name of the folder in the Browser; none by default

[VSTFolders]

C:\Path\to\vst=vst
Full or relative path to a Plugin folder = name of the folder in the Browser; none by default

[PresetFolders]

C:\Program Files\energyXT2\presets=presets
Full or relative path to a Preset folder = name of the folder in the Browser; none by default

[ClipFolders]

C:\Program Files\energyXT2\clips=clips
Full or relative path to a Clip folder = name of the folder in the Browser; none by default

[SampleFolders]

C:\Path\to\samples=samples
Full or relative path to a Sample folder = name of the folder in the Browser; none by default

[Audio outputs]

channel0=1
Enabled audio outputs
channel1=1
Enabled audio outputs

[Audio inputs]

channel0=1
Enabled audio inputs
channel1=1
Enabled audio inputs

[MIDI inputs]

device0=1
Enabled MIDI inputs (none by default)

[MIDI outputs]

device0=1
Enabled MIDI outputs (none by default)

[template]

last=0
Last used project template, as in the Welcome/New window

[filewin]

left=200
X-position of the save/load dialog window
top=200
Y-position of the save/load dialog window
width=480
Width of the save/load dialog window
height=480
Height of the save/load dialog window
tree=128
Size of the folder tree in the save/load dialog window

[recent]

0=C:\Program Files\energyXT2\projects\demosong.xt
Full path to last opened project (same as [project] > last)
1=C:\projects\Project opened before demosong.xt
etc.

[shortcuts]

Format: (action)=(modifiers),(keycode)

Where (modifiers) is the sum of the Shift (16), Ctrl (32), and Alt (64) checkboxes, and (keycode) is the keycode. If keycode is 0, the shortcut is disabled.

Special Keys

The following special keys have to be entered by name in Setup:

Key Code in energyXT.ini
SPACE 32
HOME -1
END -6
DEL -7
ENTER (or RETURN) -9
PAGEUP -12
PAGEDOWN -13
INSERT -14
F1 -15
F2 -16
F3 -17
F4 -18
F5 -19
F6 -20
F7 -21
F8 -22
F9 -23
F10 -24
F11 -25
F12 -26

Defaults

Default values are shown, but each line is only added to the ini if you change the shortcut. If a line doesn't exist, the default is used. If you just want to reset to the defaults, simply delete the entire [shortcuts] section.

zoomin=0,43
zoomout=0,45
leftlocator=0,49
rightlocator=0,50
playselection=16,-9
quantize=32,113
nextbeat=0,54
priorbeat=0,52
mixer=0,-23
browser=0,-17
setup=0,-20
find=32,102
edit=32,101
editinplace=0,101
rename=32,114
render=0,-19
priorpage=0,-15
nextpage=0,-16
priorprog=0,56
nextprog=0,57
metronome=0,99
new=32,110
open=32,111
save=32,115
saveas=48,115
openlast=32,108
undo=32,122
redo=32,121
duplicate=32,100
delete=0,-7
selectAll=32,97
copy=32,99
paste=32,118
play=0,-9
record=0,114
stop=0,48
rewind=0,51
loop=0,108
mute=0,109
solo=0,115
mutepart=32,109
opencomp=32,32
splitatcursor=32,107
insertbars=16,73
removebars=16,82
chstrip=0,-21
addtrack=32,-14
zoomselection=32,43
showparams=0,112
snap=0,120
autoscroll=0,106
octup=0,-12
octdown=0,-13
freeze=32,102
glue=32,103
unghost=32,117
objectbar=0,111
bounce=32,98
crossfade=16,120

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License