Skip to content

File Operations and Safety

CyberGems edited this page Nov 19, 2026 · 6 revisions

English · Español

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.
Drag and drop (internal and Windows) Copies or moves items within CyberFiles, accepts drops from the Desktop or Windows File Explorer into valid targets, and hands off drags past the window edge to native Windows OLE drag-and-drop for Desktop, Explorer, or external apps.
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.
Preview archive Lists entries in supported ZIP and RAR archives. Password-protected archives may require a password.
Extract archive Extracts a supported ZIP or RAR archive here or into a folder named after it.
Create ZIP Creates a ZIP archive from selected items or the current folder. Password-protected ZIP creation is not currently available.
Copy Path Copies the path of the selection, or of the current folder when nothing is selected, to the clipboard. It does not copy the file.
Delete Moves supported items to the Recycle Bin, or deletes them permanently when the permanent option is ticked in the dialog.
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.

Queue, activity, and undo

Copy, move, extraction, and ZIP creation requests are added to the integrated File Operations activity center. Operations run through a queue; the active operation can be paused, resumed, or canceled, and queued work can be removed. The activity center shows progress and recent results. Use its floating activity button to reopen it when collapsed. Password-protected extractions remain visible there until a password is supplied or the operation is canceled.

The toolbar undo history keeps up to ten recent actions, and the same list is reachable from the pane context menu. Only operations with a safe inverse can be undone; an unsupported or partially completed action may be unavailable. Permanent deletion and emptying the Recycle Bin cannot be undone.

A recycle delete is recorded as undoable as soon as Windows reports where each item landed, so the entry does not wait for the Recycle Bin to be read. Restoring resolves the recorded item directly instead of scanning the bin, which keeps undo immediate even when the bin holds tens of thousands of entries.

System drag-and-drop rules

  • Inbound defaults and modifiers: dropping files from Windows into CyberFiles follows Explorer rules. Dropping onto the same drive or the same UNC network share moves by default; dropping across different drives, across different UNC shares, or into portable device (MTP) storage copies by default. Hold Ctrl while dragging to force copy or Shift to force move.
  • Inbound safety guards: drops are blocked over modal dialogs, virtual locations (This PC, Recycle Bin, Recents, Network), UNC server roots, offline drives, portable device roots (mtp:\<Device>), inside a dragged folder itself, or when moving items into the folder they already live in.
  • Outbound handoff to Windows: dragging items past the outer window edge invokes native Windows OLE (DoDragDrop) with Shell drag previews. Local and UNC paths permit Copy, Move, and Link, and CyberFiles refreshes the source pane afterward. Portable MTP items permit Copy only: files up to 25 MiB in total are staged in a local temporary cache so any Windows app (browsers, chat apps, editors) can receive them directly, while larger files or MTP folders use the Windows Shell WPD path for direct copy into Windows File Explorer or the Desktop. Dropping staged cache files back into CyberFiles always copies rather than moves.

Delete confirmation

The delete dialog can be turned off in two ways: tick Don't ask again inside the dialog, which also remembers whether the permanent option was selected, or switch off Ask for confirmation before deleting in Settings › General › Deletion. Both paths meet in the same Settings section, which restores the dialog without losing the remembered mode. Shift+Delete opens the dialog with permanent deletion already ticked, but a remembered answer still wins, because choosing not to be asked promised that exact mode.

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.

Portable devices (MTP/PTP)

Portable devices accessed via mtp:\ do not have a Windows Recycle Bin. Deleting items on a portable device always prompts for permanent deletion and cannot be undone, even if you previously chose Don't ask again for Recycle Bin deletions.

You must open a storage root inside the device (such as Internal storage or an SD card) before creating items or transferring files. Writing directly into a device root (mtp:\<Device>) and renaming or deleting device or storage roots are intentionally blocked.

Actions that require a standard Windows filesystem path are disabled on portable devices: Flat view, creating or extracting ZIP or RAR archives directly on the device, creating .lnk shortcuts, opening a Windows terminal in the folder, and Explorer folder-handler exceptions. Operations that create or copy items onto a portable device are not added to the Recycle Bin undo history.

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.
  • Remember that deleting items on a portable device (MTP/PTP) is always permanent and skips the Recycle Bin.
  • Check the File Operations activity center for queued work, active progress, passwords, and per-item errors.
  • 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