FAQ

1. Open the Settings and navigate to the section 'Backups'.
2. Locate the backup with the date you want to restore.
3. Click on the button with the circular arrows on it.
4. Touch Portal will not revert back to that backup.
5. Fully restart Touch Portal when the backup process is done.

1. Shutdown Touch Portal fully
2. Go to the folder '%appdata%'
3. Locate the folder called "TouchPortal"
4. Rename it to "TouchPortalOld". If anything goes wrong, you will still have that setup to revert back to. If the manual restore is succesful you can remove this folder.
5. Goto your Windows Documents folder
6. Locate and open the "Touch Portal Backups" folder.
7. Within that folder all backups are ordered by date. Locate the folder with the date you want to restore.
8. Copy that folder to the same location where the "TouchPortalOld" folder is.
9. Rename the copied folder to "TouchPortal".
10. Start Touch Portal again and you have restored a backup.

1. Shutdown Touch Portal fully
2. Go to the folder '%appdata%' on Windows or go to your Documents folder on MacOS
3. Locate the folder called "TouchPortal"
4. Copy this folder to a safe place. This folder holds all the Pages, Events, Flows and Values and is your manual backup.
5. Use the above method for restoring the backup manually when you need to. You can also do this on a different computer. Just copy the folder to the correct location.

• 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. You cannot use graphics upgrades
8. 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)
• Use Plug-ins (Plug-ins are made by third parties. Use at own risk.)

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 runs with its own embedded Java but sometimes existing installation can cause issues. First thing to try is to update your systems Java.

If it is updated, check your PATH variable of your System Environment Variables. Check if it has a Java path in it. If it does, remove it from the PATH variable, following the steps below:

1. Press Windows Key + X to open the Power User Task Menu
2. Select the System option
3. (Windows 10 only, Windows 11 continue with next step) Scroll down and click on the About option.
4. Click on Advanced system settings
5. Click on Advanced tab of not already opened
6. Click on Environment Variables
7. Check the Path variable (of both the user and the system) to see if there is a reference to a Java folder. If so, remove that part but keep the rest.
8. Reboot your pc and try to start Touch Portal again

If this does not work and you have other Java installations on your computer, you can also try to remove them all and then reboot your computer and start Touch Portal again.

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

If the option within Touch Portal does not work. For example if you want to have it started as Admin then you can follow these steps:

1. Open Windows Explorer and locate the C:\Program Files (x86)\Touch Portal
2. Right click on the TouchPortal.exe file
3. Choose copy to
4. Then choose to create a shortcut on the desktop.
5. Press Windows Key + R
6. Type shell:startup and press enter
7. Now copy the shortcut you created on the desktop to this folder
• Ensure you have it set to start as Admin if you require it
• If you want it to start minimized, add the option -m as a parameter
8. Restart Windows and 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. The first thing you should check is whether you are using the correct network adapter. A desktop PC (win or mac) can have multiple network adapters installed. So ensure the adapter and ip address are correct A few special ips and why not to use them:
   • 127.0.0.1 - this will not work for communication outside your desktop, it is a local reference only.
   • null - this is a bad stored entry, reselect the proper adapter and ip.
   • 192.168.56.1 - most likely this will be the address of a virtual network (usually VMs) and is not the correct network adapter to communicate with Touch Portal mobile devices.
   • xxx.xxx.56.1 - most likely this will be the address of a virtual network (usually VMs) and is not the correct network adapter to communicate with Touch Portal mobile devices.
   
   
   
2. During the first start of Touch Portal it will ask you to allow the communication of Touch Portal through the Windows Defender firewall. You need to accept this otherwise there can be no communication. If you did not, you can add it manually. In windows, type in the run bar 'firewall'. You will see an option to add an application to your firewall. Choose that and you will see a list of all allowed application through your Windows firewall. Change the settings and click on the button to add another application. Point it to the TouchPortal.exe file location. Then save it.
   
   
3. 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 to your firewall / antivirus. If it does not help, please let the firewall or antivirus 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. (Just be sure to turn it on again afterwards)
   
   
4. For some Firewalls or Anti-Virus you also need to add the ports (all of them) to your whitelist. Try this as well.
   
   
5. VPNs in general can be set up in such a way they will block Touch Portal. Try disabling VPNs 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.
   
   
6. 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.
   
   
7. Touch Portal does not work properly on a IPv6 network, use IPv4. Possible fix (mac):
   1. Go to “System Preferences/Network”
   2. Select “WiFi” on the left hand side
   3. Select Advance at the bottom right corner
   4. Go to the “TCP/IP” column
   5. In the Configure IPv6 window select “Link-Local”
   
   
8. 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.
   
   
9. 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 data folder, located at C:/Users/YOURUSERNAME/AppData/roaming/, has been corrupted. Go to the folder and locate "TouchPortal" and rename that folder to "TouchPortalOLD". 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 data folder was corrupted or locked by the system.
   
   
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. 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 the firewall in your router 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.
   
   

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 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.
2. Application Y requires a specific or minimal duration of the press, try fiddling with the duration of the button press.
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. Application Y is running in Admin mode and Touch Portal is not, since a while back Microsoft changed the way mouse and keyboard input can be send to applications running in admin mode and normal mode. If they are in the same mode the input can be send and received, if not in the same mode, mouse clicks do not work. Try to run both in Admin mode or both in Normal mode.
2. Application Y has anti-cheat functionality, it detects the virtual mouse click of Touch Portal and denies it, not much we can do about this.

1. Open a Command Prompt in Windows (cmd.exe)
2. Type "Powershell" and press enter.
3. Powershell is now started. When in Powershell run the following two commands
   1. Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass -Force;
   2. Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted -Force;
4. These two options allow you to run any script (unrestricted) and will not prompt a message with the question whether it is safe to run your selected script (bypass)

1. Install the latest OBS Web Socket plugin (4.9.1, do not download 5.x as this is not yet supported.): OBS Websocket plugin
2. Start OBS Studio
3. Ensure the Websocket entry is in the Tools menu of OBS, if not, you need to manually install the websocket plugin. See the link in step 1 for the steps to do that.
4. Start Touch Portal
5. 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.
6. Sometimes the authentication is turned on in the Websocket settings, if so, ensure it is set up the same on both ends, either with or without.
7. Enjoy!

• Ensure you have installed the Palakis OBS Websocket plugin version 4.9.1.. In OBS goto the plugin section (Tools -> Websocket) and ensure it is there. If not, install it and follow our tutorial. You may need to install it manually, see the link above for more information on how to do this.
• 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.

1. Resolution should be <= 1280x1280 (width x height)
2. Number of frames <= 350
3. Number of pixels (width * height * framecount) <= 300 million
4. File size should be smaller than 15Mb