====== PIXILAB Player with developer tools======

Sometimes it is useful to create a player with settings that enables some tools for trouble-shooting.
SSH access to the player, toolbars and developer tools  can come in handy while testing scripts and hardware.  

Follow the [[blocks:porteus_kiosk|guide to build a standard kiosk]] but use the settings provided here.

=== Configuration File ===

Use the text file method to configure the player, edit and copy the text shown below to another FAT32-formatted USB stick. Put it at the root level of the USB stick, naming it //kiosk-config-dev.txt// or any other describing name. 

<code>
connection=wired
dhcp=yes
browser=chrome
homepage=http://pixi.guide/spot
disable_private_mode=yes
wake_on_lan=yes
disable_zoom_controls=yes
persistence=session
primary_keyboard_layout=us
additional_components=uefi.zip initrdpxe.xz 08-ssh.xzm
root_password=pixi
hide_mouse=no
disable_navigation_bar=no

</code>

The differences compared to a standard setting are:
  * Add 08-ssh.xzm module to enable SSH.
  * Set root-password for SSH access.
  * Show the mouse
  * Show the navigation bar





==== Using SSH ====

In case you need to access the player with SSH, you first have to find its IP number. This can be found in the Blocks editor under Display spot settings/Information

To log on, use a ssh enabled terminal window. 

:!: On Windows, you must enable //OpenSSH Client// under "Windows optional features".


<code>
$ ssh root@[ipnumber]
</code>
Enter the password specified in the kiosk-config file.

On your computer used to access the player over SSH, you may have to reset the //known_hosts// file. That is because the hash identifying the player changes on each restart. To do so:

  - Open the //known_hosts// file  stored under your user in a hidden folder called //.ssh//  using a  [[blocks:drivers:tools|code editor]] or other plain text editor, such as Notepad.
  - Delete the line with your player's IP address. 
  - Save the file.
  - Use the ssh command again, as shown above, to access the player

 To avoid the known host issue one can use:
<code>
$ ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null root@[ip-number]
</code>
Ip number can be found in blocks editor or in the dhcp servers client lease list.