UE Project Hub

UE Project Hub is an advanced alternative to the Epic Games Launcher, designed specifically for Unreal Engine developers. It focuses on deep metadata management, project task tracking, and efficient .uproject file maintenance.

Key Features

• Deep Project Scanning: Automatically identifies and parses .uproject files across multiple configured paths.
• Full Project Metadata: View and edit project descriptions, engine versions, and custom metadata directly.
• Plugin & Asset Management: Automatically keeps track of enabled plugins and top-level Content folder structure.
• Task Management: Integrated "Roadmap" system to track TODOs, progress, and tasks for each individual project.
• Multi-language Support: Fully localized interface in English and Spanish, configurable in the settings.
• Cyberpunk/Futuristic UI: A high-performance, dark-themed interface built with React and Tailwind CSS.
• Maintenance Tools: Purgers for missing projects, clean scanning, and database reset capabilities.

Authentication & Default User

By default, the application is configured with a master administrator account:

• Username: admin
• Password: admin

Master User Purpose

The admin user has full access to the system, including:

• Project Scanning: Ability to trigger scans and purge the database.
• User Management: Creating, editing, and deleting other team members.
• Global Settings: Modifying engine paths and scanning directories.

Tip

You can change the admin's avatar or password by clicking on the profile section in the bottom-left sidebar after logging in.

Installation & Setup

The project uses a unified runner (run.py) to simplify the operation of both the React frontend and Python backend. For the best experience, we recommend using a Python virtual environment.

1. Initial Python Setup (Recommended)

Before running the installer, create and set up your virtual environment:

# Create the environment
'python -m venv .venv'

# Activate the environment (Windows PowerShell)
'.\.venv\Scripts\activate'

Important

If you get a "SecurityError" or "UnauthorizedAccess" when activating on Windows, run this command once to allow local scripts: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. Full Application Installation

Run the following command to install all necessary Node.js and Python dependencies:

'python run.py --install'

The script will automatically detect your .venv and install the backend requirements inside it.

3. Regular Start

To start both the frontend and backend servers anytime:

'python run.py'

Basic Usage

1. Configure Paths

Go to the Settings tab to add your Unreal Engine project directories to the "Scanning Paths" and your engine executables to the "Installed Engines" list.

2. Scan for Projects

Click the Scan Folders button on the Home/Projects page. The system will recursively find all .uproject files and synchronize their metadata, plugins, and content folder structure to the local database.

3. Manage Projects

• Details: Click on any project card to open the Project Modal.
• Launch: Use the Launch Editor button to open the project with the associated Unreal Engine version.
• Tasks: Use the "Project Roadmap" tab in the modal to manage tasks and track development progress.

4. User Profile

Edit your user profile and role by clicking on your avatar at the bottom of the sidebar.

Technology Stack

• Frontend: React 19, Vite, Tailwind CSS, Lucide-React.
• Backend: Python, FastAPI, SQLAlchemy (SQLite), Uvicorn.
• I18n: Support for English and Spanish transitions.