<!--Comment-->
<!DOCTYPE skin>           
<skin>
<elementname>
<tooltips>helpful text</tooltips>
<Style>..</Style>
<position>X,Y</position>
<size>W,H</size>
<options>values(depends)</options>
 
</elementname>           
</skin>

Optional comments (i.e. skin license or changelog)
Doctype declaration so Mixxx "know"
Skin opening tag
Elements opening tag
Tooltips to display on mouse-over
Style (depends on the element)
Position on the screen
Size (depending on the element)
Options(depending on the element)
Elements closing tag
Skin closing tag 

<!--
Name / Version of your skin, Skin for Mixxx 1.9.x
www.mixxx.org
Copyright (C) 2011 you name , [email protected]
    
based on the "Name of the original skin"
Copyright (C) 2011 name of the original author, [email protected]
  
This file is part of the "Name of your skin" Skin for Mixxx 1.9.x
"Name of your skin" is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported license.
http://creativecommons.org/licenses/by-sa/3.0/
     
You are free:
to Share - to copy, distribute and transmit the work
to Remix - to adapt the work
		
Under the following conditions:
Attribution - You must attribute the work in the manner specified by the author or licensor 
(but not in any way that suggests that they endorse you or your use of the work).

Share Alike - If you alter, transform, or build upon this work, you may distribute 
the resulting work only under the same or similar license to this one.
-->

<!--
Name / Version of your skin, Skin for Mixxx 1.9.x
www.mixxx.org
Copyright (C) 2011 you name , [email protected]

based on the "Name of the original skin"
Copyright (C) 2011 name of the original author, [email protected]

This file is part of "Name of your skin".
"Name of your skin" is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

http://www.gnu.org/licenses/gpl.html
-->

<Background>
	<Path>background.png</Path>
	<BgColor>#</BgColor>
</Background>

The size of this image defines the skins overall size, see Guidelines
Defines the background picture all the elements will displayed on
Defines a background color ( Example: # = #000000) 
#00000 is hex value for black

<TableView>
	<Style>...</Style>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<BgColor>#</BgColor>
	<FgColor>#</FgColor>
	<BgColorRowEven>#</BgColorRowEven>
	<BgColorRowUneven>#</BgColorRowUneven>
</TableView>

Defines the appearance of the library widget
Defines the elements position
Defines the elements size
Background color library widget (i.e. background color search widget)
Foreground color library widget (i.e. text in "Analyze" widget)
Background color even line right library pane 
Background color uneven lines right library pane

<Visual>
	<Tooltip>Helpful text</Tooltip>
	<Channel>X</Channel>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<BgColor>#</BgColor>
	<BgPixmap>custom_background.png</BgPixmap>
	<HfcColor>#</HfcColor>
	<SignalColor>#</SignalColor>
	<BeatColor>#</BeatColor>		
	<BeatHighlightColor>#</BeatHighlightColor>
	<MarkerColor>#</MarkerColor>
	<CueColor>#</CueColor>
<Visual>

Tooltip to be displayed on mouse-over. Use the "
" entity (without quotes) for line break
Defines which channel the settings are connected to (X = 1 or 2 )  

 
Color of waveform background  (until Mixxx 1.10. a default gradient was added , not for #000000)
New in Mixxx 1.10: Loads a background image and will tile it when smaller than the waveform widget
Color of horizontal line 
Color of waveform  
Color of beatgrid (multiple vertical lines) 
Highlight color when beatgrid is near playback position 
Default color center marker (single vertical line)
Default color of Cuepoint marker 

<Mark>
    	<Control>cue_point</Control>
        <Pixmap>custom_marker.png</Pixmap>
    	<Text>CUEPOINT</Text>
	<Align>Y</Align>
	<Color>#</Color>
	<TextColor>#</TextColor>
</Mark> 

Defines the Cuepoint , max. one cuepoint per channel 
Optional: Defines a custom marker for given element, if available it overrides the default triangle
Text visible when Cuepoint is set (and no custom marker is defined)
Defines where text is positioned (Y=top or center or bottom) 
Defines text background color 
Defines text color

<Mark>
    	<Control>hotcue_X_position</Control>
        <Pixmap>custom_marker.png</Pixmap>
    	<Text>HOTCUE X</Text>
	<Align>Y</Align>
	<Color>#</Color>
	<TextColor>#</TextColor>
</Mark>

max. 36 Hotcues(X=1-36), define every Hotcue for its own 
Optional: Defines a custom marker for given element, if available it overrides the default triangle
Text visible when Hotcue point is set (and no custom marker is defined)
Defines where text is positioned (Y= top or center or bottom) 
Defines text background color 
Defines text color

<Mark>
    	<Control>loop_start_position</Control>
        <Pixmap>custom_marker.png</Pixmap>
    	<Text>LOOP IN</Text>	
	<Align>Y</Align>
	<Color>#</Color>
	<TextColor>#</TextColor>
</Mark>

Defines a loops starting point
Optional: Defines a custom marker for given element, if available it overrides the default triangle
Text visible when starting point is set (and no custom marker is defined)
Defines where text is positioned (Y= top or center or bottom)
Defines text background color
Defines text color

<Mark>
    	<Control>loop_end_position</Control>
        <Pixmap>custom_marker.png</Pixmap>
   	<Text>LOOP OUT</Text>
	<Align>Y</Align>
	<Color>#</Color>
	<TextColor>#</TextColor>
</Mark>

Defines a loops end point
Optional: Defines a custom marker for given element, if available it overrides the default triangle
Text visible when end point is set (and no custom marker is defined)
Defines where text is positioned (Y= top or center or bottom)
Defines text background color
Defines text color

<MarkRange>
    	<StartControl>loop_start_position</StartControl>
    	<EndControl>loop_end_position</EndControl>
    	<EnabledControl>loop_enabled</EnabledControl>
	<Color>#</Color>	
	<DisabledColor>#</DisabledColor>
  </MarkRange>

Draws a color overlay between loop-in & loop-out



Defines overlay color when loop is active
Defines overlay color when loop is in-active

<Overview>
	<Tooltip>Helpful text</Tooltip>
	<Channel>X</Channel>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<BgColor>#</BgColor>
	<BgPixmap>custom_background.png</BgPixmap>
	<SignalColor>#</SignalColor>
	<MarkerColor>#</MarkerColor>
	<ProgressColor>#</ProgressColor>
	<ProgressAlpha>X</ProgressAlpha>
	<Connection>
	<ConfigKey>[ChannelX],playposition</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	</Connection>
</Overview>

Which channel the settings are connected to (X= 1 or 2)


Background color. New in Mixxx 1.9.1: If <BgColor> is not provided, the background is treated as transparent.
New in Mixxx 1.10: Loads a background image and will tile it when smaller than the waveform widget
Color of waveform overview
Color of vertical line (playing position indicator)
New in Mixxx 1.10: Color of track analysis progress visualization, color defaults to the signal color if not set
New in Mixxx 1.10: Alpha of track analysis progress visualization, default alpha is 80 out of 255

Must be same value as under <Channel> above, (X = 1 or 2)
Defines if action is performed on click on element ( true or false)

<VuMeter>
	<Tooltip>Helpful text</Tooltip>
	<PathVu>active.png</PathVu>
	<PathBack>default.png</PathBack>
	<Pos>X,Y</Pos>
	<Horizontal>false</Horizontal>
	<PeakHoldSize>5</PeakHoldSize>
	<PeakHoldTime>400</PeakHoldTime>
	<PeakFallTime>80</PeakFallTime>
  	<PeakFallStep>5</PeakFallStep>
	<Connection>
		<ConfigKey>[X],Y</ConfigKey>
	</Connection>
</VuMeter>

Button/slider main image = top layer
Button/slider background image = bottom layer

Orientation (false or true, means vertical or horizontal)
Size of peak cropped from top of <PathVu> grafik (in pixel) / Default is 5
Time a peak is displayed (in ms) / Default is 400
Time a peak falls down (in ms) / Default is 20
Number of steps a peaks falls down in <PeakFallTime> / Default is 1

Defines connected Channel & Stereo-balance (X = Channel1 or Channel2 or Master),
(Y= VuMeter or VuMeterL or VuMeterR)

<StatusLight>
	<Tooltip>Helpful text</Tooltip>
	<PathVu>active.png</PathVu>
	<PathBack>default.png</PathBack>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[X],PeakIndicator</ConfigKey>
	</Connection>
</StatusLight>

Defines connected Channel (X = Channel1 or Channel2 or Master)

<Text>
	<Tooltip>Helpful text</Tooltip>
	<Channel>X</Channel>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<Style>font; bg-color; color; text-align; padding;
	</Style>
</Text>

Defines connected Channel (X = 1 or 2)


Uses CSS. Example=font: bold 13px/15px Lucida Grande, Lucida Sans Unicode, 
Arial, Verdana, sans-serif; background-color: transparent; color: #0099FF; 
text-align: left; padding-left: 1%;

<NumberBpm>
	<Tooltip>Helpful text</Tooltip>
	<Channel>X</Channel>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<Style>font; bg-color; color; text-align; (padding);
	</Style>
	<NumberOfDigits>6</NumberOfDigits>
	<Connection>
	<ConfigKey>[ChannelX],bpm</ConfigKey>
	</Connection>
</NumberBpm>

Defines connected Channel (X = 1 or 2)




?

Must be same value as under <Channel> above, (X = 1 or 2)

<NumberPos>
	<Tooltip>Helpful text</Tooltip>
	<Channel>X</Channel>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<Style>font; bg-color; color; text-align; (padding);
	</Style>
	<NumberOfDigits>6</NumberOfDigits>
	<Connection>
	<ConfigKey>[ChannelX],playposition</ConfigKey>
	</Connection>
</NumberPos>

Defines connected Channel (X = 1 or 2)




?

Must be same value as under <Channel> above, (X = 1 or 2)

<NumberRate>
	<Tooltip>Helpful text</Tooltip>
	<Channel>X</Channel>
	<Pos>X,Y</Pos>
	<Size>W,H</Size>
	<Style>font; background-color; color; text-align; (padding);
	</Style>
	<Connection>
	<ConfigKey>[ChannelX],rate</ConfigKey>
	</Connection>
</NumberRate>

Defines connected Channel (X = 1 or 2)




Remove the whole <Connection> </Connection> block for Mixxx v1.10+, needed in older versions
Must be same value as under <Channel> above, (X = 1 or 2)

<SliderComposed>
	<Tooltip>Helpful text</Tooltip>
	<Handle>handle.png</Handle>
	<Slider>slider.png</Slider>
	<Pos>X,Y</Pos>
	<Horizontal>false</Horizontal>
	<Connection>
	<ConfigKey>[ChannelX],volume</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	</Connection>
</SliderComposed>

Slider image (knob) which can de dragged with mouse
Slider background image the <Handle> moves up and down on

Orientation (false or true, means vertical or horizontal)

Defines connected Channel (X = 1 or 2 )

<SliderComposed>
	<Tooltip>Helpful text</Tooltip>
	<Handle>handle.png</Handle>
	<Slider>slider.png</Slider>
	<Pos>X,Y</Pos>
	<Horizontal>true</Horizontal>
	<Connection>
	<ConfigKey>[Master],crossfader</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	</Connection>
</SliderComposed>

Slider image (knob) which can de dragged with mouse
Slider background image the <Handle> moves left  and righ on

Orientation (false or true, means vertical or horizontal)

Use always default value

<SliderComposed>
	<Tooltip>Helpful text</Tooltip>
	<Handle>handle.png</Handle>
	<Slider>slider.png</Slider>
	<Pos>X,Y</Pos>
	<Horizontal>false</Horizontal>
	<Connection>
	<ConfigKey>[ChannelX],rate</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	</Connection>
</SliderComposed>

Slider image (knob) which can de dragged with mouse
Slider background image the <Handle> moves up and down on

Orientation (false or true, means vertical or horizontal)

Defines connected Channel (X = 1 or 2 )

<PushButton>
	<Tooltip>Helpful text for both states</Tooltip>
	<NumberStates>2</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],play</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],cue_set</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
</PushButton> 

Left Click: Pause/Play, Right Click: Set cue point
Overall quantity of states the button have

First state
Default image displayed
Image displayed on mouse-down


Second state
Default image displayed
Image displayed on mouse-down


First states action
Defines connected Channel (X = 1 or 2) , performed action (play)
Defines if action is performed on down-click on element (true or false)
Which mouse button must be clicked so the action is performed 

Second states action
Defines connected Channel (X = 1 or 2) , performed action (cue_set)
Defines if action is performed on down-click on element (true or false)
Which mouse button must be clicked so the action is performed
 

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],cue_default</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],cue_gotoandstop</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
</PushButton> 

Go to and play (while playing), Set cue point (while stopped), Go to and stop (right-click)









Defines connected Channel (X = 1 or 2) , performed action (cue_default)
Defines if action is performed on down-click on element (true or false)
Which mouse button must be clicked so the action is performed 
Hint: Default cue behavior can be changed in Mixxx preferences

Defines connected Channel (X = 1 or 2) , performed action (cue_gotoandstop)
Defines if action is performed on down-click on element (true or false)
Which mouse button must be clicked so the action is performed 

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],hotcue_Y_activate</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],hotcue_Y_activate</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],hotcue_Y_clear</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
</PushButton>

Set and play Hotcue (while playing), 
play Hotcue (while stopped), delete Hotcue (right-click)







Channel (X=1 or 2), Hotcue # (Y=1-36) & performed action (activate), 
depends on  # of Hotcues defined , see hotcue_X_position
Action is performed while playing (true) on click on element


Action is performed while down pressing the element and playback is stopped (false) 
Playback from Hotcue X position when the player is stopped (aka Hotcue preview )
Which mouse button must be clicked so the action is performed


Channel (X=1 or 2), Hotcue # (Y=1-36) & performed action (clear)

Which mouse button must be clicked so the action is performed

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],loop_in</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],loop_in</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
</PushButton>

Click on button sets a "Loop-In" point. The point can not be cleared.
It is instead overwritten by a new "Loop-In" point by clicking the button again.







Channel (X=1 or 2), performed action (loop_in)
Action is performed when clicking on element
Works when playback has stopped too

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressd.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],loop_out</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],loop_out</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
</PushButton>

Click on button sets a "Loop-Out" point. The point can not be cleared.
It is instead overwritten by a new "Loop-Out" point by clicking the button again.

The "Loop-Out" point can not be set if:
* No "Loop-In" point has been set before
* The "Loop-In" point has been set before but the current playback position is prior to the "Loop-In" point



Channel (X=1 or 2), performed action (loop_out)
Action is performed when clicking on element
Works when playback has stopped too

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],reloop_exit</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],reloop_exit</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
 </PushButton>

Click on button activate the "Looping" feature. 
The playback jumps to "Loop-In" point and loop from there until "Loop-Out" point.
Click on button while "Looping" is activated will de-activate the Looping and ignore "Loop-Out" point.

The "Looping" feature can not be activated if:
* No "Loop-In" point has been set before
* No "Loop-Out" point has been set before


Channel (X=1 or 2), performed action (reloop_exit)
Action is performed when clicking on element

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],reverse</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],reverse</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
</PushButton>

Reverse playback Channel X while playing








Defines connected Channel (X = 1 or 2) , performed action (reverse)

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
</PushButton>

Fast forward (rewind),  Right-click: Jump to end (start) of track








Defines connected Channel (X = 1 or 2) , performed action (Y=fwd or back)




Defines connected Channel (X = 1 or 2) , performed action (Y=fwd or back)




Defines connected Channel (X = 1 or 2) , performed action jump to (Y=end or start)

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],beatsync</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
</PushButton>

Synchronize tempo with other channel








Defines connected Channel (X = 1 or 2) , performed action (beatsync)

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
</PushButton>

Left Click: Temporary increase (decrease) pitch,
Right Click: Temporary increase (decrease) pitch in small step








Defines connected Channel (X = 1 or 2),
performed action (Y= rate_temp_up or rate_temp_down)



Defines connected Channel (X = 1 or 2),
performed action (Y= rate_temp_up_small or rate_temp_down_small)

<PushButton>
	<Tooltip>Helpful text for all states</Tooltip>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	<ButtonState>RightButton</ButtonState>
	</Connection>
</PushButton>

Left Click: Temporary increase (decrease) pitch, 
Right Click: Temporary increase (decrease) pitch in small step








Defines connected Channel (X = 1 or 2) , 
performed action (Y= rate_temp_up or rate_temp_down)








Defines connected Channel (X = 1 or 2) , 
performed action (Y= rate_temp_up_small or rate_temp_down_small)

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>2</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],pfl</ConfigKey>
	</Connection>
</PushButton>

Headphone prelisten for Channel X



Default button visible




Button visible when active




Defines connected Channel (X = 1 or 2) , performed action (beatsync)

<PushButton>
	<Tooltip>...</Tooltip>
	<Style>...</Style>
	<NumberStates>1</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],bpm_tap</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	</Connection>
	<Connection>
	<ConfigKey>[ChannelX],bpm_tap</ConfigKey>
	<EmitOnDownPress>false</EmitOnDownPress>
	</Connection>
</PushButton>

Takes the progressive average of the last 4 taps 
and sets the bpm of the deck to that valu








Defines connected Channel (X = 1 or 2) , performed action

<PushButton>
	<Tooltip>Helpful text</Tooltip>
        <Style>...</Style>
	<NumberStates>2</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],keylock</ConfigKey>
	</Connection>
</PushButton>

Activates position-independent time stretch














Defines connected Channel (X = 1 or 2) , performed action

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<Style>...</Style>
	<NumberStates>2</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],repeat</ConfigKey>
	</Connection>
</PushButton>

Track repeat if you go past the end or reverse before the start














Defines connected Channel (X = 1 or 2) , performed action

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>3</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>stop.png</Pressed>
	<Unpressed>stop.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>next.png</Pressed>
	<Unpressed>next.png</Unpressed>
	</State>
	<State>
	<Number>2</Number>
	<Pressed>loop.png</Pressed>
	<Unpressed>loop.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],TrackEndMode</ConfigKey>
	</Connection>
</PushButton>

End of track mode control (see manual)



Button visible in STOP mode




Button visible in NEXT mode




Button visible in LOOP mode




Defines connected Channel (X = 1 or 2) , performed action (TrackEndMode)

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>2</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],flanger</ConfigKey>
	</Connection>
</PushButton>

Apply flanger effect to Channel X



Default button visible




Button visible when active




Defines connected Channel (X = 1 or 2) , performed action (flanger)

<PushButton>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>2</NumberStates>
	<State>
	<Number>0</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<State>
	<Number>1</Number>
	<Pressed>pressed.png</Pressed>
	<Unpressed>unpressed.png</Unpressed>
	</State>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[ChannelX],Y</ConfigKey>
	<EmitOnDownPress>true</EmitOnDownPress>
	<ButtonState>LeftButton</ButtonState>
	</Connection>
</PushButton>

Cuts the high, mid and low frequencies on Channel X



Default button visible




Button visible when active




Defines connected Channel (X = 1 or 2), 
performed action (Y= filterHighKill or filterMidKill or filterLowKill)

<Knob>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>X</NumberStates>
	<Path>knob_rotary_s%1.png</Path>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[Master],Y</ConfigKey>
	</Connection>
</Knob>

You need X single knobs where #(X/2)+1 is the 0-state. 
Example: X=41 states (270 degree rotation / 40 knobs + the 0-state) . 
You need 20 knobs rotate from -135 degree to 0 degree, one knob 0 degree (default knob visible) ,  
20 knobs rotate from -135 degree to 0 degree

Defines connected Channel (Master) , performed action (Y=volume or balance)

<Knob>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>X</NumberStates>
	<Path>knob_rotary_s%1.png</Path>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[Flanger],Y</ConfigKey>
	</Connection>
</Knob>

Defines connected Channel (Flanger),
performed action (Y=lfoDelay or lfoDepth or lfoPeriod)

<Knob>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>X</NumberStates>
	<Path>knob_rotary_s%1.png</Path>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[Flanger],Y</ConfigKey>
	</Connection>
</Knob>

Defines connected Channel (Master), performed action (Y=headVolume or headMix)

<Knob>
	<Tooltip>Helpful text</Tooltip>
	<NumberStates>X</NumberStates>
	<Path>knob_rotary_s%1.png</Path>
	<Pos>X,Y</Pos>
	<Connection>
	<ConfigKey>[X],Y</ConfigKey>
	</Connection>
</Knob>

Defines connected Channel (X = 1 or 2), 
performed action (Y= pregain or filterHigh or filterMid or filterLow)

   <TrackProperty>
      <Tooltip>...</Tooltip>
      <Style>...</Style>
      <Property>...</Property>
      <Channel>X</Channel>
      <Pos>x,y</Pos>
      <Size>a,b</Size>
   </TrackProperty>

The "Property" field can be any of:
artist, title, album, genre, year, track_number, times_played, comment, bpm, bpmFormatted, duration, durationFormatted

bpm will be the full precision number (i.e. 1.333333333) while bpmFormatted is to 3 decimal places (1.333),
duration is the duration in seconds, while durationFormatted is the duration in hh:mm:ss.xx format. 

<WidgetGroup>
  <Pos>100,200</Pos>
  <Size>w,h</Size>
  <Children>
    <PushButton>
      <Pos>0,0</Pos>
    </PushButton>
    <SliderComposed>
      <Pos>20, 0</Pos>
    </SliderComposed>
    <!-- as many regular widgets as you like in here -->
  </Children>
</WidgetGroup>

<size> is optional, this will limit the size so that any part of a 
child widget outside of the size rectangle is not shown


In that example, the PushButton child will be at 0,0 relative to its parent, 
or the absolute position 100,200. 
The SliderComposed widget will be at 20,0 relative to its parent or 120,200.