Troubleshooting Guide

Fix Common Issues

Step-by-step solutions for the most common AntiMicroX problems

Quick Solutions

Controller Not Detected

Most common issue

Your controller is connected but AntiMicroX doesn't recognize it.

Quick Fix:

  1. Restart AntiMicroX as administrator
  2. Try a different USB port
  3. Update controller drivers
  4. Check Windows Game Controllers panel

Input Lag

Delayed response

Noticeable delay between button press and action execution.

Quick Fix:

  1. Lower polling rate to 500Hz
  2. Close background applications
  3. Use wired connection
  4. Disable Windows Game Mode

Mapping Not Working

Buttons don't respond

Button mappings are configured but don't work in games.

Quick Fix:

  1. Check if profile is active
  2. Disable Steam Input
  3. Run game in windowed mode
  4. Verify target application focus

Bluetooth Issues

Wireless problems

Controller connects but frequently disconnects or has poor response.

Quick Fix:

  1. Update Bluetooth drivers
  2. Remove and re-pair controller
  3. Check for interference
  4. Disable power saving

Macro Problems

Sequences not executing

Macros are configured but don't execute properly or consistently.

Quick Fix:

  1. Check macro timing settings
  2. Verify key sequence accuracy
  3. Test in simple applications first
  4. Adjust delay between actions

Profile Issues

Loading/saving problems

Profiles won't load, save, or auto-switch properly between applications.

Quick Fix:

  1. Check file permissions
  2. Verify profile file integrity
  3. Reset to default profile
  4. Clear application cache

Platform-Specific Solutions

Windows Issues

Windows 11 Compatibility

Some users experience issues with Windows 11's enhanced security features.

Solutions:

  • Add AntiMicroX to Windows Defender exclusions
  • Run as administrator and enable compatibility mode
  • Disable Windows Game Bar if conflicts occur
  • Check Windows Update for latest drivers

Steam Input Conflicts

Steam's controller support can interfere with AntiMicroX mappings.

Solutions:

  • Disable Steam Input in Steam Settings → Controller
  • Add games to Steam as non-Steam games and disable per-game input
  • Close Steam completely when using AntiMicroX
  • Use Steam's desktop configuration mode

macOS Issues

Accessibility Permissions

macOS requires explicit permission for input monitoring and accessibility.

Steps to Fix:

  1. Open System Preferences → Security & Privacy
  2. Go to Privacy tab → Accessibility
  3. Click the lock and enter your password
  4. Add AntiMicroX to the allowed applications
  5. Repeat for Input Monitoring if available

Apple Silicon Compatibility

M1/M2 Macs may require additional configuration for optimal performance.

Optimization Tips:

  • Use the native ARM64 version of AntiMicroX
  • Disable Rosetta translation if running x86 version
  • Check for macOS-specific controller drivers
  • Restart after granting permissions

Linux Issues

Permission Problems

Linux requires proper permissions to access input devices.

Terminal Commands:

# Add user to input group
sudo usermod -a -G input $USER

# Set udev rules (create file)
sudo nano /etc/udev/rules.d/99-antimicrox.rules

# Add this line to the file:
SUBSYSTEM=="input", GROUP="input", MODE="0664"

# Reload udev rules
sudo udevadm control --reload-rules
sudo udevadm trigger

# Restart or log out/in

Wayland Compatibility

Wayland desktop environments may have input limitations.

Workarounds:

  • Switch to X11 session temporarily
  • Use Wayland-compatible input methods
  • Check desktop environment specific solutions
  • Install additional Wayland protocols

Advanced Troubleshooting

Log File Analysis

AntiMicroX creates log files that can help identify issues.

Log Locations:

  • Windows: %APPDATA%/antimicrox/
  • macOS: ~/Library/Logs/antimicrox/
  • Linux: ~/.config/antimicrox/

Common Error Patterns:

  • "Device not found" → Driver issues
  • "Permission denied" → Access rights
  • "Timeout" → Connection problems

Performance Optimization

Optimize AntiMicroX for better performance and responsiveness.

CPU Usage Reduction:

  • Lower polling rate (1000Hz → 500Hz)
  • Disable unnecessary features
  • Close other input software

Memory Optimization:

  • Limit active profiles
  • Reduce macro complexity
  • Regular application restart

Still Need Help?

If these solutions don't resolve your issue, our community and support team are here to help.

Discord Support Report Bug Community Forum

When reporting issues, please include:

• Your operating system and version • Controller model • AntiMicroX version • Steps to reproduce