ChanoX2 Troubleshooting

Common problems and solutions for ChanoX2.

---

Installation Issues

Windows: “Windows protected your PC”

Problem: Windows SmartScreen warning about unknown app

Solution:

1. Click More info
2. Click Run anyway

Or temporarily disable SmartScreen:

1. Open Windows Security
2. Go to App & browser control
3. Disable Check apps and files

---

macOS: “Can’t be opened because it is from an unidentified developer”

Problem: Gatekeeper blocking the app

Solution:

Method 1: Through System Preferences

1. Open System Preferences → Security & Privacy
2. Click Open Anyway for ChanoX2

Method 2: Using Terminal

xattr -cr /Applications/ChanoX2.app

---

Linux: AppImage Not Working

Problem: AppImage won’t open

Solution:

1. Grant execute permission:

chmod +x ChanoX2-x.x.x.AppImage

2. Install FUSE (if not installed):

# Ubuntu/Debian
sudo apt install fuse libfuse2

# Fedora
sudo dnf install fuse fuse-libs

---

Usage Issues

Games Not Showing in Library

Possible causes:

• Folder not added to Scan Folders
• Games are hidden
• Invalid executable files

Solution:

1. Check Settings → Library → Scan Folders
2. Go to View → Show Hidden Games
3. Try adding games manually (+ → Add Game)

---

Game Won’t Launch

Step-by-step solution:

1. Check executable

   • Right-click game → Properties
   • Verify the path is correct

2. Test direct launch

   • Right-click → Open Folder
   • Try launching game directly from folder

3. For Windows games on Linux

   • Check Wine/Proton is enabled
   • Go to Settings → Games → Windows Compatibility

4. Check Logs

   • Go to Help → View Logs
   • Look for error messages

---

Wrong Engine Detection

Solution:

1. Right-click game → Properties
2. Go to Engine tab
3. Manually select the correct engine

---

Cover Images Not Showing

Solution:

1. Re-download

   • Right-click game → Refresh Metadata

2. Add manually

   • Right-click → Properties → Cover
   • Click Upload and select image

3. Clear Cache

   • Settings → Data → Clear Image Cache

---

Performance Issues

App is Slow/Laggy

Solution:

1. Reduce Animations

   • Settings → General → Disable Animations

2. Disable Hardware Acceleration (if GPU issues)

   • Settings → Advanced → Disable Hardware Acceleration

3. Optimize Database

   • Settings → Data → Optimize Database

4. Clear Cache

   • Settings → Data → Clear All Cache

---

High RAM Usage

Cause: Large library or high-resolution cover images

Solution:

1. Reduce Grid size in Grid View
2. Use List View instead
3. Reduce games displayed per page

---

Linux-Specific Issues

Wine: Game Not Working

Steps to fix:

1. Check Wine version

   wine --version

2. Try Winetricks

   • Go to Settings → Games → Winetricks
   • Install required dependencies like vcrun2019, dxvk

3. Use Proton instead

   • Settings → Games → Select Proton

---

Audio Not Working

Solution:

# Install PulseAudio support for Wine
winetricks sound=pulse

---

Submitting Bug Reports

If you still can’t resolve the issue:

1. Gather information

   • Go to Help → Export Logs
   • Save the log file

2. Create GitHub Issue

   • Go to GitHub Issues
   • Click New Issue
   • Attach log file and describe the problem

3. Contact Discord

   • Join Discord
   • Go to #support channel

---

FAQ

Is ChanoX2 free?

Yes, ChanoX2 is open source and 100% free

Where is game data stored?

• Windows: %APPDATA%/ChanoX2
• macOS: ~/Library/Application Support/ChanoX2
• Linux: ~/.config/ChanoX2

Does it support plugins or extensions?

Not currently, but it’s in development

Are there plans to support console games?

There are plans to support emulator integration in the future