• You are not connected to the internet. Connected to the network does not mean you also have an internet connection.
• The time on your device is different to that of the Google servers, out of sync times render the playstore useless.
• The Google play services and/or store are not updated, update them.

1. Uninstall Touch Portal from your device
2. Log out your apple id from your device and log back in
3. Install Touch Portal
4. Restore in app purchases

• Ensure you download AND install Touch Portal with the same account as you bought the Pro Upgrade with.
• Ensure that all your google services are up to date on your device. This means the playstore as well as the google play services.
• Ensure that your clock(time) on your Android device is correct. If the clock is not correct the servers of Google will not accept calls and they will not provide your in-app purchase information.
• Reboot your Android device. In some cases this can enforce the synching of Google services where the new purchased state will be available.
• Ensure the payment was succesfull. Check your account, sometimes the purchase is pending, if so, contact Google to ask them why.
• Check if you have any other outstanding payments (or pending) because Google will block all your previous paid information to be accessed until you solve the issue.

1. Fully close Touch Portal on your mobile. Also remove it from your recents screen to ensure the background processes are killed as well.
2. Open your device settings
3. Go to Accounts
4. Choose your correct Google account
5. Synchronize your account
6. Open Touch Portal again on your Android mobile device

1. Open your device settings
2. Go to the App section
3. Select Touch Portal
4. Force Close to fully close the app
5. Select Google Play Store also
6. Force Close Google Play Store as well
7. Now open the Google Play Store on your device, this will trigger a resync.
8. Now also open Touch Portal again

1. Open your device settings
2. Go to the App section
3. Select Touch Portal
4. Delete all data and cache of Touch Portal
5. Select Google Play Store also
6. Delete the data and cache for Google Play Store as well
7. Restart your device
8. Open Google Play Store after the restart
9. Search for Touch Portal and open it.

• Try to remove your Google account from your phone, then add it again. This will force a sync as well. Just be sure that you still remember you account credentials.

1. Only a 4x2 (or a 2x4) grid can be used.
2. You get 2 pages, the main page and 1 additional page
3. You cannot use animated GIFs
4. You cannot set the page backgrounds to a different color or image
5. You cannot use plug-ins
6. Certain logic functions cannot be used
7. A few more things may not be available for the Free Base version

• Unlimited amount of pages (base version gives you two)
• Variable grid sizes allowing up to 110 buttons with a maximum of 15 rows or columns. (base version only allows a 4x2 grid)
• Animated GIF images on your buttons
• Customizable Page background colors
• Customizable Page background images
• Run / Test button execution from the Touch Portal desktop application
• Remote control OBS
• Use Values (formerly known as custom states / global states)
• Use Events (formerly known as Global Events)

A graphical representation of the Pro Upgrade

• Color Rows and/or Columns. This has the following options:
  • Rows on the top
  • Rows on the bottom
  • Rows on the top and bottom
  • Columns on the right
  • Columns on the left
  • Columns on the right and left
• Colored border. Select a color and a border size to render a colored border on your pages.
• Single Sided border. Select a color and aborder size to render a colored border on one of the four sides of the page.

• A colored square border
• A colored rounded border
• A colored border with the maximum amount of rounded corners possible for the size of the button.
• A colored background color for the button title
• A colored circulair border for buttons.
• A single sided colored border

A graphical representation of the Graphics Upgrade

• A pulsating single colored border.
• A pulsating double colored border.
• A pulsating rainbow colored border. This will animate the border through the base colors.
• An animated rainbow gradient colored border. The effect can be done in 3 different color schemes.
• An animated highlight colored border.

• A pulsating single colored border.
• A pulsating double colored border.
• A pulsating rainbow colored border. This will animate the border through the base colors.
• A pulsating rainbow colored background. This will animate the background through the base colors.
• A rainbow gradient colored border. The effect can be done in 3 different color schemes.
• An animated rainbow gradient colored border. The effect can be done in 3 different color schemes.
• An animated highlight colored border.
• A rainbow gradient colored background. The effect can be done in 3 different color schemes.
• An animated rainbow gradient colored background. The effect can be done in 3 different color schemes.
• A pulsating rainbow effect for the four corners. This shows a small border in the four corners.

A graphical representation of the Graphics Upgrade

• Retro LC themed colored block background
• Retro LC themed colored block with one corner background
• Retro LC themed colored bullet shaped background
• Retro LC themed colored open bullet shaped background
• Retro LC themed colored disc background
• Retro LC themed colored double sized borders, horizontal or vertical.
• Retro LC themed colored special background to connect two size with a curved effect.

A graphical representation of the Graphics Upgrade

1. You need to upgrade your graphics card drivers
2. You are running RivaTuner. For unknown reasons (java related) using that messes up the graphics of Touch Portal.
3. You are running MSI Afterburner. For unknown reasons (java related) using that messes up the graphics of Touch Portal.
4. On windows with higher displays, the scaling setting is set to something other then 100%. This will mess up the text rendering in Touch Portal. Try setting it back to 100% to see if that fixes the issue.

1. Go to your windows fonts folder (usually: C:\windows\fonts)
2. Find the font called "Roboto" and remove it.
3. Find the font called "Oswald" and remove it.
4. Restart your PC and then start Touch Portal. The text should be normal at this point but the fonts are incorrect. So it should be readable but not visually nice.
5. Now go to Google Fonts Roboto and install this font on your computer. In the top right corner is the download button.
6. Now go to Google Fonts Oswald and install this font on your computer.
7. Restart your PC and then start Touch Portal. The text should be normal at this point and the fonts should be correct.

1. In the Finder on your Mac, locate the Touch Portal installation pkg. Don’t use Launchpad to do this. Launchpad doesn’t allow you to access the shortcut menu.
2. Control-click the app icon, then choose Open from the shortcut menu.
3. Click Open.

Touch Portal uses Orcale Java 8. It does not work on any other version and it does not work on OpenJDK. Open a commandline box and add the line "java -version" to check if it is the correct version. The easiest solution is to remove the other Java version and reinstall Touch Portal to fix this.

Other possible reasons Touch Portal will not start is that the TouchPortal folder has been corrupted. Please rename it and start Touch Portal. If it works then it means the folder is corrupt. You can try to copy part by part of that old folder into the new one to save your data. If it does not start again, you know which part is corrupted.

Known applications that can be the cause of not starting Touch Portal:

• VPNs in general can set up to block Touch Portal (Java)
• Antivirus can block executable and/or Java

Very rarely this can happen when Touch Portal can't match the local ip address with a network adapter, this can be solved by:

1. First close down Touch Portal
2. Run Terminal from the spotlight search Top Right on your screen
3. Run ifconfig
4. Locate en0 or en1 in the list, remember if it says en0, en1... and write down the ip address of your network card
5. Navigate to "Documents/Touch Portal" folder and edit config.properties
6. Change or add the following line to config.properties
1. usedNetworkInterface=en0 | 192.168.1.116
2. Of course use the en-value and ip address that you have written down in the previous step.
7. Save and close the file and try to start Touch Portal again

When you try to run Touch Portal at windows startup you can not start Touch Portal in Admin-mode on windows. So uncheck the -run as administrator- option and it should start up.

If Touch Portal runs in admin mode and you set the startup options those are not set up for your windows user but for an admin user. So on windows startup, the normal user does not have the startup option.

Also keep in mind that the second checkbox is only to start TP minimized when it starts with boot. The first checkbox is to let it actually start at boot time.

To ensure the setting changes, try the following:

1. Turn of both checkboxes
2. Save
3. Close Touch Portal
4. Restart Windows, why? because then the settings take effect.
5. Start Touch Portal
6. Check the first checkbox or both (the second alone does nothing)
7. Close Touch Portal
8. Restart Windows, why? because then the settings take effect.
9. It should now startup at windows boot

First things first:

• Touch Portal can only connect 1 device at a time, connecting more at the same time will mess up the connections

Covering the basics:

1. Ensure you have the latest version of Touch Portal on both your desktop and your mobile device.
2. Restart both applications. Right click on the Touch Portal icon on the desktop and choose "Exit" to fully close Touch Portal (including background processes). On mobile devices, after exiting the app, ensure that you have also removed the app from the recents list, again to shut down all background processes.
3. When the above steps do not solve the connection issue still, try a restart of both your computer and your mobile device.
4. If the issue still exists, we now have a clean start of both apps to be able to troubleshout more specifically. Go to the next section of options to try for fixing this.

General steps:

1. Anti-virus and firewalls can block the communication of Touch Portal. So to see if that is the problem, try to turn off your firewall or antivirus and retry the connection. If it works, try adding an exception for Touch Portal AND Java to your firewall / antivirus. If it does not help, please let it be turned off for the time you continue with the troubleshooting. In some occassions multiple things can cause the connection issues so keeping this off during your testing will be handy to ensure this is no blocker.
   
   
2. For some Firewalls or Anti-Virus you also need to add the ports (all of them) to your whitelist. Try this as well.

3. Touch Portal uses the local network to communicate between your mobile device and your computer. To be able to do so, you need to allow Java through your firewall. Touch Portal is created in Java and Windows sees this as an Java application and because of this you need to allow Java (instead of Touch Portal) in your firewall.

   1. Go to start menu
   2. Type "Allow an app through Windows Firewall"
   3. When the option shows, click enter to go to the Windows Firewall screen
   4. Press "Change Settings"
   5. Allow the java related entry for your network profile
   6. If you don't see Java anywhere you can add it manually by going to C:\program files\java\(VERSION)\bin\ and adding JAVAW.exe (Notice the "W" in javaW.exe).

   The following video shows you how to do this step by step:

   
   
   
4. VPNs in general can be set up in such a way they will block Touch Portal or Java. Try disabling them while testing to see if this is part of the issue. Just like with the anti-virus and firewall, leave this off while continuing with the troubleshooting.
   
   
5. Since we are using the local network, you need to be on the same local network. The IP address of both the desktop as the mobile device should have the same format with only the last numbers different. Example: If PC is "192.168.1.X" then iOS/Android must be "192.168.1.Y". A simple fix is to connect both devices to the same router. You can check the IP of the PC by pressing "WIN+R" and typing "CMD", then type "ipconfig". See the IP under "IPv4 Address".
   1. If your devices are on the same subnet, and you are still unable to connect your router may be blocking client from talking to each other. This has a few names, depending on the manufacturer, such as AP Isolation, WiFi Isolation, SSID Isolation, Client Isolation. You'll want to Google "{MAKE} {MODEL} {X ISOLATION}" and look for instructions on how to disable this.
   2. Additionaly, if you have seperate subnets (networks) you can still use TouchPortal, you will have to manually enter the PC's IP address in your mobile client and ensure that the traffic is being routed by your router between the subnets. Having them on the same subnet just makes things a lot easier.
   
   
6. Double check if the ports are 12134 and 12135 on your desktop (you can see this in the bottom bar of the main screen) , but also on your device they need to be like that. Go to the Touch Portal settings screen and check if both ports are 12134 and 12135.
   
   
7. Sometimes the port Touch Portal uses is already in use by different software. To ensure this is not the case, use the curports software to check ports in use. You could also try to use different ports instead of the curports step. Obviously port ONE must be the same in PC and Mobile, the same counts for port TWO.

Specific causes:

1. Sometimes the Touch Portal folder in your documents folder (for new version it is the windows appData folder, usually located at C:/Users/YOURUSERNAME/AppData/roaming/) has been corrupted. In your PC go to "Documents" or the appData folder and find the folder "TouchPortal" rename that folder to "TouchPortal OLD". Reopen TouchPortal in your PC. It should create a new "TouchPortal" folder in your appData folder and it will be like a fresh start. If you create buttons, and they show on mobile it means that your previous settings/pages were corrupted. This issue happens rarely and is probably due to links or texts containing characters that do not pertain to the English Alphabet. If this happens, please zip your old touch portal folder and send it to us so we can troubleshoot.
   
   
2. MSI Afterburner, RIVA tuner or other overlay applications are also known to cause issues with Java. Close these and try if they are messing up the connection process.
   
   
3. Sometimes it happens that the Java installation gets corrupt. The solution here is to uninstall Java, uninstall Touch Portal and then ONLY reinstall Touch Portal. It will automatically install the correct Java version as well.
   
   
4. Some users have stricter settings in their physical router. Check your router for active firewalls and their settings. If you just want to know if that is blocking your connection turn it off during your test. Just remember to turn it on again when you have fixed the connection. One thing we also encountered with some users is that they had AP Isolation turned on, on the router. If you are uncertain if the router is blocking, try pinging your mobile device from your computer.
   
   
5. Update Java 8 to the latest version
   
   

iOS specific possible causes

1. From iOS version 14.2, applications can be disallowed from using the local network. To see if this is the case, on your iOS device, go to Privacy in your settings, then find the local network entry and see if TOuch Portal is turned off. For Touch Portal to function properly, this needs to be turned on.

1. Turn on the Developer settings on Android
1. Go to settings
2. Go to phone information
3. Find the entry with the build number
4. Press it 10 times or so until see you the message that developer settings are enabled.
2. Go to the developer settings
3. Locate the USB Debugging feature and turn it on
4. On your Android device a popup should show with the question to allow communication. Allow it
1. If it does not, unplug and plug your cable again so it will trigger. This is required for the device to be able to communicate with Touch Portal
5. Now with this enabled you should restart the Touch Portal desktop app.

1. Set Touch Portal Mobile in USB mode
1. Go to settings
2. Set connection type to USB
3. Leave the settings screen
2. Now select "USB Communication" on the adapter dropdown list on the Touch Portal desktop application on the left bottom.
1. To reconnect, switch it to a WiFi adapter and then back to the "USB Connection". This will re-trigger the connection process.
3. Your page should now be visible on your mobile!

1. Check if you have connected the correct cable to the correct device and pc.
2. Install the correct USB drivers for your phone. Samsung for example has specific drivers and the windows default will not work. You can find them here: Samsung USB drivers. Check your manufacturer for the correct drivers if they have specific USB drivers.
3. Check if your device is recognized by windows and ADB.
1. Open a command line tool (in windows, click on the search icon and type "cmd"
2. Type: adb devices
3. This should show a list of devices. Yours should be there.
1. If not? You should revoke your phone access. The access dialog should show when you plug in your device again to the desktop pc.
2. Type: adb devices
3. This should show a list of devices. Yours should be there. If it is not:
1. Unplug the USB cable from your device.
2. Revoke USB Debugging on phone, If the device is shown as unauthorized or not shown, check the developer options on the phone and click "Revoke USB debugging authorization".
3. Now we need to reset the ADB system to let the device make a new connection, type in the command line tool:
   
   adb kill-server
   adb start-server
4. Plug the USB cable in your device again.
5. Your device will now show a message to agree to connect with the computer. You MUST confirm this message.
6. Now recheck the adb devices command and it should be there. You can now connect to your device if you follow the correct connection steps described above.
4. Check if the ports are setup correct for ADB
1. Open a command line tool (in windows, click on the search icon and type "cmd"
2. Type: adb forward --list
3. This should show a list of port forwarded. Yours (default 13145) should be there.
1. If not?
2. Type: adb forward tcp:13145 tcp:13145
3. This will add the port to ADB. Try the list command again and it should be there.
4. If it still does not work, contact us at Discord

1. Most API's need an authorization token, ensure your token is added to the optional headers and is correct.
2. Most API's require the HTTP call to originate from a browser. Our app is not a browser so you need to mimic our call so that it seems it originates from a browser. You do this by specifying the following optional header:
   
   
   • Key: User-Agent
   • Value: Touch Portal/2
   
   or if that does not work, mimic an existing browser
   
   
   • Key: User-Agent
   • Value: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.11 (KHTML, like Gecko) Chrome/23.0.1271.95 Safari/537.11

1. Application Y requires a specific or minimal duration of the press, try fiddling with the duration of the button press.
2. Application Y is running in Admin mode and Touch Portal is not, since a while back Microsoft changed the way key presses can be send to applications running in admin mode and normal mode. If they are in the same mode the key press can be send, if not in the same mode, key presses do not work. Try to run both in Admin mode or both in Normal mode.
3. Application Y has anti-cheat functionality, it detects the virtual key press of Touch Portal and denies it, not much we can do about this.

1. Install the latest OBS Web Socket plugin: OBS Websocket plugin
2. Start OBS Studio
3. Start Touch Portal
4. You should be connected to OBS Studio from Touch Portal now. If not, use the Connect to OBS menu option in the Touch Portal desktop app.
5. Enjoy!

• Ensure you have installed the Palakis OBS Websocket plugin. In OBS goto the plugin section and ensure it is there. If not, install it and follow our tutorial.
• Try making the connection without a password first, maybe you made a mistake.
• Some users are experiencing connection issues when Killer Networking is running. Its seems like Killer Networking is blocking loop back connections to localhost.

1. Start Touch Portal
2. Start XSplit
3. Go to >> Extensions >> Add Extensions >> Browse You can find the Plug-in in the Program Files Touch Portal plugins directory: c:\Program Files (x86)\Touch Portal\plugins\xsplit\TouchPortal.html
4. Go to >> Extensions >> TouchPortal and click on “Connect to Touch Portal” and leave the window open (you can minimize this window)
5. You should be connected with XSplit from Touch Portal now

1. Ensure the account has been connected to Touch Portal in the settings
2. Ensure the chat token has been added to Touch Portal in the settings
3. Direct integration of Twitch means everything happens without user interaction. To ensure your action failed, check Twitch to ensure the action has not be done. For example; setting a marker does not give you feedback on the chat, those systems are not linked. Check the markers section. Creating clips can take a while (up to 2 minutes accoding the Twitch documentation) until the clip is available. Ensure the action really failed before continuing.
4. If that is all set, check the logs for errors (can be found at %appdata% \ roaming \ TouchPortal )
5. If there are no errors in the log, reconnect both your account and the chattoken, they can expire.
6. Your computer can also block the connection, in this case try running Touch Portal in admin mode

1. Go to the settings screen
2. Click on the Twitch section
3. Remove all entries
4. Connect your accoutn again
5. Also request the chat token again
6. Click on Save. Please note, this can take up to 30 seconds in some situations so wait for the saving is done.
7. Now fully restart Touch Portal by right clicking the TP icon in your system tray and select "Exit" to close.