KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

GodotHub

★ 843 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">GodotHub</h1>
<h3 align="center">The Ultimate Project Manager for Godot Engine</h3>

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

<a href="https://github.com/RykoTheDev/godothub/releases/latest"><kbd>⬇️ Download Now</kbd></a>
 &nbsp;&nbsp;
 <a href="#-screenshots"><kbd>📸 Screenshots</kbd></a>
 &nbsp;&nbsp;
 <a href="#-features"><kbd>📖 Features</kbd></a>
 &nbsp;&nbsp;
 <a href="#-installation"><kbd>🛠️ Installation</kbd></a>
 &nbsp;&nbsp;
 <a href="#️-keyboard-shortcuts"><kbd>⌨️ Shortcuts</kbd></a>
 &nbsp;&nbsp;
 <a href="https://github.com/RykoTheDev/godothub/wiki"><kbd>📚 Wiki</kbd></a>

> [!WARNING]
> This app has only been tested on **Windows**, **Arch Linux (Hyprland) / Fedora 44**, 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](https://github.com/RykoTheDev/godothub/issues), 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

<img src="assets/hero-screenshot.png" alt="GodotHub Main Window" width="820">
 
 The Projects view with search, categories, and drag-and-drop sorting

<table>
 <tr>
 <td width="50%" align="center">
 <img src="assets/versions-view.png" alt="Versions View" width="400">
 🎯 Versions
 Browse, download, and manage Godot versions
 </td>
 <td width="50%" align="center">
 <img src="assets/templates-view.png" alt="Templates View" width="400">
 📦 Templates
 Save and reuse project templates
 </td>
 </tr>
 <tr>
 <td width="50%" align="center">
 <img src="assets/asset-store-view.png" alt="Asset Store View" width="400">
 🛒 Asset Store
 Install assets from old and new asset store directly into projects or templates
 </td>
 <td width="50%" align="center">
 <img src="assets/git-view.png" alt="Git Integration" width="400">
 🔄 Git Integration
 Full Git management inside GodotHub
 </td>
 </tr>
 <tr>
 <td width="50%" align="center">
 <img src="assets/settings-appearance-view.png" alt="Settings & Appearance" width="400">
 🎨 Appearance & Settings
 Deep customization with themes, accent colors, corner radius, and more
 </td>
 <td width="50%" align="center">
 <img src="assets/news-view.png" alt="News Feed" width="400">
 📰 News Feed
 Stay up to date with Godot community news
 </td>
 </tr>
</table>

💡 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.

<details>
<summary>See all Project Management features</summary>

| 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. |

</details>

### 🎯 Godot Version Management

Download, install, and manage any Godot version effortlessly.

<details>
<summary>See all Version Management features</summary>

| 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. |

</details>

### 📦 Templates

Save time by reusing project structures.

<details>
<summary>See all Templates features</summary>

| 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. |

</details>

### 🔄 Git Integration

Full-featured Git management right inside GodotHub.

<details>
<summary>See all Git Integration features</summary>

| 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. |

</details>

### 🧭 Workspaces

Keep your projects organized with multiple workspaces.

<details>
<summary>See all Workspaces features</summary>

| 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. |

</details>

### 🏷️ Categories

Organize projects with flexible, colorful categories.

<details>
<summary>See all Categories features</summary>

| 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. |

</details>

### 📰 News Feed

Stay up to date with the Godot community.

<details>
<summary>See all News Feed features</summary>

| 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. |

</details>

### 🎨 Appearance & Customization

Make GodotHub truly yours.

<details>
<summary>See all Appearance features</summary>

| 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. |

</details>

### ⚙️ Settings & Preferences

Deep configuration options for every aspect of the app.

<details>
<summary>See all Settings features</summary>

| 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. |

</details>

### ✨ Other Highlights

| 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. |

</details>

---

## 🤖 AI Disclosure

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. Whole Code is written by a freshly baked Human from scratch.

Copilot is **not** used here. I Accidentally had it fix the PR where it literally only removed a Space and now its in Collaborators list 😭. I've disabled it, and it has no authority over this repository, including reviews.

---

## 🛠️ 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 |

<a href="https://github.com/RykoTheDev/godothub/releases/latest">⬇️ Download the latest release</a>

### 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.

```powershell
winget install Ryko.GodotHub
```

To update manually:

```powershell
winget upgrade Ryko.GodotHub
```

### Build from Source

<details>
<summary>Prerequisites</summary>

| Dependency | Version | Purpose |
|---|---|---|
| [Bun](https://bun.sh) | >= 1.0 | JavaScript runtime & package manager |
| [Rust](https://rustup.rs) | Latest stable | Backend compilation |
| [Tauri 2 Prerequisites](https://v2.tauri.app/start/prerequisites/) | n/a | Platform-specific build tools |

</details>

```bash
# 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.

---

## 📚 Wiki

The [project wiki](https://github.com/RykoTheDev/godothub/wiki) covers GodotHub in more depth than this README, split into a few pages:

| Page | What it covers |
|---|---|
| [Getting Started](https://github.com/RykoTheDev/godothub/wiki/Getting-Started) | Installation, the first-run setup wizard, and what to do after |
| [Keyboard Shortcuts](https://github.com/RykoTheDev/godothub/wiki/Keyboard-Shortcuts) | Every global shortcut, plus how lists, menus, and forms behave on the keyboard |
| [Settings Reference](https://github.com/RykoTheDev/godothub/wiki/Settings-Reference) | What every setting does, grouped by category |
| [Custom CSS in the New UI](https://github.com/RykoTheDev/godothub/wiki/Custom-CSS-in-the-New-UI) | Restyle the new interface with your own CSS |
| [FAQ / Troubleshooting](https://github.com/RykoTheDev/godothub/wiki/FAQ-Troubleshooting) | Answers to common questions and fixes for common problems |

---

## 🧰 Tech Stack

<details>
<summary>View full tech stack</summary>

| Layer | Technology |
|---|---|
| **Frontend Framework** | [React 19](https://react.dev) + [TypeScript](https://www.typescriptlang.org/) |
| **Styling** | [Tailwind CSS 4](https://tailwindcss.com) |
| **Animations** | [Framer Motion](https://www.framer.com/motion/) |
| **Drag & Drop** | [@dnd-kit](https://dndkit.com/) |
| **Desktop Framework** | [Tauri 2](https://v2.tauri.app/) (Rust) |
| **Icons** | [Font Awesome Free](https://fontawesome.com) via [react-fontawesome](https://github.com/FortAwesome/react-fontawesome) |
| **HTTP Client** | [reqwest](https://docs.rs/reqwest/) (Rust) |
| **File Watchers** | [notify](https://docs.rs/notify/) (Rust) |
| **RSS Parsing** | [feed-rs](https://docs.rs/feed-rs/) (Rust) |
| **Build Tool** | [Vite](https://vitejs.dev) + [Bun](https://bun.sh) |

</details>

---

## 📁 Project Structure

<details>
<summary>Click to expand the full directory tree</summary>

```
godothub/
├── assets/                         # Screenshots & media
├── src/                            # Frontend (React + TypeScript)
│   ├── main.tsx                    # Entry point
│   ├── types.ts                    # TypeScript type definitions
│   ├── index.css                   # Global styles (Tailwind)
│   ├── api/                        # Tauri command bindings
│   ├── hooks/                      # Custom React hooks & contexts
│   ├── lib/                        # Utility libraries & shared helpers
│   ├── i18n/                       # Localization (en-US, zh-CN)
│   ├── interface/                  # All UI code (classic + new)
│   │   ├── classic/                # The original (classic) UI
│   │   │   ├── App.tsx             # Classic app shell + root component
│   │   │   ├── WorkspaceSwitcher.tsx
│   │   │   ├── components/
│   │   │   │   ├── cards/          # Card components (ProjectCard)
│   │   │   │   ├── git/            # Git sidebar, diff viewer, result dialog
│   │   │   │   ├── modals/         # All modal dialogs
│   │   │   │   ├── reusables/      # App-level reuse (Tooltip, Toasts, SplashScreen…)
│   │   │   │   ├── titlebar/       # Titlebar, TaskTray
│   │   │   │   ├── ui/             # Primitive UI components
│   │   │   │   └── …               # AssetLibraryBrowser, AssetStoreBrowser, Sidebar, etc.
│   │   │   ├── lib/                # Classic-only helpers (Icons, workspaceIcons)
│   │   │   └── views/              # Main application views
│   │   └── new/                    # Experimental New UI (isolated, beta)
│   │       ├── App.tsx             # New UI shell (self-contained)
│   │       ├── index.ts            # Public exports
│   │       ├── style.css           # New UI design tokens (scoped)
│   │       ├── components/
│   │       │   ├── cards/          # Card components (ProjectCard, InstalledVersionCard)
│   │       │   ├── git/            # Git sidebar, diff viewer, result dialog
│   │       │   ├── modals/         # Modal dialogs
│   │       │   ├── reusables/      # App-level reuse (Tooltip, ScanButton, ViewHeader)
│   │       │   ├── titlebar/       # Titlebar, TaskTray, RunningProjectsChip
│   │       │   ├── ui/             # Form controls & primitives (Checkbox, Dropdown, Slider…)
│   │       │   └── …               # DirList, OverlayScrollArea, Sidebar, etc.
│   │       ├── hooks/              # New-UI-only React hooks
│   │       ├── lib/                # New-UI helpers (duration, icons)
│   │       └── views/              # Main application views
│   └── …
├── 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
│   │   ├── godotenv.rs             # Godot version detection & pinning (.godotrc, global.json)
│   │   ├── 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
│   │   ├── asset_library.rs        # Asset library fetching
│   │   ├── time_stats.rs           # Project time tracking
│   │   ├── tray.rs                 # System tray menu
│   │   └── …                       # error, git_helpers, persist, terminal, etc.
│   ├── 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
```

</details>

---

## 🌍 Languages
In beta phase (languages other than english might be incomplete)

| Languages | Status          |
| ------- | ------------------ |
| English   | Completed |
| Chinese   | Beta               |
| Russian   | Incomplete               |
| Arabic    | Incomplete               |

---

## 📄 License

This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.

---

## 🙏 Acknowledgements

| Project | Why We're Grateful |
|---|---|
| [Godot Engine](https://godotengine.org) | The amazing open-source game engine this tool is built for. |
| [Tauri](https://v2.tauri.app) | The framework that makes cross-platform desktop apps with web technologies possible. |
| [React](https://react.dev) | The UI library we use for the frontend. |
| [Tailwind CSS](https://tailwindcss.com) | The utility-first CSS framework for styling. |
| [Font Awesome](https://fontawesome.com) | 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.

---

## ⭐ Star History

---

Made with ❤️ by <a href="https://github.com/RykoTheDev">RykoTheDev</a>

<a href="https://github.com/RykoTheDev/godothub/releases/latest">⬇️ Download GodotHub</a>
 &nbsp;·&nbsp;
 <a href="https://github.com/RykoTheDev/godothub/issues">🐛 Report a Bug</a>
 &nbsp;·&nbsp;
 <a href="https://github.com/RykoTheDev/godothub/discussions">💬 Discussions</a>
 &nbsp;·&nbsp;
 <a href="https://github.com/RykoTheDev/godothub/wiki">📚 Wiki</a>

GodotHub

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README