Splashtop

This page is for information and troubleshooring the Splashtop streamer app

Troubleshooting

Here are the steps to diagnose any issues with Splashtop.

• To launch the app, search for Splashtop at the desktop and click on the icon.
• After launching the app at the desktop and putting in your credentials, does it gray out the username and password?
  • If so, it means it logged in to Splashtop and it should be working. You should see your Amahi HDA in any Splashtop client you are logged in on and be able to connect.
  • If it's not greying out the username/password, then this needs to be diagnosed.
• If it's not logging in, take a look at what is in this file:

  ~/.config/splashtop-streamer/SPLog.txt

and report on what it's in it. (use apaste to post it online and share the resulting in the IRC forums or support email).

Network Configuration

Splashtop requires that the network interface in your system be managed via Network Manager. Amahi/Ubuntu systems prior to November 31st, 2012 did not have NetworkManager support and would need to be converted to using Network Manager to use Splashtop.

Here is a way to migrate to using Network Manager. Please note that there some risk that this may not work, if you had some non-default networking setup (some people add wireless, or a second NIC).

• First you need to exit Splashtop. Make sure it's not running
• Open a terminal and become root. This will do it:

   sudo su -

• You need to get a patched hdactl, which depend on your machine architecture (YOURARCH should be i386 or amd64)

  
    YOURARCH=`uname -i`;
    wget http://alpha.amahi.org/tmp/hdactl_4.2.7_$YOURARCH.deb
    dpkg -i hdactl_4.2.7_$YOURARCH.deb
   

• The the NetworkManager transition script:

  
    wget http://alpha.amahi.org/tmp/nm-install
    apt-get install -y ruby-dbus
   

• Run the script in test mode:

   ./nm-install

• IMPORTANT: write these settings. If things fail to work (it could happen!) you will need these settings in a piece of paper
• If all looks ok, no errors in the previous test mode command, then do:

   ./nm-install -y

• This should tell you a bit of what it's doing. If there were no errors, then you can reboot and run Splashtop. It should work. If not, please report the error
• If there was some error, please report the error

To report and error, repo it to the team via support or the forums.

If all else fails

If the procedure above fails, you want to manually set up Network Manager. You will need your networking settings here! This is how:

• Go to the top right of the GUI and click on the network icon
• Go to "Edit Connections ..." (or System Settings > Network)
• Delete all the connections
• Create a new ethernet connection with IPv4 settings
• Create a static connection (this is important - your server needs to be on a fixed IP)
• For IP put the IP that your server should have, like 192.168.1.10
• Put the netmask, etc.
• Save it
• Restart

You should be able to use Splashtop now.

If not please report it to the team via support of the forums.