Skip to content

Troubleshooting

CyberGems edited this page Nov 15, 2026 · 8 revisions

English · Español

Troubleshooting

The development server conflicts on port 1421

The desktop development helper and Vite use 127.0.0.1:1421. Before starting Tauri, the helper checks whether that port already serves a CyberFiles Vite instance: if it does, the helper reuses it, and if another application owns the port, the helper stops with an error instead of reusing an unrelated server. Close the stale or unrelated process on port 1421, 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.

Delete did not ask for confirmation, or asked again after I turned it off

The dialog has a Don't ask again check that remembers both the answer and the mode ticked at the time, so a later Shift+Delete will not bring the dialog back. Open Settings › General › Deletion and switch Ask for confirmation before deleting back on to restore it; the remembered mode stays as it was. Check the same section if deletions are skipping the Recycle Bin when you expected them to go there.

Typing a letter opens the filter instead of jumping to a file

This is the default. Turn off Typing activates the filter in Settings › Navigation to bring back the type-ahead jump, where the first letter selects the first matching name and repeating it cycles through the matches.

A file I opened is not listed in Recents

Recents records files opened or previewed inside CyberFiles, not files opened from Windows, and it keeps the most recent 500 entries. Removing an entry from the list removes it from that log, and clearing the history empties it. The location lists the current contents of the log; it does not read Windows recent-item data.

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