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)
- Download the latest installer from Releases
- Run the
.exeinstaller - Follow the setup wizard
- 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
- CyberLauncher periodically checks GitHub Releases
- When an update is available, a notification appears
- Download and install from the prompt
Manual Update
- Go to Settings → About → Check for Updates
- 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
- Windows Settings → Apps → Installed Apps
- 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%\CyberLauncherafter uninstalling.