Installation & Setup

Installation & Setup

This guide covers installing CyberLauncher, building from source, and keeping it up to date.

---

System Requirements

Requirement	Minimum
OS	Windows 10 (64-bit) or later
Architecture	x64
Runtime	None (Electron bundles all dependencies)
Disk space	~200 MB
RAM	4 GB

---

Installation Methods

Installer (Recommended)

1. Download the latest installer from Releases
2. Run the .exe installer
3. Follow the setup wizard
4. Launch CyberLauncher

What the Installer Does

• Installs the application
• Creates Start Menu shortcuts
• Creates Desktop shortcut (optional)
• Offers to start with Windows

---

Building from Source

Prerequisites

Tool	Version
Node.js	v18+
npm	Latest

Setup

# Clone the repository
git clone https://github.com/CyberGems/CyberLauncher.git
cd CyberLauncher

# Install dependencies
npm install

# Run in development mode
npm run dev

Build for Production

# Build Electron app with installer
npm run build:electron

The built installer will be in the release/ folder.

Icon Generation

# Generate icons from master files
npm run icons

---

Auto-Start

CyberLauncher can launch automatically when you sign in:

Enable/Disable

• Settings → System → Start with Windows
• Or: Windows Settings → Apps → Startup → Toggle CyberLauncher

---

Auto-Update

How It Works

1. CyberLauncher periodically checks GitHub Releases
2. When an update is available, a notification appears
3. Download and install from the prompt

Manual Update

1. Go to Settings → About → Check for Updates
2. Or: Download the latest installer from releases

---

Data Location

Default Locations

Data	Location
Config	%APPDATA%\CyberLauncher\cyber-launcher-config.json
Indexer settings	%APPDATA%\CyberLauncher\indexer_settings.json
Window state	%APPDATA%\CyberLauncher\window-state.json
Icon cache	%APPDATA%\CyberLauncher\icon-cache\

---

Uninstallation

Standard Uninstall

1. Windows Settings → Apps → Installed Apps
2. Find CyberLauncher → Click Uninstall

What Gets Removed

• Program files
• Start Menu shortcuts
• Auto-start entry

What Is Kept

• Configuration and settings (in %APPDATA%\CyberLauncher)
• Icon cache

⚠️ To remove all data, manually delete %APPDATA%\CyberLauncher after uninstalling.