Skip to content

File Operations and Safety

CyberGems edited this page Sep 25, 2026 · 6 revisions

File Operations and Safety

The Windows desktop app performs file operations on the real filesystem. The browser preview is for UI testing and does not use the native Windows file-operation handlers.

Current behavior

Action What it does
Browse a folder Reads the selected filesystem location and displays its entries. Symbolic-link entries are skipped during directory listing.
Copy to the opposite pane or paste Copies selected files and folders to the target directory. Name conflicts receive a distinct name rather than overwriting an existing item.
Move to the opposite pane or paste cut items Moves selected files and folders to the target directory. When a direct move is unavailable, CyberFiles copies the item and removes the source after a successful copy.
Rename or batch rename Renames items on disk. Batch rename can report partial completion if an individual rename fails.
New Folder Creates a directory in the current location.
Copy Path Copies the displayed path text to the clipboard. It does not copy the file.
Delete After confirmation, asks Windows to move supported items to the Recycle Bin.
Empty Recycle Bin After separate confirmation, permanently empties the Windows Recycle Bin. This cannot be undone.

Copy and move reject a destination inside the source folder. Symbolic links and unsupported item types are not followed during copying. If an operation reports partial completion, check the per-item errors before retrying so successful items are not duplicated.

Delete and network locations

CyberFiles currently allows its native Recycle Bin delete operation only for canonicalized, absolute paths on local fixed or removable drives. It rejects UNC paths, mapped network drives, optical media, unsupported drive types, filesystem roots, and symbolic links. Failed paths are reported rather than silently falling back to permanent deletion.

This is an implementation safety boundary, not a general claim that Windows cannot delete network files. A network share can be browsable while CyberFiles still refuses to send a path from it to the Recycle Bin. Use Windows Explorer for network deletion until CyberFiles adds and documents a supported network workflow.

CyberFiles uses the Windows Shell IFileOperation interface with the recycle-on-delete flag for supported deletes. See Microsoft's IFileOperation documentation.

Recycle Bin status and emptying

The status indicator queries Windows Recycle Bin information for local fixed and removable drives. A query error, or having no eligible drives to query, can make the status unavailable. Network shares and optical drives are not included in this displayed total. See Microsoft's SHQueryRecycleBinW documentation.

The Empty Recycle Bin action passes a null drive path to the Windows Shell. Windows defines a null or empty path as emptying the Recycle Bins on all drives. As a result, the emptying scope can be broader than the local-drive-only status total. CyberFiles shows a confirmation first, but the action is permanent and Windows provides no undo for it. See Microsoft's SHEmptyRecycleBinW documentation.

Safe-use guidance

  • Review source and destination paths before starting a copy or move.
  • Check per-item errors when an operation reports partial completion.
  • Review the selected paths in the delete confirmation before proceeding.
  • Do not use Empty Recycle Bin unless you intend to permanently remove its contents across drives.
  • For network paths or unsupported drives, use Windows Explorer.
  • If a delete fails, read the reported per-item error. CyberFiles does not promise to bypass Windows permissions or drive restrictions.

Clone this wiki locally