-
-
Notifications
You must be signed in to change notification settings - Fork 33
FAQ Troubleshooting
Answers to common questions, plus what to do when something isn't working.
The AppImage doesn't work on most distros right now. This is an upstream linuxdeploy issue that affects nearly all Tauri apps, so it can't be fixed from this project. Use the .deb or .rpm package instead where possible.
GodotHub is currently tested on Windows, Arch Linux (Hyprland) / Fedora KDE 44, and the newest macOS. Other distros are untested. If you find a problem on yours, please open an issue so it can be fixed or documented.
Winget can lag behind the latest release because the package update isn't always merged right away. Download the newest version from the releases page, or run winget upgrade Ryko.GodotHub to check.
GodotHub checks for updates on startup and in Settings under Advanced. Updates are downloaded and installed automatically, then applied on restart.
Settings → Advanced → Reset Settings. This restores every toggle, slider, and color pick to its defaults. Your scan folders and download locations are kept, and nothing on disk is touched.
Settings → Advanced → Delete App Data. This permanently deletes every workspace, project, category, installed-version record, and setting, then restarts you at first-time setup. Your actual project folders and Godot installs on disk are not touched, unless they live in the default download folder (in which case they're deleted too). This can't be undone.
- Settings: there isn't a single "export all settings" button, but the time-tracking stats can be exported and re-imported from Settings → Storage → Time tracking backup. Re-run the setup wizard on the new machine to reconfigure scan folders and appearance.
- Projects and versions: point GodotHub at your existing folders via the setup wizard or Settings → Storage. GodotHub rescans and re-registers everything.
Use Reset colors to default next to the accent and background pickers, or Reset appearance to default for the whole Appearance section.
GodotHub shows a visual warning when a project's bound Godot version is missing, or has a major version mismatch. Install the version it expects (Versions view), or rebind the project to an installed version from the project card.
Check that its folder is inside one of your scan folders (Settings → Storage), then use Scan Now from the Projects or Versions view. If you enabled file watchers, new additions are picked up automatically within a few seconds of the change. If you're scanning a deep folder tree, increase the scan depth.
Downloads run up to the configured concurrency (Settings → Storage → Simultaneous downloads). Extra downloads wait in a queue and start automatically as slots free up. The list also supports resuming interrupted downloads.
Check your connection and try again. Asset downloads save into the folder you configured, and GodotHub opens it in your file manager so you can find the file.
Sign in from Settings → Integrations. GitHub and GitLab use OAuth device sign-in; other hosts (Codeberg, Gitea, Bitbucket, and so on) use a personal access token that GodotHub stores per host.
GodotHub uses the unauthenticated GitHub API limit of 60 requests per hour when fetching the version list. Add a personal access token in Settings → Integrations → GitHub API Token to raise it to 5,000 per hour. No scopes are needed.
Use Settings → Advanced → Report a Bug to file an issue directly from the app, or open an issue on the GitHub repository. Include your platform, GodotHub version, and what you did when the problem happened.
The new UI is an experimental beta. Some areas are still unstable and may be unresponsive. You can switch back to the classic UI anytime from Settings → Appearance → Interface. If you find a reproducible problem, please report it.
Settings → Display → Command palette key. Click the button, then press any key to rebind. Press Escape to cancel.
No. "Close application on project open" is a setting under Settings → Behavior → Launch. On Windows and Linux it quits GodotHub when a project launches; on macOS it hides the window instead. Turn it off if you'd rather keep GodotHub open.
GodotHub Wiki
- Home · Getting Started · Keyboard Shortcuts · Settings Reference · Custom CSS in the New UI · FAQ / Troubleshooting
Community
GodotHub is not affiliated with the Godot Engine project.