<?xml version="1.0" ?>
<airLCD>
  <!-- All options must be contained in the airLCD tags and inside their appropiate module tags -->
  <!-- This is a chopped down file for explaination only. -->
  
  <!-- General Settings> -->
  <General>
    <!-- Version number. airLCD checks that this file is for the right version-->
    <Version>0.2</Version>
    
    <!-- how long to pause for each cycle to read LIRC commands. -->
    <!-- Time in micro seconds. 1000 = 0.001s. -->
    <!-- Vary this for how responsive you want airlcd to be. -->
    <!-- Best to get it as low as possible. I have got it down to 100.-->
    <Sleep>1000</Sleep>
  </General>

  <!-- The Amarok module -->
  <Amarok>
    <!-- How many times to try attaching to the DCOP server (the messaging system Amarok uses to talk to us) -->
    <DCOPAttempts>3</DCOPAttempts>
    <!-- How long in seconds to wait between attempts-->
    <DCOPTimeout>10</DCOPTimeout>
    <!-- The above two options are very useful when you start amarok outside of KDE and it takes a little while -->
    <!-- to get all the KDE hooks up and running. They give us a bit of breathing space before quitting. -->
  </Amarok>
  
  <!-- The LIRC module -->
  <LIRC>
    <!-- The location of the lirc->airLCD command file (example one included) -->
    <ConfigFile>/etc/lircrc.conf</ConfigFile>
  </LIRC>

  <!-- The LCDproc Module -->
  <LCDproc>
    <!-- The server name (most likely the machine you are running airLCD on) -->
    <Server>localhost</Server>
    <!-- The LCDproc port (default) -->
    <Port>13666</Port>
    <!-- Width of the display -->
    <Width>40</Width>
    <!-- Height of the display -->
    <Height>4</Height>
    <!-- The name of the client (must be unique) -->
    <ClientName>airlcd</ClientName>
    <!-- A screen section. You can have as many of these as you want. They will cycle after the specified interval -->
    <Screen>
      <!-- Each screen must have a unique name -->
      <Name>main</Name>
      <!-- The width of the screen -->
      <Width>40</Width>
      <!-- The height of the screen -->
      <Height>4</Height>
      <!-- The priority of the screen. foreground it normal. info is also valid, but will not show -->
      <!-- if there are other foreground screens. So don't change unless you need to. -->
      <Priority>foreground</Priority>
      <!-- How long screen should be visible for (only valid if more than 1 screen). -->
      <!-- Time is in 8th of a second, so 80 = 10s -->
      <Duration>80</Duration>
      <!-- Do you want the annoying LCDproc heartbeat in the upper right? -->
      <Heartbeat>off</Heartbeat>
      <!-- A widget for your screen. These come in the following flavours: -->
      <!-- string, scroller, horizontal, vertical and combo bars -->
      <Widget>
        <!-- The unique name of the widget (unique to the screen at least). Some names are reserved. See end for list -->
        <Name>artist</Name>
        <!-- The type of widget -->
        <Type>scroller</Type>
        <!-- The location of it's left side -->
        <X>1</X>
        <!-- The location of its top line -->
        <Y>1</Y>
        <!-- How wide it is -->
        <Width>34</Width>
        <!-- How many lines it should span (1 is normal, unless you know you will have multi-line text-->
        <Height>1</Height>
        <!-- How should the text on each line be aligned? (left, right, center) -->
        <Align>center</Align>
        <!-- The movement type of the scroller. horizontal or vertical bounce or marquee (loop around)-->
        <Move>marquee</Move>
        <!-- How fast. Increase for faster movement-->
        <Speed>5</Speed>
        <!-- If using marquee what characters do you want to separate the end from the begining? -->
        <ScrollSeparator>--</ScrollSeparator>
        <!-- Any text you want displayed in this widget -->
        <Text>Welcome to airLCD</Text>
      </Widget>
      <!-- Another widget -->
      <Widget>
        <Name>currentTime</Name>
        <!-- This is a string widget -->
        <Type>string</Type>
        <X>10</X>
        <Y>2</Y>
        <Width>6</Width>
        <Align>right</Align>
        <Text>00:00</Text>
        <!-- Note that strings have no movement, speed or ScrollSeparator tags. -->
      </Widget>
      <!-- Another widget -->
      <Widget>
        <Name>volume</Name>
        <!-- A combo bar widget. These are a hybid of a horizontal bar and a string widget -->
        <!-- This means that with one widget you can do this: vol:===== -->
        <Type>combobar</Type>
        <X>11</X>
        <Y>4</Y>
        <!-- The width is the total length of the text and the max length of the hbar -->
        <!-- In this case there are hbar can occupy 7 chars as the text takes 4 chars. -->
        <Width>11</Width>
        <!-- Text to display on the left side of your hbar -->
        <Text>vol:</Text>
      </Widget>
      <!-- Another widget -->
      <Widget>
        <Name>score</Name>
        <!-- A vertical bar widget. These start from the bottom and increase in size upwards -->
        <Type>vbar</Type>
        <!-- This bar is located in the bottom right -->
        <X>40</X>
        <Y>4</Y>
        <!-- The max height of the bar (how many lines will it go over) -->
        <Height>4</Height>
        <!-- What percentage of the bar do you want filled initially? (0-100) -->
        <Percent>0</Percent>
      </Widget>
      <!-- Another widget -->
      <Widget>
        <Name>myhbar</Name>
        <!-- A horizonatl bar widget. -->
        <Type>hbar</Type>
        <!-- These start from the left and grow to the right -->
        <X>2</X>
        <Y>3</Y>
        <Width>25</Width>
        <!-- What percentage of the bar do you want filled initially? (0-100) -->
        <Percent>100</Percent>
      </Widget>
    </Screen>
    <!-- The next screen -->
    <Screen>
      <!-- Each screen must have a unique name -->
      <Name>extra</Name>
      <Width>40</Width>
      <Height>4</Height>
      <Priority>foreground</Priority>
      <Duration>40</Duration>
      <Heartbeat>off</Heartbeat>
      <Widget>
        <!-- Notice that we can have a widget of the same name on a different screen. Both will get updated as well -->
        <Name>artist</Name>
        <Type>scroller</Type>
        <X>1</X>
        <Y>1</Y>
        <Width>34</Width>
        <Height>1</Height>
        <Align>center</Align>
        <Move>marquee</Move>
        <Speed>5</Speed>
        <ScrollSeparator>--</ScrollSeparator>
        <Text>Welcome to airLCD</Text>
      </Widget>
    </Screen>.
    
    <!-- What words or symbols do you want displayed for the different modes -->
    <StatusText>
      <!-- Playing text -->
      <Play>Play</Play>
      <!-- Paused text -->
      <Pause>Pause</Pause>
      <!-- Stopped text -->
      <Stop>Stop</Stop>
      <!-- Repeat Track text-->
      <Repeat>Rpt</Repeat>
      <!-- Repeat playlist text-->
      <RepeatPL>Rpt+</RepeatPL>
      <!-- Random mode enabled text-->
      <Random>Shfl</Random>
      <!-- Muted text-->
      <Mute>Muted</Mute>
      <!-- Dynamic mode text-->
      <Dynamic>Dyn</Dynamic>
    </StatusText>

    <!-- LCDproc Key Bindings-->
    <!-- Here you can specify keys that LCDproc should use if you want -->
    <!--to use it for input instead of LIRC-->
    <!-- When these keys are pressed they execute the specified commands-->
    <!-- These commands are the same as those used in the LIRC config file-->
    <KeyBindings>
      <!-- Scroll the browser up-->
      <w>browser up</w>
      <!-- scroll down-->
      <s>browser down</s>
      <!-- up a menu-->
      <a>browser back</a>
      <!-- enter a sub menu-->
      <d>browser forward</d>
      <!-- select the current item-->
      <e>browser select</e>
      <!-- show/hide the browser-->
      <q>browser toggle</q>
      <!-- toggle between play and pause in Amarok-->
      <p>amarok playPause</p>
      <!-- skip to the next song-->
      <n>amarok next</n>
      <!-- skip back a song-->
      <b>amarok prev</b>
    </KeyBindings>
    
  </LCDproc>

  <!-- The Browser Module-->
  <!-- Here you can configure your search parameter and how the brwoser behaves-->
  <Browser>
    <!-- What line should be the active line-->
    <CursorLocation>2</CursorLocation>
    <!-- when viewing an album, show the track numbers or not-->
    <ShowTrackNumber>true</ShowTrackNumber>
    <!-- How to scroll the active line - takes the same options as a scroller (vertical, horizontal, marquee-->
    <ScrollType>vertical</ScrollType>
    <!-- How fast to scroll the active line-->
    <ScrollSpeed>7</ScrollSpeed>
    <!-- If using marquee then what separator to use-->
    <ScrollSeparator>--</ScrollSeparator>
    <!-- when viewing tracks start on the first track or on "Add All Tracks"-->
    <StartOnTrack>true</StartOnTrack>
    
    <!-- What filters do you want to use? you need as least one to be able to search your -->
    <!-- database. These work in the same way as the Collection filters in Amarok-->
    <!-- The possible filter options are: Genre, Year, Artist, Album-->
    <!-- They must be separted with a forward slash and with no spaces-->
    <!-- You can have any combination or number or them as you like.-->
    <!-- Any depth from 1 to 4 is valid.-->
    <Group>Genre/Artist/Album</Group>
    <Group>Artist/Album</Group>
    <Group>Album</Group>
    <Group>Artist</Group>
    <Group>Genre/Album</Group>
    <Group>Year/Artist/Album</Group>
    <Group>Genre/Year/Artist/Album</Group>
  </Browser>

  
  <!-- The list of reserved widget names is as follows. If you use these they will get updated by airLCD from Amarok-->
  <!-- artist - The name of the current artist -->
  <!-- album - The name of the current album -->
  <!-- title - The name of the current track -->
  <!-- genre - The genre of the current track -->
  <!-- bitrate - The bitrate of the current track -->
  <!-- year  - The year of the current track -->
  <!-- currentTime - The elapsed time of the current track (e.g. 00:10)-->
  <!-- totalTime - The length of the current track (e.g. 03:47) -->
  <!-- comment - The comment field of the current track -->
  <!-- trackNumber - The current track position in the playlist-->
  <!-- totalTracks - The total number of track in the playlist -->
  <!-- score - The rating of the current track -->
  <!-- nowPlaying - A combination of artist and title. Ideal for small displays (e.g. Artist - Title) -->
  <!-- volume - The current volume -->
  <!-- mute - The mute status. Will display the mute text if Amarok is muted -->
  <!-- random - The random status. Will display the random text if Amarok is in random mode -->
  <!-- dynamic - The dynamic status. Will display the dynamic text if Amarok is in dynamic mode -->
  <!-- repeat - The repeat track status. Will display the repeat track text if enabled -->
  <!-- repeatPL - The repeat playlist status. Will display the playlist track text if enabled -->
  <!-- status - The current playing status. Will display the play, pause or stop text depending -->
  <!--          on which of those Amarok is doing. -->

  <!-- These reserved widgets are fixed to any type, but it makes sense to use certain types for some of them.-->
  <!-- For example artist should be a string or a scroller. It makes no sense for it to be a hbar, vbar or combobar-->
  <!-- Volume however can be any type. if a string the volume will be displayed as a number. If it is one of the -->
  <!-- bars the percentage will be shown by their length.-->
  
  <!-- You can make up you own widgets if say you want some permanent text on the screen such as a % sign-->
  <!-- or a vertical bar to partition off part of the screen. -->
  
  <!-- If you miss out a variable, e.g. Height, airLCD will use it's default value -->
  
  <!-- Play and experiment. Hopefully should be only limited by your imagination! =:-) -->
  
  
  <!-- End-->
</airLCD>