• English

      • Troubleshooting

      This page lists some of the common issues users encounter when using GlobalQuake.

      "Java not found" error

      • Windows: GlobalQuake for Windows bundles its own Java runtime. If you are seeing this error, the installation may be corrupted. Try reinstalling the application.
      • macOS/Linux: Run which java in your terminal to verify Java is installed and correctly added to your system PATH.

      GlobalQuake won't start

      • Verify Java version: java -version should show 17 or higher (macOS/Linux).
      • Check that you have at least 1024 MB of free RAM.
      • Try resetting your configuration by deleting the GlobalQuake data folder and restarting:
        • Windows: Delete the %APPDATA%\GlobalQuake folder.
        • macOS/Linux: Delete the configuration data folder located directly inside the directory where you extracted the GlobalQuake .zip file.

      Stations not appearing or not synchronizing

      • Synchronize your system time - This is the most common cause. Use NTP to ensure accurate system time:
        • Windows: Settings → Time & language → Date & time → Turn on "Set time automatically"
        • macOS: System Preferences → Date & Time → Set date and time automatically
        • Linux: Run timedatectl set-ntp on or configure NTP manually
      • Verify internet connection is active
      • Check firewall settings - GlobalQuake needs access to port 38000
      • Restart the application

      No earthquake data displays

      • Verify internet connection is active
      • Check firewall settings - GlobalQuake needs access to port 38000 (custom data protocol)
      • Ensure system time is synchronized (see above)
      • Restart the application

      Custom sound does not work

      The converted WAV configuration might not be supported, please make sure the format is as follows:

      • PCM_SIGNED 16 bit, little-endian
      • 44100 Hz
      • Stereo/Mono

      Sample FFmpeg command to convert to the conforming standard above:

      ffmpeg -f s16le -ar 44100 -ac 2 -i input.m4a output.wav

      Getting Help

      If you encounter issues not covered above:

      1. Review application logs in:
        • Windows: %APPDATA%\GlobalQuake\logs\
        • macOS/Linux: The data/logs/ directory located inside the folder where you extracted GlobalQuake.
      2. Ask on Discord in the #gq-help-and-support channel
      3. Report issues to [email protected]

      This will allow us to better understand the issues you are facing and potentially fix undiscovered bugs.