Troubleshooting

Having trouble? Let's get it sorted out. Find common issues and solutions below.

If the application doesn't open after installation, it might be blocked by Windows Defender or antivirus software.

  1. When you first run the app, you might see a "Windows protected your PC" screen. Click on "More info" and then "Run anyway".
  2. Check your antivirus software's quarantine section to see if it has blocked `TCG_Timer.exe`. If so, mark it as safe.
  3. Try running the application as an administrator. Right-click the icon and select "Run as administrator".
  4. Ensure you're running Windows 10 or Windows 11 64-bit.

If you see a black screen on the Roku app, despite a timer being enabled, this is due to the server being inaccessible.

  1. Ensure that you entered the correct IP address and port when configuring the Roku app. It is formatted as IP:PORT. The port number for the Windows server is 5000, 80 for the Linux server, and 8080 for the Linux server with Docker.
  2. Ensure the appropriate TCP port is allowed in the Windows Firewall for inbound connections. If you're running the Linux server as a virtual machine on a Windows host, you still need to allow the inbound connection in Windows Firewall.
  3. Ensure you're properly connected to the same network as your server.
  4. Ensure the server service is running.
  5. You will have to uninstall and reinstall the TCG Timer Roku app in order to be prompted to update the IP:PORT information.

Check to see if a conflicting web server is running on TCP/80.

sudo ss -tlpn | grep ':80'

The file size of the logo you tried to upload is too large. The file size maximum is 1MB. Try reducing the size of the logo and try again.

Still stuck?

If your issue isn't listed here, the community might be able to help. The best way to get support for a new issue is to report it on our GitHub page.

Report an Issue on GitHub