Troubleshooting

Something looks wrong? One command makes a small report you can send us. No extra software needed.

Locked out right now?

Force Quit always works: Cmd+Option+Esc on a Mac, Ctrl+Alt+Delete on Windows. And if the screen ever fails to appear, Sukhi Play unlocks itself after twelve seconds.

1. Close Sukhi Play

Hold Close for three seconds. The check can’t start while the app is already open.

2. Run the check

Copy the line for your computer, paste it, press Enter. A window opens for a few seconds, then closes by itself.

MacOpen the Terminal app

"/Applications/Sukhi Play.app/Contents/MacOS/Sukhi Play" --diagnose

WindowsOpen PowerShell from the Start menu

# installed
& (gci "$env:LOCALAPPDATA\Programs" -Recurse -Filter "Sukhi Play.exe")[0].FullName --diagnose
# portable
& ~\Downloads\Sukhi-Play-Windows-Portable.exe --diagnose

LinuxOpen a terminal

# Snap or .deb
sukhi-play --diagnose
# AppImage
~/Downloads/Sukhi-Play-Linux.AppImage --diagnose

Windows: a specific problem?

Use the same line, but swap --diagnose for:

--cover-probe if the taskbar still shows
--key-probe if a key isn’t being held

3. Send us the report

A file called sukhi-play-diagnose.txt is now on your Desktop. Open a new issue, say what you expected to see, and drag the file into the box.

Open an issueOn GitHub, free account needed See known problemsSomeone may have hit it already

Working from the source code instead? npm run diagnose does the same thing.