Troubleshooting Guide
FreshConnection Issues
Device Not Detected
Phone Shows "Offline" in ADB
| Cause | Solution |
|---|---|
| Phone denied access | Re-plug phone, click "Allow" on device |
| Outdated ADB version | Upgrade ADB |
| Loose cable | Replace USB cable |
Phone Shows "Unauthorized"
Re-plug the phone and tap "Allow" in the authentication popup on the device.
"Get Screen Failed" Error
| Cause | Solution |
|---|---|
| PC program issue | Run TC as administrator |
| Mobile app startup failed | Close and restart mobile app |
| Incorrect screen data | Disconnect and restart phone |
| Missing files | Reinstall TC |
"Starting Service" Hangs
- Reconnect the phone
- Restart the phone
- Uninstall TC app from phone, then reconnect
APK Installation Failed
- Enable Install from Unknown Sources on the phone
- Re-plug the phone
- Manually click "Install" if prompted on the device
TCP Connection Issues
| Issue | Solution |
|---|---|
| Connection fails | Verify same LAN, disable firewall |
| Frequent disconnections | Use 5GHz WiFi, move closer to AP |
| "Need USB first" | Set USB to charging-only before unplugging |
| "Agree" not showing | Remove notification confirmation in settings |
| Drops after screen off | Disable TCP sleep, keep WiFi active in sleep |
Display Issues
Black Screen After Connection
| Scenario | Solution |
|---|---|
| Desktop Mode black screen | Change turbo mode (1 to 2 or vice versa) |
| MDCC black screen | Adjust resolution in phone settings |
| Partial display | Change resolution from 2K to 1080P |
| Green border on screen | Switch 1080P to 720P |
Screen Display Incomplete
- Settings > Image Quality & Mode > Device Acceleration
- Change "Turbo mode 1" to "Turbo mode 2"
- Adjust phone resolution to highest setting
Physical Buttons Not Showing
Check Auto or Display in Phone Settings > Advanced Settings.
Performance Issues
Slow Frame Rate / Response Delay
- Click settings icon in device window
- Find Advanced Settings > PC Acceleration
- Try different turbo modes
- Changes require reconnection
Battery Savings
If battery drains quickly, set Device Acceleration to Turbo Mode 1 (lower quality, less power).
ADB Issues
Checking for ADB Conflicts
bash
adb devicesIf you see "out of date" or "kill-server" errors:
- Stop all Android tools (360 Mobile, Samsung tools, etc.)
- Search system for
adb.exefiles - Keep only TC's version, delete others
- Restart TC
Error 1019/1033 Recovery
Right-click device > enter shell, then run:
bash
pm uninstall com.sigma_rt.totalcontrol
pm uninstall com.sigma_rt.totalcontrol.test
rm -rf /data/local/tmp/tc/*Then re-plug the phone.
Brand-Specific Issues
Xiaomi / Redmi
- Enable USB Debug (Security Settings) in Developer Options
- Enable USB Installation for APK install issues
- Set TC to "Unlimited" in Settings > Power and Performance > App Configuration
- MIUI hidden mode blocks data — change TC app configuration
Huawei
- Android 8.0+: Enable "ADB debugging in Charge Only mode" for TCP
- HarmonyOS: Allow app background running in battery settings
Samsung
- Post-Android 7.0: Custom resolution may cause partial display
- Change to 1920x1080 or use Turbo Mode 2
VIVO
- Unplug USB before opening Developer Options if settings can't be accessed
- Enable USB Debug (Security Settings)
Environment Issues
"Hash license failed" Error
User-modified environment variables cause this. Fix:
- Right-click My Computer > Properties > Advanced System Settings
- Environment Variables
- Change TMP and TEMP to
%USERPROFILE%\AppData\Local\Temp
Intel E-Series CPU Warning
Intel E-Series processors lack integrated GPU and are significantly slower for TC. Use I-Series instead.
Graphics Card Issues
TC client interface misplacement or display errors:
- Update/replace graphics driver
- Try disabling current graphics card temporarily