Installation & Setup

Installation & Setup

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

---

System Requirements

---

Installation Methods

Installer (Recommended)

1. Download the latest installer from Releases
2. Run the .exe installer
3. Follow the setup wizard
4. Choose to set as default image viewer
5. Launch CyberViewer

What the Installer Does

• Installs the application
• Creates Start Menu shortcuts
• Creates Desktop shortcut (optional)
• Registers file associations (JPG, PNG, GIF, WebBP, BMP, TIFF)
• Offers to set as default image viewer
• Bilingual installer (English/Spanish)

Portable

1. Download the portable .exe from releases
2. Run directly — no installation needed
3. Settings stored in application folder

---

Building from Source

Prerequisites

Setup

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

# Install dependencies
npm install

# Run in development mode
npm start

Build for Production

# Build NSIS installer + portable
npm run build

# Build portable only
npm run build:portable

Build Outputs

---

Auto-Start

CyberViewer can launch automatically when you sign in:

Enable/Disable

• Settings → System → Auto-start with Windows
• Or: Windows Settings → Apps → Startup → Toggle CyberViewer

---

Auto-Update

How It Works

1. CyberViewer checks GitHub Releases on startup
2. When an update is available, a notification appears
3. Download with progress indicator
4. Installer launches when complete

Update Settings

Manual Update

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

---

System Tray

Tray Features

• Minimize to tray
• Quick access menu
• Close image on tray hide option

Tray Menu

Right-click the tray icon for:

---

Context Menu Integration

Explorer Context Menu

Right-click images in Explorer:

• Open with CyberViewer — Opens the image directly
• Toggle in Settings → System → Context menu

---

File Associations

Set as Default Viewer

During installation or via Windows Settings:

1. Windows Settings → Default Apps
2. Search for CyberViewer
3. Set as default for image formats

Supported Formats

---

Uninstallation

Standard Uninstall

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

What Gets Removed

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

What Is Kept

• Settings (in %APPDATA%\CyberViewer)

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