English Β· EspaΓ±ol
- π Introduction
- πΌοΈ Screenshots
- π― Why CyberViewer?
- β¨ Key Features
- β¬οΈ Installation
- π§ Using the App
- π οΈ Tech Stack & Architecture
- β¨οΈ Keyboard Shortcuts
- β€οΈ Donate
- π License
- β FAQ
- π See also
π Related links (outside this README)
- π CyberViewer on the web β overview, download and SmartScreen guide
- π Documentation & FAQ β Wiki β troubleshooting and deep-dives
- πΎ Releases β installers, portable builds and changelog
- π£ CyberGems suite β all open-source apps
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.
Coming soon...
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 |
- 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)
- 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.
- 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.
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.
- 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.
- 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.
- 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)
- 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
- 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 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
- 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
- Download the latest installer or portable build from Releases
- Run the
CyberViewer-Setupinstaller or the portable executable - Launch CyberViewer and press
Alt+Shift+Vto show or hide it from anywhere. No other requirements needed: you do not need Node.js
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":
- Run the
CyberViewer-Setup.exeinstaller. Windows may show the blue "Windows protected your PC" dialog.
- Click the small More info link. The expanded dialog shows your installer:
CyberViewer-Setup.exe.
- 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.
CyberViewer shows or hides from anywhere with Alt+Shift+V; you can also drop a folder or a media file straight onto the window.
- 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. - 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.
- For images,
Bor0fits the window,Arestores the original size, and scrolling zooms around the pointer; for video and audio,Spaceplays or pauses,β/βskip 5 seconds andMmutes.
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.
- Platform: Windows 10 / 11 (x64)
- Framework: Electron 45.3.0 + vanilla JavaScript
- Security:
contextIsolation: true,nodeIntegration: false, customcvlocal://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
Only needed if you want to work on CyberViewer or build it yourself; regular users can skip this section.
- Node.js LTS β https://nodejs.org
- Windows 10/11 (x64)
cd C:\path\to\CyberViewer
npm install
npm startnpm 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.jsonnpm run build # NSIS installer + portable
npm run build:portable # portable only| Artifact | Description |
|---|---|
CyberViewer-Setup-<version>.exe |
NSIS installer |
CyberViewer-Portable-<version>.exe |
Portable build |
- 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)
webSecurityenabled 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: falseandcontextIsolation: true - DevTools IPC disabled in packaged builds
Installed (NSIS) builds use electron-updater against GitHub Releases:
- About β Check for Updates (or menu Help)
- Download update when a newer version is available
- 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.
| 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 |
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! π
Crypto donations (BTC, ETH, USDT, LTC): click to view addresses
β οΈ Send only the selected asset on the indicated network. Using the wrong network will result in permanent loss of funds.
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
For frequently asked questions, troubleshooting guides, and detailed configuration instructions, visit the FAQ or the online documentation.
Made by CyberGems
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. |



