Install Guide NET Client

From Xibo
Jump to: navigation, search



Before attempting to install the Xibo Client please ensure the following prerequisites are met.

  • A network connection to the Xibo Server (possibly over the Internet)
  • Microsoft Windows 2000/XP/Vista/7
  • .NET Framework v3.5 SP1
  • Internet Explorer 7 or 8
  • Flash Player Version 9 or later
  • Windows Media Player 11 or later
  • For Powerpoint support, Microsoft Powerpoint 2003 or later. Powerpoint viewer is not suitable.


Step 1

You may see the following security warning when installing Xibo.


Please click on "Run" to begin the installation.

Step 2

The installer presents a welcome screen:


Please press "Next".

Step 3

Choose the location where Xibo should be installed. The default location should normally be sufficient, however to change the location click browse.


After making the selection (or if leaving to the default) click "Next" to continue.

Step 4

A confirmation message is then shown


When happy with the selections made click "Install" to begin. Otherwise click "Back" to correct any errors.

Step 5

The Installation is complete. Click finish to exit.



Client Options Dialogue
  • Open the client configuration dialogue by going to "Start -> Programs -> Xibo Player -> Xibo Client Options"
  • Fill in the address of your Xibo server in the "URI of the Xibo server" box. If your Xibo server is on the same machine as the client, enter "http://localhost/xibo" or similar. If Xibo server is installed on a different computer, enter the IP address or hostname of the machine the Xibo server is installed on - for example "" or "" or similar.
  • Enter your server key in the "The server key for the Xibo server" box. If you can't remember the key you'll find it in the Settings dialogue on the Management menu in the web interface on the server.
  • The "Local Library Location" defaults to a folder called "Xibo Library". It's used to cache content from the Xibo server so that the client can continue to play if the connection to the Xibo server is lost. If you want to change to a different folder, use the "Browse" button to choose an alternative. Note that you must NOT use the server's library location (if it's on the same PC as the client or via a file share)
  • "The collection interval for content" is the interval in seconds that the client will poll the server for new content. The more frequent the collections, the quicker the client will update when changes are made on the server - but at the expense of bandwidth and possibly minor freezes in things like scrolling text when the collection happens. We don't recommend values lower than 60 seconds.
  • "The unique key for this client" is a unique identifier for this client machine. It's generated from a mix of Windows system identifiers and your hardware. If you're installing for the first time, there's no need to amend this value. If you're changing hardware or want to have two clients using the same server account then you can edit the key as required.
  • "Scroll step amount" is the number of pixels scrolling text will move by each time scrolling text items are told to move. You should leave this set to 1px.
  • Tick the "Enable Powerpoint" box if you have the full version of PowerPoint 2003 or later installed and want to use PowerPoint media items. Be sure to read the notes on Powerpoint setup here: Windows Modifications.
  • Tick the box if you want the client to send statistics back to the Xibo server. This will generate alot of data that will be stored in the Xibo database. If you don't have any specific use for statistics, we recommend you turn this option off.
  • Click the "Save" button.
  • If you use a proxy server to access your Xibo server, go to the "Proxy Server" tab and fill in the details for your network, then click "Save". Make sure to set your proxy information in Internet Explorer too.
  • Finally go to the "Register Display" tab.
  • Optionally rename the client by entering a name in the "Display Name" box. It defaults to the hostname of the PC.
  • Click the "Register" button.
  • You should see a message "Display registered and awaiting licensing".
  • If you don't get that message, ensure you entered the correct URL for the Xibo server, and that your server key is entered correctly.
  • Now log in to the server web interface, go to the Management Menu and then "Displays".
  • You should see your newly registered client in the list. Click the "Edit" button next to the display.
  • The "License Display" option will automatically swap to "Yes".
  • Optionally select a different default layout (the layout the client will play if nothing is scheduled).
  • Click "Save"
  • You can now start the Xibo Client software. It should show you the Xibo splash screen while the default layout (and anything else you have scheduled) is downloaded and then begin playing layouts.

Windows Modifications

Here are some suggested settings for Windows / Powerpoint for a Display Client:

  • Turn off all screensavers
  • Turn off screen power saving
  • Load the "No Sounds" Sound Scheme (Control Panel -> Sounds and Audio Devices Properties)
  • Set a plain wallpaper (Hopefully nobody will see it, but you might need to reboot a client, or restart Xibo and a sane wallpaper is a help :D
  • If the client is accessible from where you manage your displays from, you might want to install UltraVNC server so you can connect in and check on the client from time to time. Use the "View only" option in the VNC client to avoid disturbing the display.
  • Set Windows to log on as your display client user automatically
  • Disable balloon tips in the notification area
  • Disable Windows Error Reporting. Occasionally Powerpoint seems to "crash" when Xibo closes it. Unfortunately this leaves an unsightly "Powerpoint has encountered a problem and needs to close" message on the display. Follow the steps here to disable Windows Error Reporting completely - including notifications.
  • Also disable Office Application Error reporting. Follow instructions at KB325075 or merge this registry patch.

If you're using Powerpoint, then there are a couple of extra steps:

  • The first time you run Xibo with a Powerpoint, you might get a popup appear that asks what Xibo should do with the Powerpoint file. The popup actually originates from Internet Explorer. Choose to "Open" the file, and untick the box so you won't be prompted again.
  • In some circumstances, you may find that Powerpoint, the application, loads instead of the file opening within Xibo itself. If that happens, try merging this registry patch. (Taken from Users of Powerpoint 2007 should go to Microsoft KB927009 and run the FixIT application instead. Users of PowerPoint 2010 should go here instead KB982995
  • Note also that Powerpoint will put scroll bars up the side of your presentation, unless you do the following for each Powerpoint file BEFORE you upload it:
 o Open your Powerpoint Document
 o Slide Show -> Setup Show
 o Under "Show Type", choose "Browsed by an individual (window)" and then untick "Show scrollbar"