Troubleshooting
Solutions to common issues and problems you might encounter with suyu
Common Issues
🚫 suyu Won't Start
Symptoms: Application crashes on startup or shows error messages
Solutions:
- Update your graphics drivers to the latest version
- Install Microsoft Visual C++ Redistributables
- Run suyu as administrator (Windows)
- Check if your antivirus is blocking suyu
🎮 Games Won't Load
Symptoms: Games show errors when trying to launch
Solutions:
- Ensure you have the correct firmware installed
- Verify your keys (prod.keys, title.keys) are present and valid
- Check if the game file is corrupted
- Install any required game updates
🐌 Poor Performance
Symptoms: Low FPS, stuttering, or slow gameplay
Solutions:
- Enable multicore CPU emulation
- Switch to Vulkan graphics API
- Lower resolution scaling
- Disable unnecessary graphics enhancements
- Close background applications
🔇 No Audio
Symptoms: Games run but produce no sound
Solutions:
- Check audio device selection in suyu settings
- Try different audio output engines (Cubeb, SDL2)
- Verify system audio is working
- Restart suyu after changing audio settings
Graphics Issues
🖼️ Visual Glitches
Symptoms: Corrupted textures, missing graphics, or rendering errors
Solutions:
- Try switching between Vulkan and OpenGL
- Update graphics drivers
- Disable assembly shaders if using NVIDIA
- Change GPU accuracy settings
💥 Graphics Driver Crashes
Symptoms: System freezes or driver resets during gameplay
Solutions:
- Lower resolution scaling
- Disable asynchronous GPU emulation
- Use OpenGL instead of Vulkan
- Reduce graphics settings
Input Problems
🎯 Controller Not Working
Symptoms: Controller input not recognized or mapped incorrectly
Solutions:
- Reconfigure controls in Emulation → Configure → Controls
- Try different controller profiles
- Update controller drivers
- Use Steam Input if available
Error Codes
Common Error Codes
Error 2002-4518
Missing or invalid system firmware. Install the latest firmware.
Error 2168-0002
Missing title keys. Ensure prod.keys and title.keys are properly installed.
Error 2002-2060
Corrupted game file. Re-dump or re-download the game.
Getting Help
📞 Support Channels
If you're still experiencing issues after trying these solutions:
- Check our FAQ page for additional help
- Visit our GitHub Discussions
- Join the community on Reddit
- Report bugs on our GitHub Issues
📋 When Reporting Issues
Please include the following information:
- suyu version and build date
- Operating system and version
- Hardware specifications (CPU, GPU, RAM)
- Game title and version
- Steps to reproduce the issue
- Log files (if applicable)