Command line options for Player for Windows

    Player Command Line Arguments

    The following are the arguments and corresponding options you can use when launching IntuiFace Player for Windows from the command line. This is particularly useful when using a .bat file or Windows shortcut.

    NOTE: All of these command line arguments are case sensitive. Type them exactly as you see them written here.

    Please refer to the Player Configuration file article for details regarding the use of the IntuiFacePlayerApp.exe.config file instead of command line options.

    Specify the screen(s) to use by the Player in a multi-screen setup

    Use either - but not both - of the following two options:

    • /extendeddisplay
      Will expand your experience to run across all displays connected to the Windows PC. This option is usually used in conjunction with either the /playLastExperience option or with the path to a specific IntuiFace experience.

    OR

    • /ownerscreen=[ScreenID]
      Replace "ScreenID" with the integer corresponding to the display on which display you want IntuiFace Player to run. For this option, you must specify which IntuiFace experience to play; see example below.

    NOTE: By default, IntuiFace Payer will run on the main display, where ScreenID=0.
    To find out a screen's ID, see this article and then subtract 1 from the derived value. However, we find these numbers to occasionally be inaccurate, so it's best to cycle through numbers, starting with 0 for the main display.

    Specify the size and position of Player within the desktop

    • /x=[pixels] and /y=[pixels]
      Specify the horizontal and vertical distance, measured in pixels, that Player's upper-left corner should be from the upper-left corner of the display. Only positive values are accepted. For example, to locate Player's upper-left corner at 250 pixels to the right and below the upper left corner of the display, use /x=250 /y=250.
    • /width=[pixels] and /height=[pixels]
      Specify the width and height of Player, measured in pixels. Only positive values are accepted. For example, to set Player's size to 1024 x 768, use /width=1024 /height=768.

    When using a multi-screen setup, the /extendeddisplay argument must be used in combination with the w,y position arguments. The /ownerscreen=[ScreenID] argument will not be taken into consideration when using x, y position arguments.

    NOTE: To correctly calculate the size and position of IntuiFace Player, the "Scale and layout" "Display" settings of Windows must be set to "100%". Otherwise, IntuiFace Player could be displayed in a wrong location.

    Specify which experience to play

    Use either - but not both - of the following two options:

    • /playLastExperience
      Will restart the most recently run IntuiFace experience.

    OR

    • "c:\full\path\to\your\experience\your-experience.ifx"
      A reference to a specific IntuiFace experience. Include the double quotes. For a look at the structure of an IntuiFace project, see this article.

    When neither of these two options is used, Player will launch and display the Experiences panel - with one exception. If - in the Share and Deploy console - the option "Run the last opened experience" is turned on for this Player, that option will override a launch into the Experiences panel.

    Hide the Player from Windows Task-bar

    If you do not want to see the Player on Windows Taskbar you can use the following command line:

    • /hideintaskbar - using this command, will hide the Player from Windows Task-bar

    Additional Notes

    For information about how to run IntuiFace Player on a Windows PC in "kiosk mode", review this article

    For information about how to run IntuiFace Player on a multi-screen display wall, review this article

    Examples

    "C:\Program Files\IntuiLab\IntuiFace\Player\IntuiFacePlayerApp.exe" /ownerscreen=1 "c:\full\path\to\your\experience\your-experience.ifx"
    This will launch IntuiFace Player on the display with Screen ID=1 with the specified experience.

    "C:\Program Files\IntuiLab\IntuiFace\Player\IntuiFacePlayerApp.exe" /ownerscreen=1 /width=1024 /height=768 "c:\full\path\to\your\experience\your-experience.ifx"
    This will launch IntuiFace Player on the display with Screen ID=1, set Player's size to 1024 x 768, and run the specified experience.

    "C:\Program Files\IntuiLab\IntuiFace\Player\IntuiFacePlayerApp.exe" /extendeddisplay /playLastExperience
    This will launch IntuiFace Player across all displays connected to the Windows PC with the last used experience.

    Limitations

    If using command line options:

    • Do not rely on the Share and Deploy console to automate deployment, as the command line options are not managed. Instead, you may use the Player Configuration file but only one configuration file can be defined, so you cannot setup several configurations for several players running on the same PC.

    If you attempt to run multiple Players on the same PC:

    • do not use the Share and Deploy console to manage your Players.
    • do not use Data Tracking, as only one player may track data
    • do not use Remote Action, as only one Player (the one which was launch first) will receive Remote action
    • If one Player instance crashes, the IntuiFace Player Agent service running in the background will first kill all other running Player instances and then randomly relaunch only one, displayed on the main screen. We strongly recommend that you uninstall the IntuiFace Player Agent application to avoid unpredictable behavior if you intend to run multiple Players on the same PC at the same time.
      NOTE: Every time you update IntuiFace Player, the IntuiFace Player Agent service will be automatically reinstalled and run. Thus, after every Player update, you'll have to again uninstall the agent.

    Player Installer Command Line Arguments

    If you would like to automate the installation of Player for Windows, you must use both of the following options to ensure the installation is fully silent:

    • /VERYSILENT
    • /SUPPRESSMSGBOXES

    NOTES:

    • It also possible to uninstall the player silently with the same option. The uninstaller is located in the player installation folder. So typically the command to uninstall the player silently is the following: "C:\Program Files\IntuiLab\IntuiFace\Player\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES
    • For the silent installation of Player for Windows Version 5, use the option /QUIET instead of the two arguments listed above for Version 6.