Skip to content

Troubleshooting

CyberGems edited this page Oct 2, 2026 · 8 revisions

Troubleshooting

The development server conflicts on port 3001

The desktop development helper and Vite use 127.0.0.1:3001. If this port is already occupied, the helper treats the existing listener as the CyberFiles frontend and reuses it. Close the stale or unrelated process on port 3001, then restart CyberFiles with npm run dev:desktop.

A folder or drive cannot be opened in the browser preview

The browser preview is only for UI testing. It cannot enumerate the computer like This PC in the desktop app. Folder selection depends on browser support for the File System Access API, a secure context, a user gesture, and browser permission. Use the Windows desktop app to test native drive and Shell behavior.

Flat view is disabled or incomplete

Flat view is available in the desktop app when the current folder has visible subfolders. It respects hidden-item visibility. If some nested locations cannot be read, CyberFiles displays a warning and marks the list as incomplete.

Delete is unavailable on a network share or mapped drive

This is an intentional current restriction. Native Recycle Bin deletion accepts only supported local fixed or removable drives. UNC paths and mapped network drives are rejected. See File Operations and Safety.

A file operation fails or reports partial completion

CyberFiles reports per-item failures for copy, move, and batch rename. Check the reported paths and reason, then retry only the items that did not complete. Symbolic links and unsupported item types are not copied. A folder cannot be copied or moved inside itself. See File Operations and Safety.

The Recycle Bin status is unavailable or looks different from the emptying result

The status indicator queries supported local fixed and removable drives, and may show unavailable if those queries fail or no eligible drives are present. Empty Recycle Bin uses the Windows Shell's all-drives behavior. Its scope can therefore exceed the displayed status total.

A protected archive will not open or extract

Check the password and try again. CyberFiles supports password prompts for ZIP and RAR preview and extraction. ZIP creation currently does not create encrypted archives.

The global shortcut does not register

The shortcut is available only in the desktop app. Another application may already own the chosen key combination. Choose a different combination in Settings, or disable the shortcut.

The build command did not create an installer

npm run build:desktop creates only a debug executable. Use npm run build:installer for the distributable NSIS package, and confirm the Tauri Windows prerequisites and NSIS are installed. Public builds are available on the GitHub Releases page.

Clone this wiki locally