Skip to content

About

πŸ’« CyberViewer is a full-featured image viewer and editor with integrated video and audio player β‹… Free and open-source.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

2 watching

Forks

Latest commit

Β 

History

654 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

English Β· EspaΓ±ol

Images, video and audio, all in one viewer

Download Latest ReleaseWindows 10/11 (64-bit) Β All Releases

LicenseΒ  PlatformΒ  ElectronΒ  WikiΒ  Changelog


Images, video and audio in one fast window β€” and the fixes you need without leaving it


πŸ“‘ Table of Contents

πŸ”— Related links (outside this README)

πŸ‘‹ Introduction

Open a photo, a video or an audio track and it appears in the same window, at full size, in seconds. Images stay sharp at any zoom and can be cropped, rotated, resized, flipped or color-corrected on the spot; video plays in media tabs beside them, with speed control, repeat and frame previews on the progress bar; audio shares the same player, shortcuts and position restore. Tabs, favorites and recent files keep your work within reach, and any folder can become a fullscreen slideshow; turn on Restore previous session and the whole workspace reopens after a restart. When an image is ready, copy it, print it, export it to PDF or set it as your wallpaper β€” no full editor required. Your settings and favorites are backed up on a schedule to the folder you pick, so a reinstall doesn't cost you your setup. Built with Electron 45 and vanilla JavaScript.

Free and open source (GPLv3). CyberViewer adds no advertising or analytics. Optional YouTube playback connects to YouTube and uses its official player.

  • Privacy: see PRIVACY.md. CyberViewer does not send your data anywhere by itself. The only automatic connections are listed there, and none of them carries personal data.

πŸ–ΌοΈ Screenshots

Coming soon...


🎯 Why CyberViewer?

Most image viewers are either bloated with features you never use or so barebones they feel like an afterthought. CyberViewer strikes the perfect balance: instant loading, smooth browsing, and essential editing tools, all wrapped in a sleek, distraction-free interface.

Need Solution
Open images instantly Streaming cvlocal:// protocol with no full RAM load, even for large files
Browse a whole folder Thumbnail sidebar with lazy loading and radar scan progress
Quick edits without Photoshop Rotate, crop, resize, flip, adjust brightness/contrast/saturation/blur
Immersive viewing Fullscreen mode with auto-hiding UI, slideshow with loop
Set the desktop wallpaper Fill, Fit, Center, or Span the current image across Windows
Stay in your workflow System tray, recent images, auto-start, global hotkey, Explorer context menu
Bilingual (EN / ES) Complete UI localization with instant language switching

✨ Key Features

πŸ–ΌοΈ Viewing

  • Image tabs: open multiple files together, reorder tabs, search by name or path, and reopen closed tabs. Each tab keeps its zoom, pan, and pending rotation. Folder navigation stays in the current tab; use the thumbnail context menu or middle-click to open another tab. A tab with unsaved changes stays open when navigating to another image.
  • Tab strip extras: double-click the empty strip to open files, right-click it for a context menu with reopen-closed-tab and close-all, use the edge arrows while the tabs overflow, and open the switcher for a searchable list with a close-all footer.
  • Media tabs: optional type icons distinguish images, video, audio, and YouTube. In Configuration β†’ Interface, you can hide them. Configuration β†’ General β†’ Remember playback state between tabs is on by default, so media resumes or stays paused when you return.
  • Drag and drop: the center of the viewer opens dropped files in new tabs by default, or can replace the current tab. Dropping on the tab strip always opens files at the release position.
  • Optional session restore: enable Configuration β†’ General β†’ Restore previous session to recover tab order, the active image, views, pending rotations, and pasted images after restarting. Missing files stay in their tabs and can be located again. Session data stays local and separate from settings backups; disabling the option removes the saved session.
  • Lightning-fast open: custom streaming protocol loads images without hogging RAM
  • Supported formats: JPG, JPEG, PNG, GIF, WebP, BMP, TIFF, TIF, ICO, and AVIF
  • Folder browsing: thumbnail sidebar with lazy loading, priority queue, and scan progress indicator
  • Zoom and pan: 5% to 2000%, fit-to-window, original size (1:1), mouse wheel, and drag
  • Animated GIF support: toggle playback on or off
  • Fullscreen immersive mode: ghost UI auto-hides for distraction-free viewing
  • Drag and drop: drop images or folders directly onto the window
  • Clipboard paste: paste images from the clipboard (Ctrl+V)

▢️ Video playback

  • Open MP4, M4V, WebM, MOV, and MKV through the file picker, drag and drop, folder navigation, or tabs. Support depends on the video and audio codecs inside each file and the computer's decoder capabilities.
  • Play/pause, seek, adjust volume, mute, and loop. Videos play automatically on open by default; turn Autoplay on open off in the … menu for manual playback. The preference is saved. Press Space to play/pause, Left/Right to skip 5 seconds, or M to mute. Up/Down still navigates between files.
  • YouTube-style touches: click the video to pause or resume and double-click it for fullscreen; use the previous/next buttons to jump between videos in the folder; open the speed panel (0.25×–3Γ—) from the … menu or cycle it with > / <; and hover the seek bar for a timestamp with a frame preview. Loop, volume, mute, and speed persist between sessions.
  • Compact controls sit over the video and hide during playback after inactivity. The … menu provides loop, properties, open, and audio information. Image editing bars are hidden while viewing video.
  • Use the fullscreen button or Ctrl+F for native fullscreen with the complete frame fitted to the screen. Only the video remains after the controls and cursor hide; moving the pointer or pressing a key reveals the controls. Esc returns to the window (or closes the playback menu first).
  • One active player keeps inactive tabs lightweight. Playback position survives tab changes and, when session restore is enabled, restarts.
  • Video thumbnails are static frames. Image editing, image copying, wallpaper, and print/export actions are disabled for videos. Slideshows continue to show images and skip videos.
  • Unsupported video codecs show an error. Silent videos play without automatic audio notices; volume and mute are dimmed and disabled when playback yields no decodable audio, and recover if audio becomes available later. Audio information is available on request in the playback menu. HEVC and multichannel audio are not universally supported; there is no bundled transcoder or external player dependency.

Audio playback and visualizations

  • Open MP3, PCM WAV, FLAC, Ogg Vorbis/Opus (.ogg, .oga, .opus), and AAC (.aac ADTS, .m4a MP4) directly, without conversion or an additional playback engine. Unusual codecs or profiles inside these containers may not be supported.
  • Audio shares the video playback controls, shortcuts, volume, loop, speed and optional session position restoration. Previous/next stays within audio files and opens the neighboring track in the same tab; enable "Open previous/next in a new tab" in the player menu to keep one tab per track.
  • Choose Spectrum, Oscilloscope, Radial, Particles, Aurora, Tunnel, Terrain, Helix, Matrix, Fireworks or Effects off from the playback menu. The selected style is remembered. Each style has its own composition and an accent-based color palette, and they all react to the track's bass, highs and overall energy. Visuals ease in when playback starts and settle smoothly when paused or finished, then stop drawing. They run at up to 30 fps on a canvas capped at 1440 Γ— 810 pixels and stop immediately while hidden. Reduced-motion preferences keep them static. Playing audio continues when hidden to the tray.

Codec compatibility

These are the container and codec combinations exercised by CyberViewer's local playback smoke tests. They are a practical reference, not a guarantee that every file using the same extension or codec profile will decode.

Media Container / extension Combination covered by playback tests
Video MP4, M4V, MOV, MKV H.264/AVC video with AAC-LC audio; tested from MP4 and remuxed into the other containers
Video WebM VP9 video with Opus audio
Audio MP3 MPEG-1 Layer III, 128 kb/s
Audio WAV 16-bit PCM, 44.1 kHz, mono
Audio FLAC 16-bit FLAC, 16 kHz
Audio OGG, OGA, OPUS Ogg Vorbis at 16 kHz; Ogg Opus, mono voice encoding
Audio AAC, M4A AAC-LC in ADTS (.aac) and MP4 (.m4a)

Playback can still vary with codec profile, bitrate, sample rate, channel layout, and the decoders available to the Electron/Windows build. HEVC and multichannel audio are not universally supported; CyberViewer does not transcode media.

YouTube videos and playlists

  • Choose Open YouTube link in the main menu or press Ctrl+L. Paste a video, Shorts, live stream, or public playlist link. Links containing a video and a playlist retain that context; timestamps and playlist indexes are supported.
  • The official YouTube player provides playback, volume, captions, quality, and its playlist selector. CyberViewer adds previous/next, playlist repeat, retry, opening the current video in YouTube, and native fullscreen (Ctrl+F, Esc to exit). Its footer stays outside the video and disappears in fullscreen.
  • Autoplay on open in the link dialog shares the saved local-video preference. YouTube can still require a click on its own Play button. One online player is active at a time; changing tabs or suspending the application releases it. Optional session restore retains the current item and playback position.
  • Internet access and permission to embed are required. Private, age-restricted, removed, region-blocked, and embedding-disabled items may be unavailable. Errors offer retry or opening in YouTube. This phase uses the embedded playlist directly, without a separate searchable playlist catalog, account sign-in, or downloads.
  • YouTube controls its stream, recommendations, advertising, and data processing under its own policies. Remote content runs in a separate sandbox without access to CyberViewer's file or settings APIs.

Media properties

  • Open Properties for an image, local video, audio track, YouTube video, or playlist to inspect its source and media details. Local video previews use a frame from the file; YouTube previews use the video's thumbnail when available.
  • YouTube playlist properties show the current position and total count when available. Copy actions provide the source path or link and a concise properties summary.

✏️ Editing

  • Rotate: left 90Β° (Q) or right 90Β° (E) with save/discard workflow
  • Crop: interactive overlay with handles and optional create-copy mode
  • Resize: width and height controls with aspect lock, presets (720p, 1080p, 25%, 50%, 200%), and quality resampling
  • Adjust: brightness, contrast, saturation, blur, grayscale, and invert with live A/B preview
  • Flip: horizontal (H) or vertical (Shift+H)

🎬 Slideshow

  • Start, pause, and stop controls with a dedicated HUD
  • Configurable interval: 2s, 3s, 5s, or 10s
  • Loop mode for the current folder
  • Option to enter fullscreen on start

πŸ“ File Operations

  • Save (overwrite) or Save As
  • Copy the image to the clipboard (Ctrl+C) or copy its file path
  • Move to trash (Delete)
  • Show in folder or open the containing folder
  • Export to PDF and Print with page size, orientation, and margin controls
  • Set as wallpaper with Fill, Fit, Center, or Span styles, even directly from pasted or dropped images
  • Favorites with dedicated add, remove, and view actions
  • Recent history with up to 10 files and 10 folders

βš™οΈ System Integration

  • System tray: suite-standard popup menu anchored to the tray icon with show/hide, open file, recent files with thumbnails, help links, and other CyberGems suite apps (optional, also hidden from About via Configuration); minimize/close-to-tray behavior and a first-close dialog that asks whether to stay in the tray or quit
  • Auto-start with Windows: launch minimized on sign-in
  • Global hotkey: configurable show/hide shortcut, default Alt+Shift+V
  • Explorer context menu: right-click supported images to open them in CyberViewer
  • File associations: set CyberViewer as the default viewer for JPG, PNG, GIF, WebP, BMP, TIFF, ICO, or AVIF, with separate image, video and audio default-app checkboxes in the installer (MP4, M4V, WebM, MOV, MKV, MP3, WAV, FLAC, OGG, OGA, OPUS, AAC, M4A). The System tab shows the current viewer per format and links to the Windows settings.
  • Single resident instance: Explorer opens and additional launches send images to tabs in the existing window
  • Auto-update: built-in GitHub Releases updater with silent install
  • Settings backup: export or import configuration and favorites as JSON
  • Scheduled automatic backups: save settings and favorites on a schedule (on startup, hourly, daily, weekly, or monthly; daily by default), keep a chosen number of backups with automatic pruning, and pick a custom folder. Restore any backup from Configuration β†’ Backup & Data: restoring saves a safety backup of the current state first, and Backup Now triggers a run on demand

🎨 Customization

  • Themes: CyberViewer (dark with accent), Gray (refined grayscale, no colour), and Light (light with accent)
  • Accent colors: Cyan, Pink, Green, Orange, Violet, Blue, Red, and Mint
  • Background styles: Auto (follows the theme), Checker-dark, Checker-light, or Solid
  • Interface tweaks: sidebar, toolbar, status bar, tooltips, shortcut guide, auto-hide delays, and double-click behavior
  • Tabbed settings: General, Appearance, Interface, Slideshow, System, and Backup & Data

⬇️ Installation

Install (Recommended)

  1. Download the latest installer or portable build from Releases
  2. Run the CyberViewer-Setup installer or the portable executable
  3. Launch CyberViewer and press Alt+Shift+V to show or hide it from anywhere. No other requirements needed: you do not need Node.js

πŸ›‘οΈ Windows SmartScreen

Windows may show a SmartScreen warning the first time you run the CyberViewer installer: this is an unsigned hobby app, so Windows hasn't built reputation for the file yet. This is expected; the source is public so you can inspect exactly what it does. The same can appear when launching the portable build.

To continue:

See how to run the installer (step by step)

Windows shows this warning for any installer without a paid code-signing certificate; it does not mean the file is unsafe. Do not click "Don't run":

  1. Run the CyberViewer-Setup.exe installer. Windows may show the blue "Windows protected your PC" dialog.

Windows SmartScreen warning

  1. Click the small More info link. The expanded dialog shows your installer: CyberViewer-Setup.exe.

SmartScreen dialog after More info

  1. Click Run anyway. The installer starts normally.

You can verify the file independently: compare the SHA with the GitHub release, scan it on VirusTotal, or build from source. More details: SmartScreen guide on the website.


🧭 Using the App

CyberViewer shows or hides from anywhere with Alt+Shift+V; you can also drop a folder or a media file straight onto the window.

  1. Drag a folder onto CyberViewer, or open files with Ctrl+O: images, local video (MP4, MKV, WebM…) and audio (MP3, FLAC, Ogg…) open in tabs inside the same window.
  2. Move through files with the arrow keys or click thumbnails in the sidebar; the tab bar marks what is an image, a video, audio or YouTube.
  3. For images, B or 0 fits the window, A restores the original size, and scrolling zooms around the pointer; for video and audio, Space plays or pauses, ← / β†’ skip 5 seconds and M mutes.

Paste a YouTube video, Short, live stream or playlist into Open YouTube link (Ctrl+L) and watch it without leaving the app β€” it needs internet and a video that allows embedding. While music plays, pick one of its visualizations from the playback menu. Press Enter for fullscreen and Esc to leave it. Closing the window can leave CyberViewer running in the tray; a first-close dialog asks whether to stay or quit.

See How Do You Use CyberViewer? for everyday examples and the full guides.


πŸ› οΈ Tech Stack & Architecture

  • Platform: Windows 10 / 11 (x64)
  • Framework: Electron 45.3.0 + vanilla JavaScript
  • Security: contextIsolation: true, nodeIntegration: false, custom cvlocal:// protocol with path allowlist, CSP headers
  • UI: Custom frameless window, DWM-rounded corners, multi-monitor DPI-aware
CyberViewer/
β”œβ”€β”€ main.js              Electron main process: IPC, tray, protocol, and window management
β”œβ”€β”€ preload.js           contextBridge β†’ window.electronAPI (secure IPC)
β”œβ”€β”€ tray-preload.js      Tray menu preload
β”œβ”€β”€ CyberViewer.html     Shell markup (all UI modals/menus)
β”œβ”€β”€ tray-menu.html       Custom tray popup
β”œβ”€β”€ css/app.css          Styles
β”œβ”€β”€ js/
β”‚   β”œβ”€β”€ app.js           Renderer UI logic
β”‚   └── media-helpers.js Pure helpers (mediaUrl, canvasExport, filters)
β”œβ”€β”€ lib/                 Shared Node helpers
β”‚   β”œβ”€β”€ paths.js         Path normalization, allowlist, MIME types
β”‚   β”œβ”€β”€ thumb-cache.js   Thumbnail caching/eviction
β”‚   β”œβ”€β”€ window-bounds.js Window bounds clamping/DPI awareness
β”‚   β”œβ”€β”€ updater.js       electron-updater integration
β”‚   β”œβ”€β”€ session-store.js Tab session persistence for restore
β”‚   β”œβ”€β”€ youtube-player.js Isolated YouTube playback state
β”‚   β”œβ”€β”€ auto-backup.js   Scheduled backups with pruning and restore
β”‚   └── settings-backup.js Import/export settings
β”œβ”€β”€ i18n/
β”‚   β”œβ”€β”€ menu.json        Menu, tray, and dialog strings (EN/ES)
β”‚   β”œβ”€β”€ ui.json          Renderer UI strings (source of truth)
β”‚   └── ui.js            Generated loader (npm run i18n:sync)
β”œβ”€β”€ assets/              Icons
└── test/                Node unit tests

Building from Source (Developers)

Only needed if you want to work on CyberViewer or build it yourself; regular users can skip this section.

Prerequisites

Development

cd C:\path\to\CyberViewer
npm install
npm start

Checks and localization

npm test
npm run lint
npm run test:workspace # isolated image/tab regression tests
npm run test:video     # isolated video tests; requires FFmpeg on PATH (development only)
npm run test:youtube   # live YouTube/playlist tests with an isolated profile; requires internet
npm run i18n:sync       # regenerate i18n/ui.js from i18n/ui.json

Build (Production)

npm run build            # NSIS installer + portable
npm run build:portable   # portable only

Outputs (in dist/)

Artifact Description
CyberViewer-Setup-<version>.exe NSIS installer
CyberViewer-Portable-<version>.exe Portable build

NSIS Installer Features

  • Optional "Set CyberViewer as default image viewer" (checked by default)
  • Per-user (HKCU) file associations
  • Desktop/Start Menu shortcuts
  • Bilingual installer (en_US, es_ES)

πŸ”’ Security

  • webSecurity enabled with Content-Security-Policy
  • Local images served through cvlocal:// protocol (streamed) with path allowlist
  • Allowlist expansion only accepts existing supported image or video files
  • Folder scans only run for neighbors of an existing supported media file
  • Media streams support byte ranges for seeking without reading a complete video into RAM
  • Renderer runs with nodeIntegration: false and contextIsolation: true
  • DevTools IPC disabled in packaged builds

πŸ”„ Updates

Installed (NSIS) builds use electron-updater against GitHub Releases:

  1. About β†’ Check for Updates (or menu Help)
  2. Download update when a newer version is available
  3. Install & restart: silent install, no wizard, and automatic relaunch

Download/install is always user-requested. With "Check for updates on startup" enabled (default), the app notifies on startup that an update exists (toast + About banner), but will not download until you ask.

Portable builds cannot self-update in-app; use Open releases page.


⌨️ Keyboard Shortcuts

Key Action
Ctrl+O Open images, videos or audio
Ctrl+L Open a YouTube video or playlist link
Ctrl+Tab / Ctrl+Shift+Tab Next / previous tab
Ctrl+W Close tab
Ctrl+Shift+T Reopen closed tab
W Open containing folder
Ctrl+Shift+F Open folder
Ctrl+S Save As
Ctrl+P Print / Export PDF
Ctrl+C Copy image to clipboard
Ctrl+V Paste image from clipboard
F Toggle favorite
Ctrl+, Open settings
P Properties
← ↑ / Backspace Previous file; in video, ← seeks 5 seconds
β†’ ↓ Next file; in video, β†’ seeks 5 seconds
Space Next image, play/pause video, or play/pause slideshow
M Mute/unmute video
Q / E Rotate left / right 90Β°
C Crop
R Resize
J Adjust (color/tone)
H / Shift+H Flip horizontal / vertical
B Fit to window
A View at actual size (1:1)
Enter / G Toggle fullscreen
S Start/pause slideshow
Delete Move to trash
+ / - Zoom in / out
0 Fit to window
Esc Close overlays/modals/cancel crop

❀️ Donate

CyberViewer is 100% free and open source. If it helps you, please consider donating or starring the repo on GitHub to support continued development. Read the full story behind the project. Thank you! πŸ™

Donate via PayPal

Support me on Ko-fi

Buy Me a Coffee

Crypto donations (BTC, ETH, USDT, LTC): click to view addresses
Asset Address QR
BTC
bc1q5mxzz05nmvsheqzx7970euswta3fksxzcfzag4
BTC QR
ETH
0x79b703Ec0f77493679Fcd280aF3b983E20c580B8
ETH QR
USDT (ERC20 / BEP20)
0x79b703Ec0f77493679Fcd280aF3b983E20c580B8
USDT QR
USDT (TRC20)
TSVbSk1HSyZ1NprCnAYiw56ECwXgH887mD
USDT TRC20 QR
LTC
LWGnEHgcFCE2BRkzLnsdPDD8Y8ZeDK577X
LTC QR

⚠️ Send only the selected asset on the indicated network. Using the wrong network will result in permanent loss of funds.


πŸ“„ License

CyberViewer is distributed under the terms of the GNU General Public License v3.0. See LICENSE for the full license text.

Copyright (C) 2026 CyberGems


❓ FAQ

For frequently asked questions, troubleshooting guides, and detailed configuration instructions, visit the FAQ or the online documentation.


Thanks for using CyberViewer! πŸŽ‰

Made by CyberGems

Share on Reddit Β Share on X Β Share on Facebook Β Share by Email Β Share on Telegram Β Share on LinkedIn


πŸ”— See also

More free, open-source, privacy-first apps from CyberGems:

App Description
πŸ•Β CyberClock Desktop clock with analog & digital display, calendar, timer, stopwatch and relaxation module.
πŸ“’Β CyberFeeds High-performance, local-first RSS and Atom reader built for speed, privacy and clean reading.
πŸš€Β CyberLauncher Windows application launcher with hot corners, scheduler, system monitor and integrated terminal.
πŸ’»Β CyberManager Lightweight, high-performance task manager, virtualized and NT-native, a powerful Task Manager alternative.
πŸ“Β CyberNotes Privacy-focused note-taking app with rich text, folders, tabs and bcrypt-protected local storage.
⚑ CyberPaste Privacy-first clipboard manager for text, code, images, HTML and files.
πŸ“ΈΒ CyberSnap Screen capture and annotation suite with vector tools, high-speed OCR, screen recording and color picker.
⭐ CyberTray High-performance tray launcher with hotspots, system monitoring, process manager and PIN-protected file vault.
πŸ›‘οΈΒ CyberWall User-friendly Windows firewall with real-time per-app rules powered by the WFP kernel engine.

➑️ Browse all apps at cybergems.org

About

πŸ’« CyberViewer is a full-featured image viewer and editor with integrated video and audio player β‹… Free and open-source.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Contributors

Languages