Skip to content
CyberGems edited this page Sep 16, 2026 · 9 revisions

Frequently Asked Questions

Answers to common questions about CyberViewer, its configuration, and everyday use.


General

What is CyberViewer?

CyberViewer is a Windows image viewer for opening files, browsing folders, zooming and panning, making light edits, and presenting images as a slideshow.

Is CyberViewer free?

Yes. CyberViewer is free and open source under the GPLv3 license. See the Donate section if you would like to support the project.

What image formats are supported?

CyberViewer supports JPG, JPEG, PNG, GIF, WebP, BMP, TIFF, TIF, ICO, and AVIF.

Can I use CyberViewer as my default image viewer?

The Windows installer registers CyberViewer for the supported image extensions. Windows may still ask you to choose it under Settings > Apps > Default apps. Portable builds may require manual association.


Viewing

How do I browse a folder of images?

Open an image or folder, then use the thumbnail sidebar, arrow keys, or A and D to navigate. The sidebar can be shown from the action bar or configured to open with the app.

Can I view animated GIFs?

Yes. GIF playback is enabled by default in the viewer and thumbnail sidebar. To freeze GIFs, disable Settings > Interface > Animated GIFs.

How do I zoom?

  • Use the mouse wheel over the viewer.
  • Press + or = to zoom in and - to zoom out.
  • Press F or 0 to fit the image to the window.
  • Press 1 for the calibrated 1:1 view.
  • Use the configured double-click action, which can toggle zoom, fit, show the original view, enter fullscreen, or do nothing.

How do I enter fullscreen?

Press Enter or G, click the fullscreen button, or use the View menu. Press Escape to leave fullscreen when no higher-priority modal or slideshow action is active.

Why is the sidebar empty?

The sidebar is populated after CyberViewer has an image path from a folder. Open a folder or show the sidebar with its edge handle. Thumbnail generation runs in the background and can be paused by hiding the sidebar.


Editing

Can I rotate images?

Yes. Press Q to rotate left or E to rotate right. Rotation is previewed first. Use Save or Enter to commit it to the current file, or Discard and Escape to restore the original orientation.

Can I crop images?

Yes. Open Crop or press C, adjust the frame, and choose Apply. Crop mode starts from the original orientation and defaults to creating a _cropped copy.

Can I resize images?

Yes. Open Resize or press R, enter dimensions or choose a preset, select the resampling algorithm, and apply the result. The default is to create a copy.

Can I adjust colors?

Yes. Open Adjust or press J to change brightness, contrast, saturation, blur, grayscale, and invert. The panel includes a live preview and a momentary A/B comparison. The default is to create a copy.

Are edits destructive?

Crop, resize, and color adjustments default to creating new files. Turning off Apply to a copy explicitly allows those tools to overwrite the source. Rotation remains pending until saved, while flips always create a copy and preserve the original.


Slideshow

How do I start a slideshow?

Press S, click the slideshow button, or choose View > Slideshow > Start. Playback starts immediately and uses the current folder image list.

Can I configure the interval?

Yes. Choose 2, 3, 5, or 10 seconds from the presentation bar or Settings > Slideshow. The selected interval is saved for later sessions.

Can the slideshow loop?

Yes. Loop mode is enabled by default. Disable it from the presentation bar, the View > Slideshow menu, or Settings > Slideshow to pause at the end.

Does the slideshow start in fullscreen?

By default, yes. Disable Fullscreen on start in Settings > Slideshow to keep the presentation in the normal application window.


File Operations

Can I save a copy in another format?

Yes. Use File > Save As or Ctrl+S. The dialog offers PNG, JPEG, and an all-files option.

Can I export an image to PDF?

Yes. Use File > Export PDF or Ctrl+P to open the shared print and export panel. Choose Fit to image, Letter, A4, Legal, or A3, then select orientation and margins when applicable.

Can I print images?

Yes. Use File > Print, the toolbar printer button, or Ctrl+P. The image is sent to the system print dialog with the selected page options.

Can I copy images to the clipboard?

Yes. Ctrl+C copies the current view as PNG data. Ctrl+V loads an image from the clipboard.

How do I delete an image?

Press Delete, click the trash button, or choose Move to trash from the context menu. CyberViewer asks for confirmation before moving a disk-backed file to the Windows Recycle Bin.

Can I set an image as wallpaper?

Yes. Use File > Set as wallpaper and choose Fill, Fit, Center, or Span.


Troubleshooting

Windows shows a SmartScreen warning on install

This can happen with a new unsigned release while Windows builds reputation for the installer. See Installation and Setup for the steps to continue.

Images open slowly

CyberViewer streams local images through its local protocol, but very large files still need time to decode. Folder thumbnails are generated separately in a background queue.

Thumbnails are not loading

Check that the sidebar is visible and the folder contains supported image files. Thumbnail generation is prioritized around the active image. You can clear the cache from Settings > Backup & Data and let it rebuild.

The global hotkey does not work

Open Settings > System and verify the configured shortcut. Another application may already own the accelerator. Select a different combination, or click the field and use Backspace or Delete to clear it.

CyberViewer will not start

For an installed build, try launching it again after closing any stale process and check Windows Event Viewer if the problem persists. When running from source, install dependencies with npm install before using npm start.

File associations are not working

Re-run the installer or choose CyberViewer manually under Windows Settings > Apps > Default apps. For the Explorer right-click entry, enable Settings > System > Context menu.


Contributing

How can I report a bug?

Open an issue on GitHub Issues with the CyberViewer version, Windows version, reproduction steps, and expected versus actual behavior.

How can I contribute code?

Fork the repository, create a focused branch, implement the change, and submit a pull request with a clear description.

How can I help with translations?

UI strings are maintained in i18n/ui.json. Submit a pull request with the corresponding English and Spanish updates when changing user-facing text.

How can I donate?

See the Donate section in the main README.

Clone this wiki locally