Skip to content

A app that allows you to directly download/install games from UC

License

Notifications You must be signed in to change notification settings

Union-Crax/UnionCrax.Direct

Repository files navigation

UnionCrax.Direct

main

A fast, standalone Electron desktop application for managing and launching games from the UnionCrax platform. Direct downloads with minimal overhead and full control over your gaming library.

Version License Platform

Features

  • Fast Downloads: Direct game downloads with pause/resume support
  • Game Library: Browse and manage your installed games
  • Updates: Quick check button opens Releases page
  • Settings: Customize download location and launch executables
  • Search: Quick game search with intelligent filtering
  • History: Track your recently played games
  • Lightweight: Minimal resource usage compared to web browser

System Requirements

  • OS: Windows 10 or later (64-bit)
  • RAM: 2GB minimum (4GB recommended)
  • Storage: 500MB for app, plus space for game downloads

Installation

Windows Installation Options

Option 1: NSIS Installer (Recommended)

  1. Go to Releases
  2. Download UnionCrax.Direct Setup X.X.X.exe
  3. Run the installer and choose installation directory
  4. Create desktop/Start Menu shortcuts
  5. Launch UnionCrax.Direct from Start Menu or desktop

Features: Auto-uninstaller, Start Menu integration, customizable install location

Option 2: Portable Executable

  1. Go to Releases
  2. Download UnionCrax.Direct X.X.X.exe
  3. Run directly - no installation needed
  4. Settings and data are stored alongside the executable

Features: No installation, run from USB drives, easily movable

Option 3: ZIP Archive

  1. Go to Releases
  2. Download UnionCrax.Direct-X.X.X-win.zip
  3. Extract to your preferred location
  4. Run UnionCrax.Direct.exe from the extracted folder

Features: Full control over installation location, easy manual updates

Linux Installation

Run the one-line installer (downloads the latest AppImage and creates a desktop entry):

curl -sSL https://union-crax.xyz/linux-installer.sh | bash

This installs the AppImage to ~/.local/share/UnionCrax.Direct and adds a launcher in your applications menu.

Usage

Downloading Games

  1. Browse the game library
  2. Click Download
  3. Wait for download to complete
  4. Extraction begins automatically

Launching Games

  1. Go to Library
  2. Click the Play button on an installed game
  3. Choose the game executable if prompted
  4. Game launches directly

Managing Downloads

  1. Go to Activity
  2. View active, completed, and failed downloads
  3. Pause/resume/cancel downloads as needed (currenlty the host rootz does not support download resume)

Settings

  1. Click Settings (gear icon)
  2. Change download location
  3. View storage usage
  4. Check for updates

Updates

UnionCrax.Direct lets you check for updates and opens the latest Releases page in your browser to download the newest installer.

Manual check: Settings → Check for Updates (opens Releases page)

Configuration

Custom Download Location

Use SettingsDownload Location in the app to choose where games are installed.

Uninstall

Windows

To uninstall UnionCrax.Direct from Windows:

  1. Open SettingsAppsInstalled apps (or Control PanelPrograms and Features)
  2. Search for UnionCrax.Direct
  3. Click Uninstall and follow the prompts
  4. The application and shortcuts will be completely removed

Alternatively, if you installed the portable or ZIP version, simply delete the executable or folder.

Linux

To uninstall UnionCrax.Direct from Linux:

  1. Run the installer again:
    curl -sSL https://union-crax.xyz/linux-installer.sh | bash
  2. Select Uninstall when prompted
  3. The application and desktop entry will be completely removed

Troubleshooting

Linux: App icon not showing

If the app icon doesn't appear correctly on desktop shortcuts or in the application itself:

  1. Reinstall the application to update the desktop entry and cache:
    curl -sSL https://union-crax.xyz/linux-installer.sh | bash
  2. Select Reinstall when prompted
  3. Restart your desktop environment or log out and log back in
  4. The icon should now display correctly

App won't start

  • Verify Windows 10+ (64-bit)
  • Reinstall the latest version
  • Check Windows Defender isn't blocking it

Downloads fail

Game won't launch

  • Ensure all files are fully extracted
  • Try setting the executable manually in game details
  • Check game-specific requirements

Still having issues?

Development

Want to contribute? See CONTRIBUTING.md for setup instructions and development guidelines.

Quick Start (Developers)

# Clone repository
git clone https://github.com/Union-Crax/UnionCrax.Direct.git
cd UnionCrax.Direct

# Install dependencies
pnpm install
pnpm run setup

# Start development
pnpm dev

# Build installer
pnpm run pack

For detailed development information, see CONTRIBUTING.md.

Architecture

Technology Stack

  • Frontend: React 18 + TypeScript + Vite
  • Desktop: Electron 33 + Node.js
  • Styling: Tailwind CSS v4
  • Build: electron-builder (NSIS installer for Windows)
  • Updates: Manual via GitHub Releases

How It Works

  1. Main Process: Electron handles file operations, downloads, and game launching
  2. Renderer Process: React UI communicates with main process via IPC
  3. Backend: API calls to UnionCrax for game metadata and download links
  4. Updates: Opens GitHub Releases for new versions

Project Structure

UnionCrax.Direct/
├── electron/          # Main Electron process
├── renderer/          # React UI (Vite)
│   ├── src/
│   │   ├── app/      # Pages and routes
│   │   ├── components/ # UI components
│   │   ├── lib/      # Utilities and helpers
│   │   └── context/  # React context
│   └── public/       # Static assets
├── scripts/          # Build and dev scripts
├── .github/workflows/# GitHub Actions CI/CD
└── assets/          # App icon

Releases

How Releases Work

  • Tag a commit: git tag vX.X.X
  • GitHub Actions automatically builds the installer
  • Release appears on GitHub Releases
  • Users can click Check for Updates in the app to open the Releases page

Version Scheme

We use Semantic Versioning:

  • MAJOR.MINOR.PATCH (e.g., 1.2.3)
  • Major: Breaking changes
  • Minor: New features (backward compatible)
  • Patch: Bug fixes

Security

For security vulnerabilities, please see SECURITY.md.

Security Highlights

  • No hardcoded secrets or API keys
  • HTTPS-only API communication
  • Installer downloads verified via GitHub Releases
  • No telemetry or tracking

License

This project is licensed under the MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for:

  • Development setup
  • Code style guidelines
  • Pull request process
  • Reporting issues

Support

Acknowledgments

Built with:


image image image image

Made with ❤️ by the UnionCrax Team

About

A app that allows you to directly download/install games from UC

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •