OnwijsMenu Configuration OverView

v5.0c

Configuration

(Global attributes)

- - - General - - -
PackageVersion string

Version of the package that is shown in the menu.
PackageID string

Identifier for the menu/package.
PackageCountry string
NL
Country or region the menu is aiming at.
Note: this can be different from the Language setting. Note: this can be different from the Language setting.
- - - Appearance - background - - -
Background
BackgroundVideo
BackgroundImage
AchtergrondPlaatje
string
background?.jpg
Background image.
BackgroundColor string
#80000000
Color of the transparent area which contains the icons.
HighlightColor string
#8000ff00
Color for the background of a selected item.
HideBackground bool
true
Hides the background, as alternative for the blurred background in tranquil mode.
This means it only works in tranquil mode.
ScreenBackgroundColor string
#00000000
Color of the menu background screen, used when HideBackground is true.
RelAppAreaSize double
0.85
Relative size of the area in which the menu items are placed.
AppAreaPadding double
0
Extra space around the icons for the app area.
AppAreaCornerRadius double
0
CornerRadius for rounded corners on the area in which the menu items are placed.
- - - Appearance - icons - - -
IconSize
IconMaat
double
240
Size of the icons.
If this value is 0 the application finds the optimal size.
RelIconDistance double
1.5
Relative distance between icons if RandomPlaces is true, to prevent overlapping icons.
For round icons this could be 1 or larger, for square icons this could be 1.41 or larger.
RandomOrientation bool
true
Puts the menu item at a random angle.
Only works if RandomPlaces is true.
StretchIcon bool
true
Toggles the stretch mode for the icons.
For images that are not square this can be set to false.
CenterItems bool
true
Centers the items on the menu, also when it has more lines.
RelItemMargin double
0.15
Relative margin around the items within the defined (or calculated) ItemSize.
In most cases this should be a value larger then 0 and smaller then 0.5.
RoundText bool
false
Flag that indicates if the text is set in a circle around the item or not.
RoundTextAnimationTime int
0
Time in seconds the round text on a menu item takes for one full rotation.
The default value is 0, which means the text won't rotate.
DoubleText bool
false
Flag that indicates if the text is shown on both sides (top and bottom) of the icon image.
RoundIcon bool
false
Makes all the icons round.
IconShadow bool
false
Adds a shadow to the application icons.
Currently only works in standard grid menu (no layout, random or circle).
IconShadowOpacity double
0.67
Opacity of the shadow of the application icons.

CreateIconFolder bool
false
Only works during the creation of an applist.
Creates a folder called _icons and copies all icons from applications there, while creating a new applist.
- - - Appearance - miscellaneous - - -
NumRow
AantalRijen
int
0
Number of rows.
If this value is 0 the application finds the optimal number.
NumCol int
8
Number of cols.
This value is only used on a scrolling menu layout.
Animation
Animatie
bool
true
Toggles the idle animation.
AnimationType enum
Rotate
- Rotate
- Grow
- Video
- Circle
- Tilt
- Jump
- None
Type of idle animation.
ShuffleItems bool
false
Shows the menu items in a random order.
SortItems bool
false
Shows the menu items in alphabetical order (overrides ShuffleItems).
SkipIdle bool
true
Skips an idle animation on every cycle.
FullScreen bool
true
Shows the menu full screen (or not).
DoubleScreen bool
false
Spreads the menu window over two screens.
SwapScreen bool
false
Swaps the screen setup if the primary screen is on the right.
Used if DoubleScreen is true.
ShowCopyright bool
true
Includes the name Onwijs in the copyright notice on the StopScreen.
Fairly redundant.
Language string

Identifier string for a certain language setting, defining the language-[??].xml file with the translated texts.
Example:
EN loads the translation from language-EN.xml.
RandomPlaces bool
false
Puts the menu items on a random place on the screen.
DailyApp bool
false
Flag that indicated if a daily up is added to the main menu.
This is only usefull with layered menus.
ButtonBackgroundColor string
#40000000
Background color for the buttons (Mode, Info) on the main screen.
UseTranquilMode bool
false
Enables the tranquil mode for the menu background.
By default this is false, because it probably isn't really necessary (so some work done here was in vain).

TranquilLogos bool
true
Changes the background logos to greyscale versions in tranquil mode.
TranquilLogoOpacity double
0.25
Sets the opacity of the logo images in tranquil mode.
HideWarning bool
false
Hides the license warning - but still may deactivate applications.
ShowDate bool
true
Toggles the visibility of the current date on the menu screen.
ShowTime bool
false
Toggles the visibility of the current time on the menu screen.
ShowSeconds bool
false
Shows seconds in the time display (if it is visible).
SkipRemovePreLicenseContent bool
false
Skips the removal of so-called pre license content (see documentation for more info).
ForceRemovePreLicenseContent bool
false
Forces the removal of so-called pre license content (see documentation for more info), before checking the license (for testing purposes only).
ScreenLayout enum
Empty
- None
- Grid
- Circle
- Layout
- Random
- Scroller
- PageFader
- PageScroller
- Empty
Indicates the type of layout, overriding other settings.
ScrollerMargin double
0
Margin to the sides of the screen for the scroll window if ScreenLayout is set to Scroller.
- - - Circle layout - - -
CircleLayout bool
false
Arranges the icons in a rotating circle instead of a rectangular grid.
This only works for a number of about 5-15 applications.
CircleSpeed double
5
Rotation speed of the circle if CircleLayout is true and CircleRelWidth is 1.
CircleRelSize double
0.75
Size of the menu circle, relative to the height or width (whatever is smallest) of the screen.
CircleRelWidth double
1
Changes the width of the circle, relative to the height (making it an ellipse).
This only works if CircleSpeed is 0.
- - - Text properties - - -
FontColor string
#ffffff
Color of the title text.
RelFontSize double
0.083
FontSize relative to the IconSize.
FontSize int
-1
Size of the title text.
Default IconSize / RelFontSize.
FontFamily string
Nunito Black
Name of the font or font file of the title text.
FontWeight enum

- ExtraBold
- Bold
- DemiBold
- Normal
- Light
- ExtraLight
FontWeight for the title text.
Default is empty, which means Normal weight.
TextAlignment enum
Center
- Center
- Left
- Right
- C
- L
- R
Alignment of multiline text
LineBreak string
[br]
String (one or more characters) that functions as linebreak in a menuitem title.
TextOutlineSize int
0
Thickness of the outline around the title text.
Only works for round text (for now).
Note: A large OutlineSize will affect the time the application takes to start (4 is a reasonable max). Note: A large OutlineSize will affect the time the application takes to start (4 is a reasonable max). Opacity only works for very low opacity values.

TextOutlineColor string
#ffffff
Color of the outline around the title text.
Only works for round text (for now).
ShowTitle bool
true
Defines whether the title text is visible.
- - - Behaviour - - -
DebugMode bool
false
Toggles the debug mode.
StayOnTop bool
true
Puts the menu window always on top.
MainMenu
HoofdMenu
string
x
[Obsolete] Path to the parent menu executable.
Only used for submenus and mostly redundant.
IsMainMenu
IsHoofdMenu
bool
false
[Obsolete] Indicates if a menu is the top level menu, meaning there is no parent menu.
MaxSearchLevel int
2
Number of (directory) levels the menu should search for applications.
If there are submenus this value should (almost) always be 2.
HideTaskBar bool
true
Flag that defines whether the taskbar should be hidden when the application starts.
In a top level menu this value should be true.
Only define this value if the normal behaviour (hide the taskbar) should be overridden.
ShowTaskBarOnExit bool
true
Flag that defines whether the taskbar should be shown after the application exits.
In a submenu this value should be false.
Only define this value if the normal behaviour (show the taskbar if it is a top level menu, don't show if it is a submenu) should be overridden.
CreateSchema
SchemaHelp
bool
false
Flag that sets whether the xml-schema for this file should be created, along with an alternative configfile (MenuConfig_full.xml) with all the possible (root) attributes.
CreateDocumentation bool
false
Flag that sets whether an html-file with documentation should be created.
CreateLanguageFile bool
false
Flag that sets whether an xml-file with language information should be created.
ApplistEnabled bool
true
Toggles the applist functionality.
In some cases (old TipTile Maker) the applist causes problems.
CheckLocal bool
true
[Unused] Checks if the system is on a local site (our office) or not.
This is only relevant for development purposes, but if the check causes problems it can be switched off.
SystemInfo bool
false
Toggles the function that retrieves system information and saves it to devices.xml.
Key string

Used with a demo-version of a package.
This indicates the number of days the applications in the menu are still available, stored in an encoded string.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
Camera string

Fake key that indicates that the package is a demo-version.
The value can be True or False but doesn't matter, just the presence of this attribute.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
ProtectionCode string

.
CloseExplorer bool
false
Closes the explorer process tree as the menu starts and restarts it on closing.
AppMode enum
flat
- flat
- up
- tranquil
Application mode for the menu and the underlying applications.
Current options are Flat (default) and Up (upright).
This can be extended to other modes, like high contrast.
Extra options can be appended as a pipe delimited list.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
MonitorEnabled bool
true
Defines whether the OnwijsMonitor should be started or not.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
ShellEnabled bool
true
Defines whether the OnwijsShell should be started or not.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
EditLevel enum
None
- Disabled
- None
- Basic
- Complete
- Mode
- Settings
- ProSettings
- FullSettings
- Edit
Sets the edit capabilities for this menu.
Option are:
None - you can't edit anything, Basic - you can hide and unhide listings, Complete - you can remove listings.Additional (more flexible) options are Mode, Settings, FullSettings and Edit, which describe the features in the corresponding screens (pincode).
These may change over time.
The first four options are obsolete.
AutoClose bool
false
Closes the menu directly after an application closes (thus returning to a higher level menu).
DeactTime int
300
Time of inactivity (in seconds) after which the application closes.
ToggleBlueTooth bool
false
[Obsolete] Switches the bluetooth function off and on, to make sure it is working on systems with a bluetooth poblem.
ModeVisible bool
false
Toggles the visibility of the mode button(s).
TranquilModeVisible bool
false
Adds the option to switch between tranquil and standard backgrounds to the mode screen.
InfoVisible bool
false
Toggles the visibility of the info button(s).
ShutDownVisible bool
false
Toggles the visibility of the shutdown button(s).
ShutDownCodeVisible bool
false
Toggles the visibility of the shutdown code in the pin code screen.
DisableStylus bool
true
Disables input from the stylus, to avoid interference with touch input.
NFCEnabled bool
false
Initializes the NFC functionality.
SwitchBackVisible bool
false
Toggles the button which switches backgrounds.
CheckWeb bool
false
Checks for an internet connection and displays a warning if no connection is found.
MessageMargin int
0
Margin of the demo or web warning message.
By default the margin is based on the place and size of the stop logo.
MessageWidth int
480
Width of the border around the demo or web warning message.
AppLogEnabled bool
true
Logs the starting and closing of applications.
This may help check for any problems with a menu.
IsTablet bool
false
Flag that indicates the system is running on a tablet.
UseCamera bool
false
Flag that indicates if a camera, if available, should be used.
ForceShutdown bool
false
Flag that indicates if the menu application should shut the system down when the shutdown code is entered.
Used temporarily as long as the Monitor doesn't handle this.
ShowUpdateMessage bool
false
Forces the application to check for an update and show a dialog.
InstallControlType enum
StartUpOnly
- StartUpOnly
- AnyMoment
Flag indicating when an update can be installed.
When the value is AnyMoment a dialog will be shown when an update is available.
Current options are StartUpOnly and AnyMoment.
IsEditable bool
false
Flag indicating if the menu can be edited by a user (if not part of a package).
- - - Close buttons & logos - - -
CloseButtons
StopKnop
bool
true
Flag that shows the close buttons.
CloseButtonSize int
32
Size of the close buttons.
StopLogo bool
true
Flag that defines whether the logo image at the bottom of the screen opens up the stopscreen when tapped.
StopLogoSize int
150
Size of the logo image at the bottom of the screen.
StopLogoMargin double
0
Distance from the logo image to the edge of the screen.
StopLogoOpacity double
0.8
Opacity of the logo image at the bottom of the screen.
SideLogo bool
false
Flag that switches from the normal appearance of the stop logo to a layout with logos at the left and right side of the screen.
ShowTopLogo bool
true
[Redundant] Toggles the visibility of the logo at the top of the screen, for a true 360° interface.
Alternative for ThreeSixtyInterface.
ThreeSixtyInterface bool
true
Toggles the visibility of the logo at the top of the screen, for a true 360° interface.
Better alternative for ShowTopLogo.
StopCount int
1
Number of simultaneous touches that triggers the pin code screen.
Default is 1, which means that one touch (or mouse click) is enough.
- - - Stop screen - - -
SystemPinCode
PinCode
string
0000
Pin code that shuts down the screen.
MenuPinCode
AfsluitPinCode
string
3255
Pin code to close the menu application.
LiftPinCode string
1111
Pin code that opens the lift control.
(not functioning yet)
CanTilt bool
true
Flag that sets whether the screen can tilt.
If it is true the lift control will also show tilt buttons.
(not functioning yet)
TipTilePinCode string
TIPT
Pin code to open the TipTile installation screen.
Used to override the default pin code.
AppMakerPinCode string
APPS
Pin code to open the AppMaker installation screen.
Used to override the default pin code.
- - - Menu name - - -
ShowMenuName bool
false
Flag indicating if the name of the menu should be shown on the screen.
MenuName string

Name of the menu to be displayed on screen.
If left empty the name is taken from an applist of a parent menu or the name of the folder (without prefix) is used.
MenuNameFontSize int
32
Font size of the menu name displayed on the screen.
MenuNamePosition enum
Corner
- Corner
- Center
- XY
Position of the menu name displayed on the screen.
MenuNameX int
-1
X-coordinate of the center of the menu name displayed on the screen.
MenuNameY int
-1
Y-coordinate of the center of the menu name displayed on the screen.
MenuNameOrientation int
0
Orientation of the menu name displayed on the screen.
MenuNameBackground string
#00000000
Background color of the menu name displayed on the screen.
- - - Sound settings - - -
VolumePinCode string
8888
Pin code that opens the volume control.
Volume int
70
The overall sound volume (on a scale of 100).
This overrides the system volume.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
VolumeVisible bool
true
Shows volume control on menu screen.
VolumeBackgroundColor string
#40000000
Background color for the volume control on the main screen.
- - - Statistics - - -
StatPinCode string
STAT
Pin code that opens the statistics screen.
Only useful if SaveStats is true.
SaveStats bool
true
Flag that sets whether statistics should be recorded.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
SendStats bool
true
Uploads the statistics to the SovaStats server.
StatsFolder string

Name of the menu or package (folder).
This will be retrieved automatically if left empty.
- - - Web - - -
WebEnabled bool
false
Adds a browser button to the menu.
[NOTE:
this isn't functioning properly yet because of interference with Metrokiller]
WebButtonVisible bool
false
Shows the web button on the menu screen (as well as on the pin code screen).
BrowserPath string
C:\Program Files\Mozilla Firefox\firefox.exe
Path to the browser application, if different from the default one (Firefox).
This could also be the WebView app in the resources folder.
WebStartUrl string
www.duckduckgo.com
Start page for the web browser.
WebPinCode string
-----
Pincode to toggle the visibility of the web browser button.
Giving this a valid (4 character) value automatically enables the webfunctionality.
WebViewStart bool
true
Toggles the functionality that automatically starts a WebView from a central place (in Resources).
This way separate WebView-applications won't all have to have the complete collection of files necessary for the application to run.
- - - Background application - - -
BackgroundAppPath string

Full path to an application that can be used to play music in the background for the whole menu.
(ex:
Spotify)
BackgroundApp string

Application that can be used to play music in the background for the whole menu.
(ex:
Spotify) This is an alternative for BackgroundAppPath, which doesn't work for Windows Store apps.
Store apps can't be started from the menu, so they should be started on startup.
- - - Update - - -
AutoUpdate bool
false
[Obsolete]Toggles the automatic update function.
TestUpdate bool
false
[Obsolete]Tests the automatic update function.
This value will be reset to false after the test.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
ShowUpdateResult bool
false
[Obsolete]Shows a message after a test update.
This value will be reset to false.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
LastUpdateVersion string

[Obsolete]The version for the last update attempt.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
LastUpdateTime string

[Obsolete]Time of the last update attempt.
This is checked to avoid an update loop.
[Should be in MenuSettings.xml instead of MenuConfig.xml]
CheckForUpdate bool
false
[Obsolete]Enables the functionality to check if an update is available.
- - - ScreenSaver - - -
ScreensaverApp string

Application that is used as screensaver.
Currently it has to be visible in the menu.
ScreensaverTime int
300
Time (in seconds) after which the screensaver starts.
Resets when the screen is touched.
- - - Installers - - -
TipTileEnabled bool
false
Toggles the TipTile download functionality.
ExtraTipTiles bool
false
Shows a list of additional TipTiles (created by Onwijs) on the TipTile-loader screen.
ExtraKey string
QlRfTkxAb253aWpzLmNvbQ==
Encoded login data for extra TipTiles (additional TipTile created by Onwijs).
SharedTipTiles bool
false
Shows a list of shared TipTiles (created by other creators) on the TipTile-loader screen.
SharedKey string

Encoded login data for extra TipTiles (created by other creators).
AppMakerEnabled bool
false
Toggles the app installer functionality.
ViewMakerEnabled bool
true
Toggles the visibility off ViewMaker apps in the list of new apps.
Works in combination with AppMakerEnabled.
GameMakerEnabled bool
false
Toggles the visibility off GameMaker apps in the list of new apps.
Works in combination with AppMakerEnabled.
MapViewEnabled bool
false
Toggles the installation functionality for MapView (Note: MapView doesn't have cloud support yet).
BookViewEnabled bool
false
Toggles the installation functionality for BookView (Note: BookView is still in the development stage).
PDFViewEnabled bool
false
Toggles the installation functionality for PDFView (Note: PDFView is still in the testing stage). Default is taken from the AppMakerEnabled value.
This can override that value.
RouteViewEnabled bool
false
Toggles the installation functionality for RouteView (Note: RouteView is still in the development stage).
SlideViewEnabled bool
false
Toggles the installation functionality for SlideView.
Default is taken from the AppMakerEnabled value.
This can override that value.
VideoViewEnabled bool
false
Toggles the installation functionality for VideoView.
Default is taken from the AppMakerEnabled value.
This can override that value.
WebViewEnabled bool
false
Toggles the installation functionality for WebView.
Default is taken from the AppMakerEnabled value.
This can override that value.
AddMenuEnabled bool
false
Toggles the installation functionality for a new OnwijsMenu.


Logo

(Attributes that can be defined in Logos)

A Logo is an image that can be placed on the menu background. In ThreeSixtyDegrees mode it will be shown mirrored (vertical).
ImageFile string

File containing the image.
CenterX int
0
X-coordinate of the center of the image.
CenterY int
0
X-coordinate of the center of the image.
Size int
120
Size of the image or text.
This sets the largest dimension (width or height), scaling the other accordingly.
Width double
-1
Width of the image or text.
Height double
-1
[redundant] Height of the image or text.
This overrides Size.
If LogoWidth and LogoHeight are both -1 Size is used.
Orientation
Angle
int
0
Orientation of the image.
Opacity double
1
Opacity of the image.
RotateTime double
0
Number of seconds the image takes to rotate.
Zero means no rotation.
OnTop bool
false
Puts the image on top of all other items on the screen.
DoubleSided bool
true
Defines whether the image is shown from both sides if ThreeSixtyDegrees is true.
Action string

Turns an image into a button.
Current supported actions are:
- Close - StartApp:
[appname] and StartAppAndClose:
[appname].
NeedsCamera bool
false
Flag that indicates if the declared Action (application) needs a camera available.
If true and a camera is not available it will hide this logo image.
NeedsInternet bool
false
Flag that indicates if the declared Action (application) needs an internet connection.
If true and an internet connection is not available a warning will be shown.
SkipCheck bool
false
Skips the file check on an action that starts an application.
If the defined file doesn't exist the logo image isn't shown.
This can be skipped for special cases where the file to be started is recognized by Windows just by its file name, like iexplore.exe or edge.exe.
Text string

Text that is displayed, instead of an image.
Font string
Nunito Black
Font family for the text, if text is defined.
FontColor string
#ffffff
Color of the text, if text is defined.
FontWeight string

Weight of the text, if text is defined.
Shadow bool
false
Adds a shadow to a logo image or text.
ShadowOpacity double
0.67
Opacity of the shadow of a logo image or text.

BackgroundColor string
#00000000
Background color of the text, if text is defined.
TextSpacing double
0
Added space (in pixels) between characters of a text, if text is defined.


Layout

(Attributes that can be defined in Layout)

Layout is an alternative way to display menu items on the screen.
Width int
1200
Width of the app layout screen.
Height int
800
Height of the app layout screen.
RelSize double
0.9
Relative size of the app layout screen, compared to the entire screen.
Margin string

Margin around images in layout items.
Default value is 10% of the item size.
TextMargin int
-24
Margin of the text within the app icon.
A negative value puts the text outside (below) the icon.
RelFontSize int
12
Divider used to calculate the fontsize if the fontsize isn't defined .
The size is calculated as IconSize / RelFontSize.
FontSize int
-1
Size of the text as an absolute value.
Default value is IconSize / RelFontSize.
FontColor string
#FFFFFF
Color of the text for a layout item.
ShowTitle bool
true
Defines whether the title text is visible.
VideoVolume double
0.25
Volume of the menu videos.
ResetIconTime int
0
Time (in seconds) after which an icon resets to the StartIcon (if this is defined).


Layout Item

(Attributes that can be defined for items in Layout)

Layout items can be independantly scaled and placed on the screen.
ImageFile string

File containing the image.
CenterX int
0
X-coordinate of the center of the image.
CenterY int
0
X-coordinate of the center of the image.
Size int
120
Size of the image or text.
This sets the largest dimension (width or height), scaling the other accordingly.
Width double
-1
Width of the image or text.
Height double
-1
[redundant] Height of the image or text.
This overrides Size.
If LogoWidth and LogoHeight are both -1 Size is used.
Orientation
Angle
int
0
Orientation of the image.
Opacity double
1
Opacity of the image.
RotateTime double
0
Number of seconds the image takes to rotate.
Zero means no rotation.
TextMargin int
-24
Margin of the text within the app icon.
A negative value puts the text outside (below) the icon.
Shape string

Shape of the item.
Only available option now is Circle.
Note: this is not necessarily the shape of the image. Note: this is not necessarily the shape of the image.
VideoFile string

Optional video file.
Text string

Text to be displayed - if different from the app name.
Tag string

Tag id that will activate this item.
StartIcon string

Icon that is displayed until the application is opened.
EndIcon string

Icon that is displayed after the application is opened.

(238)