FAQ

General Questions
How does Touch Portal work? Touch Portal is the app to control your dekstop computer with your mobile device. You can use Touch Portal on your Windows and MacOs desktop and use an Android or iOS device to control the desktop.

Touch Portal is based on the principle that your mobile device connects to the desktop and sends commands to the desktop which are executed on either the system level or within an application. Touch Portal uses the local network to do this or you can use a USB cable connection if you are using Windows and Android.

You can directly control a collection of integrated applications such as OBS, Streamlabs Desktop, XSplit, Lightroom and Photoshop and you can also directly control a collection of integrated services such as Twitch and StreamElements Live. Besides specific applications you can control a lot of your OS (Windows, MacOS and Linux) such as volume controls and system controls.

Even if your prefered software application is not integrated into Touch Portal directly you can still control almost all applications using several functions such as Key Presses, Mouse actions, Windows controls, Automation, File handling and much more.

On top of this all Touch Portal has a plug-in system which allows other developers to create plug-ins for a lot of other software applications to be integrated directly in Touch Portal. As a user you need the Pro Upgrade to be able to use plug-ins.

Touch Portal on your mobile phone controls your desktop. It syncs with the desktop setup and will then work independently. You can navigate pages using buttons and execute buttons and sliders while using Touch Portal on your mobile device.
The Touch Portal desktop application is used to edit your setup and it holds the server for receiving communication from your mobile device. It does not reflect what your mobile device should show at that moment. So changing a Page on your desktop has no effect on Touch Portal on your mobile device.

Touch Portals power is that you can add as many actions to a single control as you like and you can even add logical system to execute certain actions in certain situations. You have a lot of freedom to create your perfect functionality.

Now that you have an understanding of what Touch Portal is and how it works, read up on our Guides to learn more about the core aspects of Touch Portal. Link to this question
What desktop platforms are supported? Currently Touch Portal is supported on the following platforms:

  • Windows 10 & 11 - 64-bit, both versions updated to the latest
  • Mac Os X 10.13.6 and up
  • Linux is currently in open Beta (appImage packages only), build for Ubuntu but a lot of other distros work as well.
Link to this question
What mobile platforms are supported?

Android

  • Android version 4.1 & higher
  • USB only works on Android 5.0 & higher, meaning for Android 4.x you need to use WiFi.
  • But only devices that run the original OS AND come with Google Play store and Google Play Services installed.
  • NO custom roms are supported
  • NO chromebooks are supported
  • NO Chrome OS support
  • NO rooted devices are supported
Please Note: All other devices that can run Touch Portal are not supported and should be used at your own risk. If it works currently on your unsupported device there are no guarantees it will work in the future so be beware of this. Especially important when you are looking to buy a new device to use with Touch Portal.

iOS

  • iOS version 12.0 & higher
  • Only iPads and iPhones

Android and iOS (Google and Apple) and supporting older versions

We try to keep compatibility with old mobile OS versions as long as we can as we think it is important to recycle old devices as much as possible. Giving them new life helps keeping our world just a little bit healthier. But even though both Apple and Android keep supporting old version for a period of time they will eventually drop support and from that moment we usually can no longer support those devices anymore as well. This is out of our hands so keep that in mind when shopping for a new device to use with Touch Portal. For example, with version 4.0 we were no longer able to support iOS below version 12.0. Touch Portal version 3.x is still available on iOS versions lower but this requires to also use Desktop Version 3.x. Unfortunately this change was forced upon us by the regulations and possibilities of Apple software and services.

Link to this question
Touch Portal is not available in my Play Store? Unfortunately, we cannot release our app in all countries around the world on Android. This has to do with laws and taxes. On iOS this is handled by Apple but on Android this is only partly handled by Google. This means in some countries we need to handle taxes and regulations ourselves which is not always possible with our current resources. Touch Portal is not available in the Play Store in the countries listed below. We try to release in new countries whenever the possibility is there. Is our app not available in your country? Keep an eye on our X (Twitter) for tweets about new countries we release to.

Below is a small overview of countries we have not yet released to on Android with the reason why. If you encounter something that is incorrect in your view, please let us know and provide us some info so that we can re-evaluate.

CountryReason
AlgeriaNo VAT Threshold
AngolaNo VAT Threshold
ArubaNo VAT Threshold
AzerbaijanNo VAT Threshold
BahrainNo VAT Threshold
BelizeUnclear tax requirements
BeninNo VAT Threshold
BoliviaUnclear withholding tax system
Bosnia and HerzegovinaInvestigating
Burkina FasoNo VAT Threshold
ChinaPlaystore not available
ColombiaNo VAT Threshold
ComorosNo VAT Threshold
CongoNo VAT Threshold
Costa RicaNo VAT Threshold
CubaUnclear future requirements
CuraçaoNo VAT Threshold
DjiboutiUnclear regulations
DominicaNo VAT Threshold
Dominican RepublicNo VAT Threshold
EcuadorNo VAT Threshold
El SalvadorUnclear future requirements
EritreaUnclear future requirements
GabonUnclear regulations
The GambiaLow VAT Threshold
GuatemalaNo VAT Threshold
Guinea-BissauNo VAT Threshold
HaitiNo VAT Threshold
HondurasLow VAT Threshold
IraqUnclear future requirements
IranNo VAT Threshold
Cape VerdeNo VAT Threshold
KyrgyzstanNo VAT Threshold
KuwaitUnclear future requirements
MacauUnclear future requirements
MonacoNo VAT Threshold
MozambiqueNo VAT Threshold
NepalLow VAT Threshold
NicaraguaUnclear tax requirements
PakistanNo VAT Threshold
PanamaNo VAT Threshold
ParaguayNo VAT Threshold
PeruNo VAT Threshold
QatarUnclear future requirements
RussiaLegally not allowed
San MarinoNo VAT Threshold
SenegalNo VAT Threshold
SudanLow VAT Threshold
SomaliaNo VAT Threshold
SurinameLow VAT Threshold
TajikistanNo VAT Threshold
TanzaniaNo VAT Threshold
TunisiaNo VAT Threshold
TurkmenistanNo VAT Threshold
UruguayNo VAT Threshold
VenezuelaNo VAT Threshold


More details on the reasons:

No VAT Threshold (or low) - The country requires VAT to be handled from the first sale. Google does not handle the taxes for this country on our behalve so we are responsible ourselves. With our current resources we are not able to manage this ourselves and therefor cannot release our app in this country.

Legally not allowed - We are currently not allowed to do business in this country.

Unclear requirements - The taxation rules are unclear to us and we cannot find definitive information.

Investigating - This means that we are actively looking into the rules to see what we can do.

Unclear future requirements - This country currently is either in transition in regards of their tax system or a change is scheduled for the future. At this moment it is unclear whether we can release our app in this country.

Link to this question
The play store says I have an incompatible device but it is brand new? Unfortunately, we cannot release our app in all countries around the world. This has to do with laws and taxes. We try to release in new countries whenever the possibility is there. Is our app not available in your country? Keep an eye on our x (Twitter) for tweets about new countries we release to. Link to this question
I have a bug! You can always contact us with issues and problems. We will look at it as soon as we can. Please provide us with what you expected to happen, what actually happened, what you do to reproduce the issue, the version of both the desktop app as well as the mobile app and of course the platforms running the apps. Without this information it is hard for us to find the issue and solve it.

Best place to mention issues is on our Discord server where both we and our community are present to help out. Our discord support also has a great history of known issues and what to do to solve them. You can also send us feedback through our support form Link to this question
Can we request new features? Yes, please do. We integrate a lot of user requests and we do not always know what users need so every bit of feedback is welcome! But we do also have our own schedule and planning. So we always try to have a mix of user requested features and our own plans. Some people would like to see our backlog but we do not share this backlog because we do not want to have discussions about which suggested features should be built right away or what priority it has. We like to use that time to build new features for Touch Portal. Link to this question
How to restore a Touch Portal data Backup? You can create backups within Touch Portal. These backups are stored on the local machine in the documents folder. You can directly restore a backup using Touch Portal itself or you can manually restore a backup if you need to restore it when you have put your backups to an external source (for safe keeping or when you want to backup your setup from one computer to another, also important for when you are formatting your hard drive).

Restore Backup in Touch Portal application
  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 now revert back to that backup.
  5. Fully restart Touch Portal when the backup process is done.

Restore Backup Manually
  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.

Create your own backup manually
  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.


Link to this question
Payment & License
Is Touch Portal free to use? Yes it’s free for use, but you are limited to a grid of 4×2 (2×4) and you can create only one extra page extra to extend your buttons. The pro upgrade removes these limitations. Also, when you purchase the pro upgrade, you support us big time! That way we can keep on creating nice and useful features for you! The Pro upgrade gives you a lot of extra features and options as well so checkout the FAQ item on the Pro upgrade.

You can also get other upgrades that will enhance your base version. Link to this question
I don't understand the license system, can you explain? All purchased Touch Portal Upgrades have a lifetime license tied to the store account used to make the purchase.

Lifetime License
The lifetime license for an Upgrade is directly associated with the mobile store account and the rules and regulations of those stores, as they manage the actual license. Currently, we support the Google Play Store and the Apple App Store. The in-app purchases you make (Upgrades) are linked to your store account and will remain available as long as those stores and operating systems continue to serve apps and in-app purchases.

Mobile Stores
Touch Portal Upgrades can only be purchased through either the Google Play Store or the iOS App Store. The account used to buy the Upgrade will hold the license. Any device on which you download the app using that same account will have access to the Upgrades.

Bought a new computer?
No worries, the license is not attached to your desktop application, so you can use Touch Portal on any desktop you like without affecting your purchased Upgrades.

Bought a new mobile device?
You don’t have to worry when buying a new or additional mobile device, as long as you use the same account. However, if you purchase a new device that cannot use the same account, you will not have access to the Upgrades on a different account.

Share Between Mobile Stores?
If you purchase an Upgrade using your Google account on the Google Play Store, you cannot use that same account on Apple devices. This means you won’t have access to the Upgrades on an Apple device. In such cases, you will need to purchase the Upgrade as well for an Apple account. Both Google and Apple do not permit sharing license information between platforms.

Mobile Operating System (OS) Limitations
Our goal is to support older operating systems for as long as possible. However, it is always possible that Google or Apple may make adjustments that prevent us from supporting older versions. This does not mean you will lose your Upgrades (licenses), but you may need to upgrade your device to continue using Touch Portal and your Upgrades.

Do Upgrades change?
When you purchase an Upgrade, it will list all the features included at the time of purchase. These features will remain available unless technical or legal issues prevent us from continuing to provide them. While we often add extra features to existing Upgrades, these should be seen as a bonus and do not entitle you to additional features. Each Upgrade is sold "as is" at the time of purchase. Link to this question
What payment options does Touch Portal offer? The Play Store (Android, Google)

You can buy our Upgrades from the Play Store on your mobile Android device. The payment is handled by Google on Android and they offer different payment methods per country.
Check this Google support help page to see what payments methods are available in your country.

The Appstore (iOS, Apple)

You can buy our Upgrades from the Appstore on your mobile iOS device. The payment is being handle by Apple on iOS and Apple offers different payment methods per country.
Check this Apple support help page to see what payments methods are available in your country. Link to this question
Can I get an Upgrade for free or with discount? Giveaways

From time to time Touch Portal collaborates with companies and streamers to have giveaways of certain Upgrades. If you want to be able to know when and where, follow us on Twitter as we will share with our community when this happens.

Discount

Touch Portal will, from time to time, have moments where we will provide temporary packages that will be sold with a discount. Join us on Discord or follow us on Twitter to be kept in the loop of when this happens.

Other tips?

In most countries you can pay for the Upgrades with your store credits. There are programs that allow you to save credits by participating with rewards programs such as the Google Rewards program on Android where you get Play Store credits in exchange for answering questions. On iOS the Google Rewards program is also available and will send money to your paypal account instead of appstore credits but you can use that paypal account most of the time to pay for upgrades. Usually you get surveys when you visit stores or interesting landmarks. Please note that these kinds of programs have age requirements an may not be legal everywhere, so make sure you're eligible before signing up.

There are a lot of other applications and programs like this that could help you fill your store credits. There are also loads of resources online, like this, that sums up a lot of the possibilties you can try. Just be careful and check out each program before you start to know what they do, what they collect and how they pay out and if you are ok with that. Link to this question
Why are there different prices per country and store? The prices for Upgrades are different per country and per store. This has several reasons which we will explain;

Including and excluding taxes

Prices in the United States (dollars $) for example are usually listed without VAT / Sales tax. This is also the case on our website. Prices in Europe (euro €) on the other hand are listed including the VAT / Sales tax. This makes the biggest difference between the listed prices between dollars and euros. Most countries in Europe add 20% VAT which means that if you reduce the price with that percentage you can compare the price with the dollar price.

Different taxes

On top of this the VAT / Sales tax differs per country and in some countries it even differs per region. This means that the resulting price also changes. Some countries have only 5% of VAT and some countries have 30% VAT. The rest is mostly in between. This is the second biggest difference.

Pricing flexibility of the stores

The stores do not give us full pricing freedom so we cannot in some situation match the prices as we would like. This gives us pricing differences between iOS and Android as well.

Daily changing currency value

We set our prices for Upgrades at some point in time and from that moment the value of one currency in comparison with another currency will change on a daily basis. We do not keep track of this on a daily basis and will not correct prices for this.

Country specific pricing

In some countries it makes no sense to just convert the price in dollars to the price of that country as the purchasing power of users is a lot less in comparison to the dollar. So in those countries we look at the a different pricing.

Discounts

Touch Portal will, from time to time, have moments where we will provide temporary packages that will be sold with a discount. For some of our discounts we can only do this in certain countries as other have different (stricter) rules for such promotions.

Link to this question
I bought an Upgrade on iOS but Touch Portal is still saying I need to buy it? Touch Portal on iOS
If you bought the Pro Upgrade or any other Upgrade on iOS but the desktop app is still saying you have a free version or the Upgrade is not working, go to the settings of Touch Portal on iOS and tap the "Restore Purchase" button twice. Then click the refresh button on the main screen. It should now have unlocked the Upgrade. Restoring a purchase does not mean buying it again so no worries. Sometimes the Apple store does not give back the purchase has been succesful while it has. If this still does not work, fully close the iOS app of Touch Portal (also from recents) and start it up again. That should fix it. If it is not in your apple account, something went wrong outside of Touch Portal. Best to contact Apple for that.

In some cases the cache of the device works against you, try the following:
  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


Link to this question
I bought an Upgrade on Android but Touch Portal is still saying I need to buy it? Ensure if everything is setup correctly
There can be several reasons why your account has not synced the purchase information, first ensure that:
  • First thing to do is to ensure you have actually bought the upgrade, go through your iOS or Android purchase history and check if it is listed there, if it is, continue on, if it isn't then you have not bought it with this current account. If you have bought it, maybe you used a different account to do this.
  • 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 Play Store 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.
Force a Google account synchronisation
If the above all checks out and you still do not have access to your in-app purchase, sync you Google account by doing these steps:
  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
Fully restart Touch Portal and services
Your in-app purchase should now be available on your device. Refresh the page by pressing the refresh button. If Touch Portal does not right away see the in-app purchases still, restart all services by following these steps:
  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
Clear data and cache for Touch Portal and services
Now it should be available for you. If it is still not available after this step, try cleaning the data:
  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.

If this all still does not restore your in-app purchase, check the following issues:
  • 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.
And if after all this it is still not working, contact us on our Discord server.

Link to this question
Upgrades
What are upgrades? Touch Portal is free to use but the true power comes with its upgrades. We supply you with upgrades so you yourself can choose how you want to upgrade the free base version of our app. If you buy the pro upgrade for example, you will get the possibility to use an unlimited number of pages and custom grids per page of up to 110 buttons. You can also use animated GIFs and background images. Check out the main website for the list of available upgrades.

With the base version of Touch Portal (free) you can do everything for a few exceptions:
  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 and a small collection of other actions cannot be used
  7. You cannot use graphics upgrades
  8. A few more things may not be available for the Free Base version
Link to this question
What is the Pro upgrade? Touch Portal comes with upgrades to extend the usability. The Pro upgrade is such an upgrade. When you buy the Pro upgrade, you will unlock the following functionalities in Touch Portal:
  • 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.)
The Pro upgrade can be bought in the Play Store for Android or in the Appstore for iOS. It is linked to your account and can be used on all devices where that account is linked. In the mobile app, click on the cart icon (Android) or go to the settings (iOS) to buy the Pro Upgrade. The Pro Upgrade is a one-time payment for a life-time license.

The purchase is however, linked to the specific store (and the account used to buy the upgrade). The license is not transferable from Android to iOS or vice versa. Both Apple and Google do not allow this even if we could make this technically happen, doing so would mean that our app would not be accepted in the store. If you have a devices of both platforms and you want to use them both with Touch Portal, you need to buy a license for both platforms.
A graphical representation of the Pro Upgrade
Link to this question
What is the Multiple Devices upgrade? Touch Portal comes with upgrades to extend the usability. The Multiple Devices upgrade is such an upgrade. When you buy the Multiple Devices upgrade, you will unlock the ability to connect multiple device at the same to one Touch Portal Desktop instance.

The Multiple Devices upgrade can be bought in the Play Store for Android or in the Appstore for iOS. It is linked to your account and can be used on all devices where that account is linked. In the mobile app, click on the cart icon (Android) or go to the settings (iOS) to buy the Pro Upgrade. The Multiple Devices Upgrade is a one-time payment for a life-time license.

The purchase is however, linked to the specific store (and the account used to buy the upgrade). The license is not transferable from Android to iOS or the vice versa. Both Apple and Google do not allow this even if we could make this technically happen, doing so would mean that our app would not be accepted in the store. If you have a devices of both platforms and you want to use them both as secondary devices with Touch Portal, you need to buy a license for both platforms.
A graphical representation of the Multiple Devices Upgrade
Link to this question
Can I connect both iOS and Android devices to one desktop with the multiple devices upgrade? Yes, you can connect devices from both platforms to the same Touch Portal Desktp instance. However, keep in mind that each device needs to have the upgrade. So be sure to put the correct store accounts, the ones with the upgrades bought, on the devices you want to use.

Link to this question
What is the Icon Editor Graphics Upgrade? Touch Portal v3.1 and later comes with the Icon Editor Graphic Upgrades that will enable you to add more graphical depth to your icons. The Icon Editor Graphics Upgrade is an Graphics Upgrade to extend the customizability of your pages and buttons by giving you a lot of options to change your icons:
  • Color Overlay
  • Color Blend
  • Replace a color with another color
  • Gradient Overlay
  • Replace a color with a gradient
  • Grey Scale
  • Blur
  • Color Stroke
  • Scale your icon
  • Add a drop shadow
  • Add a glow
  • Add an Image layer below or on top
  • Offset your Icon
  • Add an scalable, translatable Image Layer
  • Add a Text Layer with customizable font (same set provided within the TP desktop application), size, color, position and rotation.
The Icon Editor Graphics Upgrade can be bought in the Playstore for Android or in the Appstore for iOS. It is linked to your account and can be used on all devices where that account is linked. In the mobile app, click on the cart icon (Android) or go to the settings (iOS) to buy the Icon Editor Upgrade. The Icon Editor Graphics Upgrade is a one-time payment for a life-time license.

The purchase is however, as it is with all Upgrades, linked to the specific store (and the account used to buy the upgrade). The license is not transferable from Android to iOS or the vice versa. Both Apple and Google do not allow this even if we could make this technically happen, doing so would mean that our app would not be accepted in the stores by Google and Apple. If you have devices of both platforms and you want to use them both with Touch Portal, you need to buy a license for both platforms.

A graphical representation of the Icon Editor Graphics Upgrade
Link to this question
What is the Edge Graphics Upgrade? Touch Portal v2.3 and later comes with Graphic Upgrades that will enable you to add more graphical depth to your buttons and pages. The Edge Graphics Upgrade is such an Graphic Upgrade and will give you the following options for your Pages:
  • 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.
The Edge Graphics Upgrade will give you the following options for your buttons:
  • 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
Each option for the buttons or the pages will have additional settings such as setting the border size, additional button margin and others. The settings are different per option.

The Edge Graphics Upgrade can be bought in the Play Store for Android or in the Appstore for iOS. It is linked to your account and can be used on all devices where that account is linked. In the mobile app, click on the cart icon (Android) or go to the settings (iOS) to buy the Pro Upgrade. The Edge Graphics Upgrade is a one-time payment for a life-time license.

The purchase is however, as it is with all Upgrades, linked to the specific store (and the account used to buy the upgrade). The license is not transferable from Android to iOS or the vice versa. Both Apple and Google do not allow this even if we could make this technically happen, doing so would mean that our app would not be accepted in the stores by Google and Apple. If you have a devices of both platforms and you want to use them both with Touch Portal, you need to buy a license for both platforms.

A graphical representation of the Graphics Upgrade
Link to this question
What is the RGB Graphics Upgrade? Touch Portal v2.3 and later comes with Graphic Upgrades that will enable you to add more graphical depth to your buttons and pages. The RGB Graphics Upgrade is such an Graphic Upgrade and will give you the following options for your Pages:
  • 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.
The RGB Graphics Upgrade will give you the following options for your buttons:
  • 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.
Each option for the buttons or the pages will have additional settings such as setting the border size, the animation speed, additional button margin and others. The settings are different per option.

The RGB Graphics Upgrade can be bought in the Play Store for Android or in the Appstore for iOS. It is linked to your account and can be used on all devices where that account is linked. In the mobile app, click on the cart icon (Android) or go to the settings (iOS) to buy the Pro Upgrade. The RGB Graphics Upgrade is a one-time payment for a life-time license.

The purchase is however, as it is with all Upgrades, linked to the specific store (and the account used to buy the upgrade). The license is not transferable from Android to iOS or the vice versa. Both Apple and Google do not allow this even if we could make this technically happen, doing so would mean that our app would not be accepted in the stores by Google and Apple. If you have a devices of both platforms and you want to use them both with Touch Portal, you need to buy a license for both platforms.

A graphical representation of the Graphics Upgrade
Link to this question
What is the RetroLC Graphics Upgrade? Touch Portal v2.3 and later comes with Graphic Upgrades that will enable you to add more graphical depth to your buttons and pages. The RetroLC Graphics Upgrade is such an Graphic Upgrade and will give you the following options for your Buttons:
  • 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.
Each option for the buttons has additional settings to customize the effects of the graphics upgrade. The settings are different per option.

The RetroLC Graphics Upgrade can be bought in the Play Store for Android or in the Appstore for iOS. It is linked to your account and can be used on all devices where that account is linked. In the mobile app, click on the cart icon (Android) or go to the settings (iOS) to buy the Pro Upgrade. The RetroLC Graphics Upgrade is a one-time payment for a life-time license.

The purchase is however, as it is with all Upgrades, linked to the specific store (and the account used to buy the upgrade). The license is not transferable from Android to iOS or the vice versa. Both Apple and Google do not allow this even if we could make this technically happen, doing so would mean that our app would not be accepted in the stores by Google and Apple. If you have a devices of both platforms and you want to use them both with Touch Portal, you need to buy a license for both platforms.

A graphical representation of the Graphics Upgrade
Link to this question
General issues
Is the User Graphical Interface not displaying correctly or is it distored? This can happen in the following cases:
  1. You need to upgrade your graphics card drivers
  2. You are running RivaTuner. For unknown reasons (java related) using that can mess up the graphics of Touch Portal.
  3. You are running MSI Afterburner. For unknown reasons (java related) using that can mess 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.
Link to this question
Installation on Mac OS X gives a warning from a non-trusted developer? If you try to open Touch Portal installation package it will be identified as a non-trusted developer, you get a warning dialog. This doesn’t mean that something’s wrong with the app. Just be sure to only download our app from our website. To Install Touch Portal:

  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.
Link to this question
The application does not start? Custom Installation paths

Using a custom installation path should generally work but in some cases it can cause issues, our advise is to try to install to the default path to see if the custom installation path is the issue:

  • Specific characters can cause issues making Touch Portal not start up. Best to use the english alphabeth characters only.
  • Using drives that can unmount can cause issues.
Other Java installations are causing issues

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.

TouchPortal folder is not accessible

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
Touch Portal on MacOS is stuck on loading screen

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
Link to this question
The application freezes when I use the interface? Corrupt Settings

Sometimes after a Windows Update or a Systems Java Update the settings may be corrupted. Try to clear the settings by going to the Touch Portal settings and scroll all the way down until you see a big red button with the caption "Reset Touch Portal Settings...". By clicking on that button you will remove all Touch Portal settings. This will not remove your data, like Pages, Events, Buttons, Flows and Value but it will reset the settings of Touch Portal and when you will start Touch Portal again it will look like you install it for the first time again. Go through the onboarding again. After verifying it no longer freezes, you need to redo the settings as those have been reset. Also be sure that the selected connection adapter is still selected.

Other Java installations are causing issues

Touch Portal runs with its own embedded Java but sometimes existing installation can cause issues like making Touch Portal freeze. 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. Also check if there are other entries such as JAVA_HOME
  9. 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.

Graphics Enhancement Applications

MSI Afterburner, RIVA tuner or other overlay gaming or graphics enhancing applications are also known to cause issues with Java that can effect both the visual presentation of Touch Portal as well as causing functional issues. Be sure to close these temporary to see if they are causing this issue.

Link to this question
Startup at boot does not work?

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



Manually add it for start at 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
Link to this question
How to exit fullscreen mode (Android/iOS)? To exit the (experimental) fullscreen mode on Android or iOS you need to tap two times with two fingers to make the action bar appear. This will stay on screen a few seconds before it hides again. During that time you can press the options menu item to get into the option where you can turn off the full screen mode.

Please note that tapping on the screen will also active the buttons or controls that are on the location you are tapping. Best is to tap on an empty space on your Page. Link to this question
Connection Issues
Touch Portal is reconnecting endlessly, how do I fix that? Sometimes it can happen that Touch Portal comes in an endless connect and disconnect loop. Here are the known reasons and fixes for this to happen:
  1. Touch Portal versions do not match. For Touch Portal to be able to connect, please ensure that both the applications on your device and desktop match the version. The build does not matter in this situation. Especially if one is still on version 3.x and the other is on 4.x connections will fail.
  2. Two Devices try to connect to the same desktop, both as primary devices. This is not possible. What happens in this case is that Touch Portal connects to device A, then receives a connection request from device B and will disconnect device A. Since device A is auto-connecting, it will send a connection request again, resulting in the desktop disconnecting device B again, and the cycle continues.

    The fix: Turn off one of the devices and only allow one device to connect to the desktop. Ensure that Touch Portal is no longer running on one of the devices. If it is still running in the background, it will continue to attempt to connect.

  3. The device tries to connect twice simultaneously. What happens in this case is that sometimes, due to timing issues after switching connections (whether it's between profiles or between USB and WiFi), the first one will not stop and will still run simultaneously. This will create a loop of connecting and disconnecting.

    The fix: Fully close the application on the mobile device. This also means that you need to remove it from the most recent apps drawer. This will actually close the background processes as well and is a very important step. Then, wait for 30 seconds for the desktop application to catch up with the timeouts and have a clean start again. Afterward, start the mobile app again, and it should connect without any issues.

  4. The connection ends prematurely. Sometimes, the connection can be shut down before the handshake is finished due to unexpected errors within the system.

    The fix (1): Fully close the application on the mobile device. This also means that you should remove it from the recent apps drawer. This will effectively close the background processes as well and is a very important step. Next, wait for 30 seconds to allow the desktop application to catch up with the timeouts and ensure a clean start. After that, restart the mobile app, and it should connect without any issues.

    The fix (2): In some occasions, fixing the continuous connection issues can be resolved by changing the default Page to something other than the (main) page, then fully restarting Touch Portal (using the system tray option "Close"), and then setting it back to (main) again.

  5. The connection is killed because the port 12134 is used. From version 4.x we have deprecated the port 12134 as the main port. This port is now listening for old connections (meaning version 3.x and lower) to alert you that you are using an old version of the app which is not compatible with the new version. If you still try to use this port as your main it will interfere and that can cause disconnects and partial connections.

    The fix:
    1. Go into the desktop application settings.
    2. Ensure the WiFi port is set to 12135 and the USB port is set to 13145.
    3. Save the settings.
    4. Fully close the Touch Portal desktop application. To fully close the application, use the "Exit" command from the popup menu of the system tray icon.
    5. Keep it closed for now.
    6. Go into the settings on the Touch Portal mobile application as well.
    7. Set the port settings and ensure the WiFi port is set to 12135 and the USB port is set to 13145.
    8. Now also fully close the mobile application. It is important to also remove the application from the recents drawer on your device, this will kill the current connections and running background services. Without doing this, this fix will not work.
    9. Now wait 10 seconds.
    10. First start the desktop application. Ensure that on the network adapter selector at the bottom of the main screen the port 12135 is behind the information of that adapter. This will show that the setting is set correctly.
    11. When you have verified that start up the mobile application as well. You should be having a correct connection again.
Link to this question
Connection between my device and the desktop suddenly stopped? I changed nothing? When using Touch Portal both the desktop application and the mobile app need to be on the same version. The build does not matter but the major and minor version should be the same.

Touch Portal on your mobile device probably updated to a new version (or it auto updated) and assumingly you are running an old version of the desktop software that does not match. To fix this you need to update your desktop software to match you mobile version (again the build does not matter but always best to be on the latest build of that version. Link to this question
Connection issues? Touch Portal cannot connect, help! Touch Portal uses the local network (WiFi and ethernet) system to communicate. Touch Portal is also build in Java. Due to this a lot can interfere with the connection. Here are some checks you can do to get the connections working:

First things first:

  • Touch Portal can only connect 1 primary device at a time, connecting more at the same time will mess up the connections. If you have the multiple devices upgrade, please ensure only 1 device is set as the primary device and all others are set as secundary devices.
  • Touch Portal port setup is important. Please ensure that the WiFi port on both the device and the desktop is set to 12135. Equally important is to NOT use port 12134. This port is reserved and using it will cause issues.

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 frist thing you should do is ensure your network is set to private mode.

    Private networks are secure spaces, like your home or workplace, where devices can connect, see each other, and share resources like files and printers. Public networks, found in places like cafes and airports, are open to many users and prioritize privacy and security by hiding your device from others and disabling file sharing. This also makes it difficult to connect to your Touch Portal device.

    When connecting to a new network, Windows asks you to classify it as public or private. You can adjust this setting at any time. To switch from a public to a private network in Windows, simply click the Wi-Fi icon on the taskbar, go to the network's Properties, and choose the Private option. This change can also be made through the Network & Internet settings in the Windows Start menu.
  2. The second 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.


  3. 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.

  4. 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)

  5. For some Firewalls or Anti-Virus you also need to add the ports (all of them) to your whitelist. Try this as well.

  6. 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.

  7. 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.

  8. 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”

  9. 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.

  10. 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.
If all these steps did not work for you, please let us know on our Discord server where we can help you. Link to this question
Touch Portal has delays, execution of buttons slow When you experience delays with Touch Portal button execution or seeing loading feedback when pressing buttons check if the following situations fit yours:
  • Killer Networking / Killer Intelligence App - The Killer software / services can mess with your connection a great deal. While it is meant to improve connections slightly, it can really cripple your connection in other cases. For Touch Portal we have seen different situations where this software messes up the connection by blocking the connection or giving it low priority which will have a negative impact on the communication between the device and the desktop. If the Killer Priorization engine is turned on, best to turn it off, we have reports (and tested it ourselves as well) where the upload goes from 3Mbps to full speed (of 100Mbps and higher for example). Also, after a Windows reboot the engine might be turned on again so if you start to experience issues again due to that setting be sure to check if it is still off.
  • BitDefender installed - If you have BitDefender installed on your system it will cripple the functionality of Touch Portal. In all cases the issues have gone away after uninstalling BitDefender so our advise it to uninstall and use a different security software package. We have tried to find a way to get them working side by side but even when everything is turned off in BitDefender it still causes issues. The only fix was to uninstall BitDefender. Important to note, this may have just been an issue on some specific versions of BitDefender and my no longer be an issue.
  • Network is underperforming - For some users their network was underperforming which resulted in lost communication or slowed communication. Try pinging your mobile device from your desktop and check the ping times. If they are to long it can cause a lowered performance. The solution here is to get professionals to check your network to see where it can be improved.
  • Device old and slow - As we try to support old OS versions, some supported devices are very old and thus a bit slower, while this seems to be highly related to the hardware in devices it can make the communication slow. We have seen very old Samsung devices work perfectly fine while newer lesser known brands sometimes are slower. Usually this is related to the combination of the processor used and the hardware for wifi or usb. On top of that the manufacturer OS implementation may make it even worse. For iOS we have noticed that some very old devices can be very slow.


Link to this question
I can connect but no icons are shown? First, Touch Portal functions from its (main) page, this will be the first page that is opened when running the mobile version. From this page you can navigate to other pages. If you have no buttons on this page then it will show an empty page but you cannot use Touch Portal at that moment.
Ensure the (main) page has buttons and ensure that you have navigation buttons to navigate to the pages you want from that (main) page.

Also try to fully close the Touch Portal desktop and mobile app and restart both. Just to make sure everything is setup correctly as a fresh start. (You can do this by right clicking on the Touch Portal icon in your system tray. Choose the option "Exit". This will fully close the application including the background processes and services. When it is closed you can start Touch Portal again.)

For the iOS users, ensure that the WiFi port is 12135 on the desktop app. Do not use port 12134 as this is reserved and using it will cause issues.

Also, sometimes the communication just fails because of network hiccups. Try restarting Touch Portal fully. (You can do this by right clicking on the Touch Portal icon in your system tray. Choose the option "Exit". This will fully close the application including the background processes and services. When it is closed you can start Touch Portal again.)

Link to this question
What IP address and port do I need to connect? The desktop app shows you the IP address and the port in the lower left corner of the app. The IP address has the format x.x.x.x (where each x can be a number from 0 to 255) and the port has the format xxxx. You can change the port (default and prefered is 12135) in the desktop app if you want to use a different port for communication with the mobile app. But do not forget to change it on the mobile side as well. Please only use a different port when absolutely necessary. Link to this question
I cannot get USB to work in iOS? At the moment we do not support USB mode for iOS devices. Link to this question
I cannot get USB to work in Windows? We support USB connection between Android (5.0 and higher) and Windows only at the moment. For this to work, you need to turn on ADB-Debugging on your Android phone. This allows for us to communicate through USB with an Android phone.

You can do this with the following steps:
  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.
The proper way to initiate a USB connection is:
  1. Set Touch Portal Mobile in USB mode
    1. Go to settings
    2. Set connection type to USB
    3. Leave the settings screen
  2. Wait a few seconds for it to automatically connect.
    1. If it does not reconnect, press the fresh button to force a reconnect.
  3. Your page should now be visible on your mobile!
If the above steps did not work:
  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 reverse --list
    3. This should show a list of port reversed. Yours (default 13145) should be there.
      1. If not?
      2. Type: adb reverse 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
  5. If all checks out but it is still causing issues, the next step is to uninstall TP on Android and reinstall it again. (be sure to use the correct Google Account so that you still have your Upgrades). It seems that on Android the app is not always closed properly when updating which can result in a partly updated app which breaks functionality. A reinstall fixes this issue.
Link to this question
Can I connect multiple devices to one desktop? Yes! You can now connect multiple devices (both iOS and Android) with the Multiple Devices Upgrade. Read more in the FAQ item about the multiple devices upgrade. Link to this question
Pages
Can I have multiple pages of buttons? Yes you can. With the free version you only get one additional page. The first page you access on your mobile device will be the only additional page you can access. With the Pro upgrade you have an unlimited amount of pages to your disposal. Link to this question
I am using the free version and my additional page is a mistake, help!? Do not worry, if you fully close down the Touch Portal desktop app and restart it the additional page is reset and you can access a different one. You can also just recreate the existing page of course. Link to this question
Can I use a different grid size for each page? Yes you can specify for each separate page what the grid size should be. This option is however, only available in the Pro Upgrade. Link to this question
How do I go to another page? First thing to note is that the desktop app is for editting your pages. It does not reflect the state of usage. This means that when you change a page on your desktop, it is not changed on your mobile device.

To go to another page on your mobile device you need to create a Go To Page action that point to the page you want the button to go.
You can find the action in the navigation category.
Example of the action in a button.


If you are a free user you can only go to one additional page. If you want to have access to an unlimited amount of pages, get the pro upgrade. Link to this question
Buttons & Actions
How do I make a toggle button? We have made a tutorial that walks to each step to create a toggle button. Check it out: Tutorial: Create a Toggle Button Link to this question
How do I make radio buttons or set the state of another button? We have made a tutorial that walks to each step to create radio buttons. It also shows you how to set the state of another button. Check it out: Tutorial: Create Radio Buttons Link to this question
Not all actions are triggered? Help! As Touch Portal integrates with third party software like OBS, Streamlabs Desktop and such we depend on their implementation as well. What we have encountered is that Touch Portal sometimes triggers actions to fast. But this also depends on the machine used or the quality of the network. If you try to add a timer action between actions those system often get enough time to handle the first request and to be ready to handle your second request. Link to this question
My POST action does not work but on PostMan/Other it works?
  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 may 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
Link to this question
Key press works in application X but not in application Y? Help! The keypress done by Touch Portal are software simulated key presses. Sometimes this does not work for specific reasons, here is a list of reasons with possible solutions:
  1. You are using the Virtual Key Presses. While these will work in most applications, sometimes you need to use Low Level Key Presses to make it work. We advise to use the Low Level Key Presses instead of the virtual keys as the Lowl Level Key Presses have better performance and simulate actual key presses a bit closer. For more information, check our Guides section.
  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 requires a specific or minimal duration of the press, try fiddling with the duration of the button press.
  4. 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.
Link to this question
Mouse Clicks work in application X but not in application Y? Help! The mouse clicks done by Touch Portal are software simulated mouse clicks. Sometimes this does not work for specific reasons, here is a list of reasons with possible solutions:
  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.
Link to this question
Key presses do not work on my Mac
  1. Since a macOs update you have to add Touch Portal in the security & privacy settings. If Touch Portal is already added, please remove it and re-add it again. Security & Privacy >> remove >> add >> Touch Portal
    Do this in the categories Accessibility and Input Monitoring.
  2. Also ensure that Touch Portal is installed into the applications folder.
  3. On Mac there is known issue for some users where using Virtual Key Presses with the CMD fail to execute when you move your mouse. This is a bug in the underlying used framework. Since then we have added Low Level Key Presses for MacOS and these do not have the same issues, best to use them instead. If you still have issues you can also use a workaround which is to use the Apple script functionality to do the key presses. An example:
    tell application "System Events" to keystroke "a" using command down
    You can add this directly in the Apple Script action in Touch Portal.
Link to this question
Why can't I open cmd.exe by referencing it? The cmd.exe on windows is a commandline tool. It has no visible gui. When you double click the cmd.exe, windows basically overrides the execution by running conhost.exe, which is the visual representation of the cmd box we often see and use.

So if you want to open the cmd box, use conhost.exe instead. Link to this question
Why are my Powershell scripts not running? Touch Portal requires that the execution policies of Powershell are unrestricted. By default Windows sets it on restricted so we need to change that. Do the following:
  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)
Link to this question
WebView Control
My url is not showing? The Webview control of Touch Portal uses the systems webview functionality of the mobile device. This means that usage is also limited to what the OS provides.

Correct Protocol
All urls need to be correct urls. Touch Portal will not add parts such as the https. So in order to make it work, use full correctly formatted urls, such as 'https://www.touch-portal.com'

Android 4.x
Android 4 does not support https communication so the only urls that will work with the webview are http variants. As all modern browsers these days only support https so all modern websites and such are https only often, so usage is limited on this Android version.

Android 5.x and 6.x
Android 5 and 6 do not support https communication out of the box but in most cases offer webview updates that allow https. This means you have to update the webview provider (usually from the play store or the manufacturer apps store) to be able to use an https url. Not all manufacturers have such a webview update. Find documentation on your device to see what your situation is and what you need to do.

Android 7.x and 8.x
These versions should support both https and http, however specific manufacturers might have already removed http support in these versions.

Android 9.x and up
On these version http is not allowed anymore and such connections cannot be made. Only https is supported in these OS versions. However, in some cases, these limitations can be lifted. You can use the WebView options in the mobile app settings to reduce the checks and in some cases the http urls may still function.

Link to this question
OBS
How do I get started with OBS?
  1. Start OBS Studio
  2. Ensure the Websocket entry is in the Tools menu of OBS, if not, you may need to do a "Check File Integrity" from the OBS help menu, that option will check if anything is wrong and reinstall the plugin.
  3. Open the settings of the Websocket
  4. The websocket is turned OFF by default since it is shipped with OBS itself (version 5+ of the plugin), please make sure to enable it.
  5. Start Touch Portal
  6. You should be connected to OBS Studio from Touch Portal now as Touch Portal will auto connect.
  7. If you use custom ports, please ensure that these are set up correctly in Touch Portal as well, otherwise the connection cannot be made
  8. Sometimes the authentication blocks the connection, please ensure that you set a password yourself in OBS manually (do not copy paste it) and also add the same manually in Touch Portal, again do not copy paste it as that sometimes does not work.
  9. Enjoy!
Link to this question
OBS Connection issues? First, did you check out our How to connect to OBS tutorial? Otherwise:
  • Updating from older versions of OBS to version 30.2.0 will disable the websocket in OBS. This causes Touch Portal to no longer be able to connect since the connection system from OBS is switched off in the OBS Websocket. Enable the websocket server again and Touch Portal should be able to connect again. You might need to fully close Touch Portal to ensure no old corrupt connection may still linger if the connection still failed after turning the websocket on.
  • Assuming you have the websocket in the Tools menu in OBS, ensure that the "Enabled websocket" is actually enabled. It is disabled by default.
  • 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.
  • Double check if you have the correct ports setup in both Touch Portal as the OBS Websocket plugin settings.
  • Use localhost as the ip in Touch Portals OBS settings. Only change this when you want to connect to an OBS on a different computer AND you have the Pro Upgrade.
Link to this question
Touch Portal crashes my OBS! Help! Touch Portal does not control OBS directly. Touch Portal is not even aware of OBS. This means that Touch Portal cannot crash OBS. Then why does OBS crash when using Touch Portal?

Touch Portal works with the OBS WebSocket plug-in which in return communicates with OBS itself. As Touch Portal can only send request in text form to the websocket, this means the websocket is the gate keeper of the process. If there is anything the websocket does not like about the message received from Touch Portal it will simply be rejected.

If the message is accepted, Touch Portals work is done and will, depending on the request, wait for the result.

The websocket will now process the message and do what it needs to do to fulfill the request or report back it could not do so because of reasons. This is the first time OBS comes into the picture. After TP is no longer in the picture. If OBS crashes, this means either the call the websocket made to OBS makes it crash or the websocket itself crashes which makes OBS crash.

But if it is not Touch Portal, what is?

What we have seen in reports from our users, the biggest culprits are filters. Usually old VSTs or OBS plugins causing issues. What happens is that because of Touch Portal, the websocket request information about those filters from OBS. OBS wants to provide these but somewhere along the line it cannot and crashes.

What can we do?

You can turn on the debug logging of the websocket plugin in OBS. It will add additional logging in the logs. Usually it will register the moment of the crash and you can read back what the last requests where from Touch Portal and process by the websocket. Usually the last one shows where and what was requested and which probably made it crash in the end. Finding the filter or the source and remove it to test if it is indeed fixing the crash. As multiple filters can crash, removing them all is best when testing. Once you find the bad one, either not use it anymore or ask for support from the devs of that filters or source. If they are not available or cannot help you, best to ask for support from the websocket dev team and tell them about the source/filter. They can check if they can make a fix or if you need to bring it to OBS as a bug report.

Any know sources or filters causing issues?

Currently we have received reports for the following sources/scenes and filters:
  • Audio Monitor by Exeldro - User reports have mentioned this no longer makes OBS crash since their version 0.8.3
  • Audio Move - only happens when you close OBS
  • Win-Capture-Audio
  • Old instrument VSTs


Link to this question
Start Application action fails to start OBS (Portable)? OBS exectables have always been difficult to start as when they are not started in the optimal environment it will not work or ask to install new VC redist. Currently there are two known methods to get it to start without issues:
  1. You can start OBS without issues using the action called Launch Apps & Games where you can select to start OBS. If you use a portable version of OBS you might need to pin a shortcut to the Windows Start Bar. This will make the portable version visible in the Launch Apps & Games action. A restart of Touch Portal may be required.
  2. If you go into the settings of the portable OBS shortcut you can set it to be started as Administrator. This should make it start with the Start Application action.
Link to this question
Philips Hue
Connecting the Hue Bridge halts in the process? Touch Portal relies on the Hue API to provide a list of available bridges. Touch Portal uses the https://discovery.meethue.com endpoint to get all the bridges. If you use this link in your browser and it does not show you the data of the bridges but some error then this means that something is wrong with the Hue environment.

If this happens, no worries, we can omit the search phase and directly connect the bridge if you have the ip-address with the following steps:
  1. Fully close Touch Portal desktop. Right click on the system tray icon and select "Exit" to fully close Touch Portal.
  2. Find the ip of the bridge you want to connect. Usually it can be easily found in the official Hue App on your phone
  3. Go to the location %appdata%/TouchPortal. This will open the data folder of Touch Portal. You will see a file called config.properties (if it is not there, create it), open this file in a text editor.
  4. Add the following line:

    hueBridgeOverride=111.111.111.111

    and change the 111.111.111.111 with the actual ip of the philips Hue bridge.
  5. Save the file
  6. Start Touch Portal and try to add a bridge again. It will now skip the search phase and it will directly connect to the specified ip address. If it is the ip address of the bridge it should show you the correct steps to connect it.
Link to this question
Streamlabs Desktop
I cannot connect to Streamlabs Desktop? Currently we have not yet implemented the just released Streamlabs Desktop version for Mac. We currently only support windows. Keep an eye out on our Twitter to know when we do.

Streamlabs Desktop should just connect when both Touch Portal desktop and Streamlabs Desktop are running. If this is not the case, one of the applications is running in admin mode. Either both should, or neither. If only one is running in admin mode they cannot connect. We prefer Touch Portal not to be run in admin mode. Since not to long ago we added an updater to Touch Portal. For Streamlabs Desktop this means that TouchPortalGui.exe needs to be in admin mode, not just the TouchPortal.exe.

Streamlabs Desktop uses a file based communication protocol. This file writing can be blocked by anti-virus software and/or firewalls. Check if everything else seems to be fine and it is still not working if this is the case by temporarily turning of those services. After checking, turn them back on again. If it did fix the issue, try the manual of that software to see how to allow this. Link to this question
XSplit
How do I get started with XSplit?
  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
Link to this question
Twitch
The Twitch action is not working, help? For Twitch to work in Touch Portal you need to connect your account AND create a chattoken. Twitch API systems (end point which we talk to) are divided into two systems, the first is for the direct Twitch actions, the second for the chat interactions.

  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 ). Be sure to turn on the Twitch logging in the logs section first, otherwise nothing gets logged.
  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
Link to this question
Twitch was working but it is not anymore? When connecting Twitch to Touch Portal you use tokens that are only valid for a certain amount of time. This time seems to be somewhere between 20 and 30 days. The reason Twitch does this is for security reasons and is to protect its users.

This does mean however that you as a Touch Portal user need to reconnect your account each time this happens. We unfortunately cannot do anything about this.

If this happens, do the following:
  1. Go to the settings screen
  2. Click on the Twitch section
  3. Remove all entries
  4. Connect your account 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.
Link to this question
Twitch slash commands are not working anymore? Twitch decided to remove the slash commands functionality from the chat API. Touch Portal was using the chat API to do slash commands. Instead of using the chat action you should now use the dedicated actions for the specific slash commands you used to do. If the dedicated action is not available for the specific slash command you want to use, let us know on discord in the suggestions channel and we will work on adding it.

Be sure to update your Touch Portal desktop to the latest version to have access to the dedicated actions. Link to this question
X (formerly known as Twitter)
Cannot connect X (Twitter) anymore? X has removed their v1 API version and has forced all developers to move to their v2 API. This migration introduced a few new restrictions unfortunately. Due to these restriction we can no longer provide a native integrations for X anymore.

However, A plug-in developed by one of our community members can allow you to still use an X integration. It's available in the ⁠⁠twitter-extras channel on our Discord server. This new plugin not only has all the actions we previously had but has also introduced several additional actions to enrich your X (Twitter) interaction.

Link to this question
Touch Portal Assets
I submitted asset but they are not added? You can submit your assets (pages, icons, plug-ins). But as not everybody knows or understand, most assets you use or recreate are protected with copyright. If you do have the rights, please let us know when you submit an asset.

Based on this, we probably will decline most of the submitted assets as for example people like to make packs with icons of applications that you can start but most of the time the usage of the icons of suchs application is prohibited. Therefore we will not allow it on our website.

If you have any questions on this, please visit us on our Discord to talk about this. Link to this question