⚠️ Before You Begin

Make sure to record the TOKEN for the affected device. You may need it if TPControl needs to be reinstalled.
Tokens can be managed via: http://tpcloud.touchpanelcontrol.com


Available Options

Option 1: Reprocess the TP4 File

  1. Open TPControl Settings (see guide here) and navigate to Developer Settings → UI File Options

  2. Enable Reprocess TP4 File

  3. Launch/Relaunch TPControl.
    When prompted with "Settings were changed", tap OK.

If the issue persists, proceed to the next option.


Option 2: Clear the UI File

  1. Open TPControl Settings (see guide here) and navigate to Developer Settings → UI File Options

  2. Enable Clear User Pages — this will remove the UI file.

  3. Enable TPCloud Update in TPControl Settings

  4. Relaunch TPControl.
    When prompted with "Settings were changed", tap OK.

If the device is configured in TPCloud, it will automatically download the necessary UI and settings.


Option 3: Reinstall TPControl

If TPControl continues to crash on launch even after trying Options 1 and 2:

  1. Uninstall TPControl from the device.

  2. Reinstall TPControl from the App Store.

  3. Use the previously recorded TOKEN to restore the UI and settings via TPCloud.