Skip to content

Repository files navigation

GodotHub Logo

GodotHub

The Ultimate Project Manager for Godot Engine

Manage projects, versions, assets, templates, and Git, all in one place.

Latest Release Platforms Godot 4.x License Stars Winget Available

⬇️ 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

GodotHub Main Window
The Projects view with search, categories, and drag-and-drop sorting


Versions View
🎯 Versions
Browse, download, and manage Godot versions
Templates View
πŸ“¦ Templates
Save and reuse project templates
Asset Store View
πŸ›’ Asset Store
Install assets from old and new asset store directly into projects or templates
Git Integration
πŸ”„ Git Integration
Full Git management inside GodotHub
Settings & Appearance
🎨 Appearance & Settings
Deep customization with themes, accent colors, corner radius, and more
News Feed
πŸ“° News Feed
Stay up to date with Godot community news

πŸ’‘ Screenshots show the dark theme with the default accent color. Every visual is customizable.


Discord

Patreon


πŸ“– 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 βœ…
Chinese βœ…
Russian βœ…

πŸ“„ 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

About

What if Unity Hub and GitHub Desktop had a Baby but its Adopted? Yeah..

Topics

Resources

Code of conduct

Security policy

Stars

817 stars

Watchers

10 watching

Forks

Releases

Sponsor this project

Contributors

Languages