HTC Home Documentation

Configuration

Some of the options are configurable via the Settings window, but some are configurable through the config file only.
For 1.x versions it is Settings.ini, located in the root folder where HTC Home is located.
For 2.0 version there are .conf files in the Config subfolder.

Configuring version 1.x

Autostart - Available in the UI. This parameter configures if the widget should be run at Windows startup or not. Type - boolean (True or
False)Location and LocationCode - Not recommended to be set by hand, UI is preferred. Syntax is the end of an RSS URL for the current conditions (AccuWeather: http://karls.accu-weather.com/widget/karls/city-find.asp?location=blablabla | MSN: http://weather.msn.com/find.aspx?weasearchstr=blablabla).Left and Top - Works if Position is set to 7. Sets where the widget will be shown. Configurable by moving the widget. Type - integer. Number of screen pixels from the left and top respectively.TimeMode - Available in the UI. Sets 24 and 12-hour time format. Type - boolean integer.
0 stands for 24 hour and 1 stands for 12 hour.DegreeType - Available in the UI. Sets degree type shown. Type - boolean integer.
0 stands for Celsius and 1 stands for Fahrenheit.EnableGlass - Available in the UI. Sets should Aero Glass be enabled or disabled. Type - boolean.
True stands for Enabled and False stands for Disabled. Not available in Windows XP.EnableWallpaperChanging - Available in the UI. Sets should wallpaper changing be enabled or disabled. Type - boolean.
True stands for Enabled and False stands for Disabled.EnableWeather - Available in the UI. Sets should weather be shown or not. Type - boolean.
True stands for Enabled and False stands for Disabled.EnableAnimation - Available in the UI. Sets should weather animation be enabled or not. Type - boolean.
True stands for Enabled and False stands for Disabled.EnableTrayIcon - Available in the UI. Sets should an icon in the notification area be shown or not. Type - boolean.
True stands for Enabled and False stands for Disabled.LastTemp, LastWeatherPic, LastLocationCode, LastLocationName and
LastWeatherState. Should not be changed manually, these parameters show the conditions shown at last run time.WeatherProvider - Available in the UI. Sets which weather provider will be used. Type - string. Valid values are
Accuweather and MSN.Interval - Available in the UI. Sets the interval time of automatic conditions refresh in minutes. Type - integer. Default value is
15.ScaleFactor - Available in the UI (partially). Sets the widget's size. Type - integer. Default value is
1. Valid values vary from 0.1 (very small) to 9.9 (very large, though that size will be out of bounds).Locked - Available in the UI (context menu). Sets should the widget will be locked on it's position and become unmovable, or not. Type - boolean.
True stands for Enabled and False stands for Disabled.Locale - Available in the UI. Sets the language of the widget to be shown in. Type - string. You can get new localizations
here.Sunset - Sets when the moon will be shown. Type - integer. Default is 22 (22:00 or 10:00 PM). Note: only for MSN.Sunrise - Sets when the sun will be shown. Type - integer. Default is 4 (4:00 or 4:00 AM). Note: only for MSN.TopMost - Available in the UI. Sets should the widget will be shown on top of other windows or not. Type - boolean.
True stands for Enabled and False stands for Disabled.Position - Available in the UI. Sets where the widget will be shown. Type - integer.
0 - top left, 1 - bottom left, 2 - top center, 3 - center,
4 - bottom center, 5 - top right, 6 - bottom right, 7 - custom. Default is
3.DetectUserLocation - Sets should geolocation will be enabled or not. Type - boolean.
True stands for Enabled and False stands for Disabled.DateFormat - Sets the date format shown. Type - string. Valid values are any combination of these:
ddd - day of the week, MMM - month, d - day of the month. Default is
ddd, MMM d.ShowForecast - Available in the UI. Sets should the 5-day weather forecast will be shown or not. Type - boolean.
True stands for Enabled and False stands for Disabled.WallpapersFolder - Available in the UI. This is used in conjuction with the
EnableWallpaperChanging parameter to set the folder from where HTC Home will take the wallpapers.

UseLocationTime - Available in the UI. Sets should the widget will show time for selected location from the weather provider's servers. Type - boolean.
True stands for Enabled and False stands for Disabled.StickToEdges - Available in the UI. Sets should the widget stick to screen edges or not. Type - boolean.
True stands for Enabled and False stands for Disabled.

Configuring version 2.0

Home.conf

<ShowNewsWidget>true</ShowNewsWidget> - Sets should the News Widget will be shown or not. Type - boolean. Default is true.<ShowWeatherClockWidget>true</ShowWeatherClockWidget> - Sets should the WeatherClock Widget will be shown or not. Type - boolean. Default is true.<EnableTrayIcon>true</EnableTrayIcon> - Available in the UI. Sets should an icon in the notification area be shown or not. Type - boolean. Default is true.

WeatherClockWidget.conf

<autostart>false</autostart> - Available in the UI. This parameter configures if the widget should be run at Windows startup or not. Type - boolean. Default is false.<checkForUpdates>false</checkForUpdates> - Sets should the widget look for a new version. Type - boolean. Default is false. Note: This feature has been removed and now has no effect.<cloudsAnimCount>3</cloudsAnimCount>, <leavesAnimCount>5</leavesAnimCount>,
<raindropsAnimCount>30</raindropsAnimCount> and <snowflakesAnimCount>10</snowflakesAnimCount> - Available in the UI. Sets clouds, leaves, raindrops and snowflakes animation count. Type - integer. Defaults are
3, 5, 30, 10.<cloudsCount>6</cloudsCount>, <leavesCount>10</leavesCount>,
<raindropsCount>15</raindropsCount>, <snowflakesCount>15</snowflakesCount> - Sets clouds, leaves, raindrops and snowflakes count. Type - integer. Defaults are
6, 10, 15, 15.<degreeType>0</degreeType> - Available in the UI. Sets degree type shown. Type - boolean integer.
0 stands for Celsius and 1 stands for Fahrenheit.<enableGlass>true</enableGlass> - Available in the UI. Sets should Aero Glass be enabled or disabled. Type - boolean. Default is true. Not available in Windows XP.<enableTrayIcon>true</enableTrayIcon> - Available in the UI. Sets should an icon in the notification area be shown or not. Type - boolean. Default is true.<enableWallpaperChanging>false</enableWallpaperChanging> - Available in the UI. Sets should wallpaper changing be enabled or disabled. Type - boolean. Default is false.<enableWeather>true</enableWeather> - Available in the UI. Sets should weather be shown or not. Type - boolean. Default is true.<enableWeatherAnimation>true</enableWeatherAnimation> - Available in the UI. Sets should weather animation be enabled or not. Type - boolean. Default is true.<forecastBeginTime>0</forecastBeginTime> - Sets delay before weather animation/weather change in milliseconds. Type - integer. Default is
0 (0 ms).<interval>15</interval> - Available in the UI. Sets the interval time of automatic conditions refresh in minutes. Type - integer. Default value is
15.<left>xxx</left> and <top>xxx</top> - Works if
<position>7</position> is set to 7. Sets where the widget will be shown. Configurable by moving the widget. Type - integer. Number of screen pixels from the left and top respectively.<locale>en-US</locale> - Available in the UI. Sets the language of the widget to be shown in. Type - string. You can get new localizations
here.<locationcode></locationcode> - Not recommended to be set by hand, UI is preferred. Syntax is the end of an RSS URL for the current conditions (AccuWeather: http://karls.accu-weather.com/widget/karls/city-find.asp?location=blablabla | MSN:
http://weather.msn.com/find.aspx?weasearchstr=blablabla).<locked>false</locked> - Available in the UI (context menu). Sets should the widget will be locked on it's position and become unmovable, or not. Type - boolean. Default is false.<mouseDragMode>0</mouseDragMode> - Sets mouse drag mode. Type - boolean integer.
0 stands for animation slow down while dragging. If set to 1, the animation will not slow down, but the widget will jump down from the top edge.<opacity>1</opacity> - Sets widget's opacity. Type - integer. Default is
1. Valid values vary from 0 (0.0) (transparent) to 1 (1.0) (opaque).<position>3</position> - Available in the UI. Sets where the widget will be shown. Type - integer.
0 - top left, 1 - bottom left, 2 - top center, 3 - center,
4 - bottom center, 5 - top right, 6 - bottom right, 7 - custom. Default is
3.<refreshWeatherAnimInterval>0</refreshWeatherAnimInterval> - Sets weather animation refresh interval. Type - integer. Default is
0 (play once). Valid values - any. The animation will repeat the number of times you specify. If set to
-1, the animation will repeat in a loop infinitely.<scaleFactor>1</scaleFactor> - Available in the UI (partially). Sets the widget's size. Type - integer. Default value is
1. Valid values vary from 0.1 (very small) to 9.9 (very large, though that size will be out of bounds).<showForecast>true</showForecast> - Available in the UI. Sets should the 5-day weather forecast will be shown or not. Type - boolean. Default is true.<sunrise>4</sunrise> - Sets when the sun will be shown. Type - integer. Default is
4 (4:00 or 4:00 AM). Note: only for MSN.<sunset>22</sunset> - Sets when the moon will be shown. Type - integer. Default is
22 (22:00 or 10:00 PM). Note: only for MSN.<timeMode>0</timeMode> - Available in the UI. Sets 24 and 12-hour time format. Type - boolean integer.
0 stands for 24 hour and 1 stands for 12 hour.<topmost>false</topmost> - Available in the UI. Sets should the widget will be shown on top of other windows or not. Type - boolean. Default is false.<weatherProvider>Accuweather</weatherProvider> - Sets which weather provider will be used. Type - string. Valid values are
Accuweather and MSN.<dateString>ddd, MMM d</dateString> - Sets the date format shown. Type - string. Valid values are any combination of these:
ddd - day of the week, MMM - month, d - day of the month. Default is
ddd, MMM d.<useAlternativeBase>true</useAlternativeBase> - Sets alternative clock background that depends on the current time. Type - boolean.

NewsWidget.conf

<Sources><string></string></Sources> - Sets the RSS URLs to read. Type - string. To use multiple feeds, specify multiple
<string></string> parameters. Defaults are the URLs of the releases and discussions updates.<Left>xxx</Left> and <Top>xxx</Top> - Sets where the widget will be shown. Configurable by moving the widget. Type - integer. Number of screen pixels from the left and top respectively.<FeedsCount>5</FeedsCount> - Sets the number of feeds to receive from one source. Type - integer. Default is
5.<MaxItems>25</MaxItems> - Sets the maximum number of feeds shown. Type - integer. Default is
25.<Interval>10</Interval> - Sets the interval time of automatic feeds refresh in minutes. Type - integer. Default value is
10.<Scale>1</Scale> - Sets the widget's size. Type - integer. Default value is
1. Valid values vary from 0.1 (very small) to 9.9 (very large, though that size will be out of bounds).<Locale>en-US</Locale> - Sets the language of the widget to be shown in. Type - string. You can get new localizations
here.<opacity>1</opacity> - Sets widget's opacity. Type - integer. Default is
1. Valid values vary from 0 (0.0) (transparent) to 1 (1.0) (opaque).