README.md
August 10, 2026 ยท View on GitHub
GodotHub
The Ultimate Project Manager for Godot Engine
Manage projects, versions, assets, templates, and Git, all in one place.
โฌ๏ธ Download Now ย ย ๐ธ Screenshots ย ย ๐ Features ย ย ๐ ๏ธ Installation ย ย โจ๏ธ Shortcuts
Warning
This app has only been tested on Windows, Arch Linux (Hyprland), and the newest macOS version (thanks to a contributor). I can't guarantee how it behaves on other Linux distros, and I don't have a Mac to test on personally. Found a bug? Open an issue, or reach out if you'd like to help with cross-platform testing.
On Linux, AppImage doesn't work for most distros right now. It's an upstream linuxdeploy issue that affects nearly all Tauri apps, so it's not something I can fix on my end. I'll update as soon as a fix lands upstream.
๐ธ Screenshots
The Projects view with search, categories, and drag-and-drop sorting
๐ฏ Versions Browse, download, and manage Godot versions |
๐ฆ Templates Save and reuse project templates |
๐ Asset Store Install assets from old and new asset store directly into projects or templates |
๐ Git Integration Full Git management inside GodotHub |
๐จ Appearance & Settings Deep customization with themes, accent colors, corner radius, and more |
๐ฐ News Feed Stay up to date with Godot community news |
๐ก Screenshots show the dark theme with the default accent color. Every visual is customizable.
๐ Features
๐๏ธ Project Management
Take full control of your Godot projects with a rich, intuitive interface.
See all Project Management features
| Feature | Description |
|---|---|
| Create & Import | Create new projects from scratch or from templates, import existing ones from disk, or clone directly from Git repositories. |
| Drag & Drop Reorder | Rearrange projects with smooth drag-and-drop. Reorder within categories, or move between them. |
| Pin Projects | Pin your most important projects to a dedicated Pinned section at the top. |
| Tags Support | Tags are fetched directly from project.godot, so they stay in sync with your Godot launcher. Edit, add, or delete them and the sync follows. |
| Batch Operations | Select multiple projects at once to change versions, assign categories, toggle pins, or remove from the library. |
| Search & Filter | Search by name or path, filter by category, and sort by custom order, name, date, last opened, or project size. |
| Version Warnings | Visual indicators when a project's bound Godot version is missing or has a major version mismatch. |
| Project Properties | Inspect detailed project info including a file breakdown by type (scripts, scenes, images, audio, 3D models, etc.) with sizes and counts. |
| Custom Launch Args | Add custom command-line arguments when launching projects. |
| Quick Actions | Open project folder, open in external editor, or open a terminal at the project path, all from the project card. |
๐ฏ Godot Version Management
Download, install, and manage any Godot version effortlessly.
See all Version Management features
| Feature | Description |
|---|---|
| Browse Releases | Fetch the full list of official Godot builds directly from GitHub, filtered for your platform. |
| Download & Install | Download with progress tracking, resume support, and concurrent downloading (configurable up to 10 simultaneous). |
| Import Versions | Import existing Godot installations from any folder, or drag-and-drop a .zip archive. |
| Grouped Display | Versions are grouped by major.minor with collapsible sections for easy browsing. |
| Filtering | Filter by build type (Standard / Mono / Both) and channel (Stable / Unstable / Both). |
| Custom Names | Give your installed versions friendly, custom names. |
| Auto-Cleanup | Automatically prunes missing executables from the registry. |
๐ฆ Templates
Save time by reusing project structures.
See all Templates features
| Feature | Description |
|---|---|
| Save as Template | Convert any existing project into a reusable template. |
| Create from Template | Start new projects pre-populated with template content. |
| Preview Contents | Browse the full directory tree of any template before using it. |
| Sync from Directory | Automatically import templates from a configured scan folder. |
| File Watcher | The template directory is watched for changes, so editing a template folder updates the library automatically. |
๐ Git Integration
Full-featured Git management right inside GodotHub.
See all Git Integration features
| Feature | Description |
|---|---|
| Status Overview | See branch name, uncommitted changes, and repo status at a glance. |
| Stage / Unstage | Stage and unstage individual files or all at once. |
| Commit | Write commit messages with optional amend. |
| Push / Pull / Fetch | Sync with remotes. |
| Branch Management | List, switch, create, and delete branches. |
| Stash | Push, list, apply, and drop stashes. |
| Diff Viewer | Inline diff viewer for changed files with syntax-colored additions and deletions. |
| Discard Changes | Discard all uncommitted changes with confirmation. |
| Init & Remote | Initialize a new Git repo, set or remove remotes. |
| Undo | Undo the last commit or undo a pull. |
| Auto-Refresh | Git status is polled every 30 seconds automatically. |
๐งญ Workspaces
Keep your projects organized with multiple workspaces.
See all Workspaces features
| Feature | Description |
|---|---|
| Multiple Workspaces | Create separate workspaces for different projects, clients, or game jams. |
| Custom Icons & Colors | Each workspace gets a unique icon and color for quick visual identification. |
| Quick Switch | Switch between workspaces from the sidebar dropdown. |
๐ท๏ธ Categories
Organize projects with flexible, colorful categories.
See all Categories features
| Feature | Description |
|---|---|
| Create & Customize | Create categories with custom names and colors from a rich palette. |
| Collapsible Sections | Collapse and expand category sections to keep the view clean. |
| Drag Between Categories | Drag projects between categories using @dnd-kit-powered sorting. |
| Filter by Category | Filter the project list by any category. |
| Enable / Disable | Turn categories on or off globally from Settings. |
๐ฐ News Feed
Stay up to date with the Godot community.
See all News Feed features
| Feature | Description |
|---|---|
| RSS Feed | Fetches and displays Godot-related news and updates. |
| Cached | Feed data is cached for performance. |
| Open in Browser | Click any news item to open the full article. |
๐จ Appearance & Customization
Make GodotHub truly yours.
See all Appearance features
| Feature | Description |
|---|---|
| Dark / Light Mode | Switch between dark and light themes. |
| Accent Color | Choose from 18 preset accent colors or pick any custom hex color. |
| Background Color | Customize the background with presets or random generation. |
| "Feeling Lucky" | Randomly generate a unique color scheme in one click. |
| Corner Radius | Adjust from 0 (sharp) to 20px (rounded), applied to every element. |
| UI Density | Scale padding and spacing from 75% (compact) to 125% (spacious). |
| Font Scale | Scale all text from 85% to 130%. |
| Reduce Motion | Minimize animations for accessibility. |
| Sidebar Width | Independently adjust expanded and collapsed sidebar widths. |
โ๏ธ Settings & Preferences
Deep configuration options for every aspect of the app.
See all Settings features
| Feature | Description |
|---|---|
| Storage Locations | Configure scan directories for projects, Godot versions, and templates. |
| Auto-Scan on Startup | Automatically discover new projects and versions when the app starts. |
| File Watchers | Real-time detection of changes in project, version, and template directories. |
| Download Concurrency | Control how many Godot versions download simultaneously (1 to 10). |
| Scan Depth | Configure how deeply to scan folders (1 to 10 levels). |
| Close on Launch | Quit or minimize to tray when launching a project. |
| Reopen After Godot Closes | Automatically restore GodotHub when the editor closes. |
| Tray Menu | Recent projects in the system tray context menu (configurable count). |
| Tooltip Delay | Adjust tooltip hover delay from 100ms to 1000ms. |
| Command Palette Keybind | Rebind Ctrl/Cmd + <key> to your preferred key. |
| Export / Import | Back up or transfer all settings as JSON. |
| Reset & Wipe | Reset settings to defaults or wipe all app data entirely. |
โจ Other Highlights
See more
| Feature | Description |
|---|---|
| Drag & Drop Import | Drag project folders or .zip version archives directly into the app window. |
| Command Palette | Ctrl/Cmd + P (or your custom key) opens a powerful command palette for quick navigation. |
| System Tray | Minimize to tray with a right-click menu showing recently opened projects. |
| Custom Titlebar | A frameless window with a custom title bar for a polished, modern feel. |
| Splash Screen | An animated splash screen greets you on startup. |
| Onboarding Wizard | Guided first-time setup to configure scan folders, categories, and appearance. |
| Auto-Updates | Checks for updates on startup and downloads new versions automatically via the Tauri updater. |
| Bug Reporting | Report issues directly from the app. |
| Changelog Viewer | Track what's new in each GodotHub release. |
| Keyboard Shortcuts | Full shortcut cheatsheet available at any time. |
๐ ๏ธ Installation
Download Prebuilt Binaries
GodotHub is available as a desktop application for:
| Platform | Package Types |
|---|---|
| ๐ช Windows | .msi or .exe installer |
| ๐ macOS | .dmg or .app bundle |
| ๐ง Linux | .deb, .AppImage, or .rpm packages |
โฌ๏ธ Download the latest release
Install via Winget (Windows)
GodotHub is available on the Windows Package Manager (winget). On Windows 10 or 11, install it with a single command:
Note
Winget can lag behind the latest release since maintainers don't always merge the update promptly.
winget install Ryko.GodotHub
To update manually:
winget upgrade Ryko.GodotHub
Build from Source
Prerequisites
| Dependency | Version | Purpose |
|---|---|---|
| Bun | >= 1.0 | JavaScript runtime & package manager |
| Rust | Latest stable | Backend compilation |
| Tauri 2 Prerequisites | n/a | Platform-specific build tools |
# Clone the repository
git clone https://github.com/RykoTheDev/godothub.git
cd godothub
# Install frontend dependencies
bun install
# Run in development mode (with hot-reload)
bun tauri dev
# Build for production
bun tauri build
Tip
You'll find the built app in src-tauri/target/release/bundle/.
โจ๏ธ Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl/Cmd + 1 | Go to Projects |
Ctrl/Cmd + 2 | Go to Versions |
Ctrl/Cmd + 3 | Go to News |
Ctrl/Cmd + 4 | Go to Templates |
Ctrl/Cmd + N | New Project |
Ctrl/Cmd + , | Open Settings |
Ctrl/Cmd + P | Toggle Command Palette |
Escape | Close overlay / Clear selection |
The command palette keybind can be customized in Settings.
๐งฐ Tech Stack
View full tech stack
| Layer | Technology |
|---|---|
| Frontend Framework | React 19 + TypeScript |
| Styling | Tailwind CSS 4 |
| Animations | Framer Motion |
| Drag & Drop | @dnd-kit |
| Desktop Framework | Tauri 2 (Rust) |
| Icons | Font Awesome Free via react-fontawesome |
| HTTP Client | reqwest (Rust) |
| File Watchers | notify (Rust) |
| RSS Parsing | feed-rs (Rust) |
| Build Tool | Vite + Bun |
๐ Project Structure
Click to expand the full directory tree
godothub/
โโโ assets/ # Screenshots & media
โโโ src/ # Frontend (React + TypeScript)
โ โโโ App.tsx # Root application component
โ โโโ main.tsx # Entry point
โ โโโ types.ts # TypeScript type definitions
โ โโโ index.css # Global styles (Tailwind)
โ โโโ components/
โ โ โโโ git/ # Git sidebar, diff viewer, result dialog
โ โ โโโ modals/ # All modal dialogs
โ โ โโโ ui/ # Primitive UI components
โ โ โโโ Icons.tsx # SVG icon components
โ โ โโโ Titlebar.tsx # Custom window title bar
โ โ โโโ SplashScreen.tsx # Startup splash animation
โ โ โโโ OnboardingTips.tsx # First-time user tips
โ โโโ hooks/ # Custom React hooks
โ โโโ lib/ # Utility libraries & API bindings
โ โโโ views/ # Main application views
โ
โโโ WorkspaceSwitcher.tsx # Workspace switching component
โ
โโโ src-tauri/ # Backend (Rust)
โ โโโ src/
โ โ โโโ main.rs # Application entry point
โ โ โโโ lib.rs # Tauri setup, commands, tray menu
โ โ โโโ models.rs # Data models (serde)
โ โ โโโ projects.rs # Project CRUD, launch, icon resolution
โ โ โโโ godot_versions.rs # Version download, install, manage
โ โ โโโ git.rs # Git operations
โ โ โโโ settings.rs # Settings persistence
โ โ โโโ templates.rs # Template management
โ โ โโโ categories.rs # Category CRUD
โ โ โโโ changelog.rs # Changelog CRUD
โ โ โโโ workspace.rs # Workspace management
โ โ โโโ news.rs # RSS news fetching
โ โ โโโ scan.rs # File system scanning
โ โ โโโ watcher.rs # File system watchers
โ โโโ Cargo.toml # Rust dependencies
โ โโโ tauri.conf.json # Tauri configuration
โ
โโโ package.json # Frontend dependencies
โโโ vite.config.ts # Vite configuration
โโโ tsconfig.json # TypeScript configuration
โโโ README.md # This file
Languages
In beta phase (languages other than english might be incomplete)
| Languages | Status |
|---|---|
| English | :white_check_mark: |
| Chinese | :white_check_mark: |
| Russian | :white_check_mark: |
๐ License
This project is licensed under the MIT License. See the LICENSE file for details.
๐ Acknowledgements
| Project | Why We're Grateful |
|---|---|
| Godot Engine | The amazing open-source game engine this tool is built for. |
| Tauri | The framework that makes cross-platform desktop apps with web technologies possible. |
| React | The UI library we use for the frontend. |
| Tailwind CSS | The utility-first CSS framework for styling. |
| Font Awesome | The icon library we use throughout the app. |
And every other open-source library that makes GodotHub possible, see package.json and Cargo.toml for the full list.
Note
AI Notice: Some parts of this codebase have been restructured and small bugs fixed with the assistance of AI. All changes are reviewed and tested before being merged. If you notice anything unusual, feel free to open an issue.
Copilot is not used here. It activated automatically at some point, which is why it shows up in the contributors list. I've disabled it, and it has no authority over this repository, including reviews.
Made with โค๏ธ by RykoTheDev
โฌ๏ธ Download GodotHub ย ยทย ๐ Report a Bug ย ยทย ๐ฌ Discussions