Skip to content

Troubleshooting Guide

This guide provides solutions to common issues encountered while using GameFlow Connect. If your issue is not listed here, consider checking the FAQ or reaching out to the project maintainers.

Common Issues and Solutions

1. Application Fails to Launch

Cause: Missing dependencies or incorrect installation.

Solution:

  • Verify that Python, Tkinter, and Git are installed on your system.
  • Ensure all dependencies listed in requirements.txt are installed by running: 
    pip install -r requirements.txt

2. Unable to Authenticate with Google Drive or GitHub

Cause: Authentication token not generated or expired.

Solution:

  • Double-check your credentials.
  • For Google Drive, ensure OAuth credentials are correctly configured in your Google Cloud project.
  • For GitHub, verify that your personal access token has the required scopes (e.g., repo access).

3. Files Not Syncing with Google Drive

Cause: Network connectivity issues or incorrect API setup.

Solution:

  • Check your internet connection.
  • Verify API credentials in the configuration file.
  • Restart the application to reinitialize API connections.

4. Git Operations Failing

Cause: Misconfigured repository or invalid Git commands.

Solution:

  • Ensure the correct repository is linked in the application.
  • Verify your SSH key or HTTPS access settings.
  • Run the following to reset the Git connection: 
    git remote remove origin
git remote add origin <repository_url>

5. UI Freezing or Slow Performance

Cause: Excessive operations or large datasets.

Solution:

  • Optimize file operations and reduce the size of datasets.
  • Restart the application if it becomes unresponsive.
  • Check for application updates that may include performance fixes.

6. Inno Setup Installer Fails with Error 4551 (Access Control Policy)

Cause: Windows Defender Smart App Control, AppLocker, or a Software Restriction Policy (SRP) is blocking the execution of temporary installer files inside the default user %TEMP% directory (e.g., ERROR_ACCESS_DISABLED_BY_POLICY / 0x11C7 / 4551).

Solution: - Alternative 1: Use the Portable Package (Recommended) Instead of running the installation wizard, simply distribute or use the compressed portable ZIP version generated at dist/GameFlowConnect_v<version>_Portable.zip. Extract the ZIP to any directory (e.g., C:\GameFlowConnect) and run GameFlowConnect.exe directly. Since it does not extract temporary stubs to the user Temp directory, it completely bypasses the access policy blocks.

  • Alternative 2: Override the Temp Directory via CMD If you still want to run the installer, override the temporary directory variables for the installation session using a command prompt:
  • Open Command Prompt (CMD).
  • Create a temporary folder on the root of your drive (which is usually not restricted by temp-folder policies): 
    mkdir C:\Temp
  • Override the session's temp variables and run the installer: 
    set TEMP=C:\Temp
set TMP=C:\Temp
cd path\to\installer
GameFlowConnect_Setup.exe
    This redirects the temporary files extraction to C:\Temp, bypassing the policy block on the user AppData Temp folder.

Contact and Reporting Issues

If the above solutions do not resolve your issue, you can: - Check the GitHub Issues page for similar problems or report a new issue. - Include detailed steps to reproduce the problem, along with relevant error logs or screenshots.

Troubleshooting Updates

  • This troubleshooting guide will be updated regularly as new issues and solutions arise.
  • Contributions to improve this guide are welcome through pull requests!