Installation & Setup

Installation & Setup

This guide covers installing CyberViewer, 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	~150 MB
RAM	2 GB

---

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

Tool	Version
Node.js	LTS (v22 recommended)
npm	Latest

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

Output	Location
NSIS Installer	dist/CyberViewer-Setup-X.X.X.exe
Portable	dist/CyberViewer-Portable-X.X.X.exe
Updater manifest	dist/latest.yml

---

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

Setting	Description
Check updates on startup	Enable/disable update checking

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:

Action	Description
Show/Hide	Toggle viewer window
Open	Open image file
Settings	Open settings
About	Show about dialog
Exit	Close CyberViewer

---

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

Format	Extension
JPEG	.jpg, .jpeg
PNG	.png
GIF	.gif
WebP	.webp
BMP	.bmp
TIFF	.tiff, .tif

---

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.