Skip to content
Daniel Berger edited this page Oct 30, 2026 · 1 revision

Files

BSDRunner Files is a keyboard-friendly local file browser for everyday navigation and small file operations. Dolphin remains available when a full-featured desktop file manager is preferable.

BSDRunner Files browsing the BSDRunner repository

Open it

Choose Files in the App Launcher or run:

sh ~/.config/bsdrunner/scripts/bsdrunner-files.sh

Left rail: Places, Recent, and Trash

Places provides persistent shortcuts. Right-click a directory or the list background to add a location; custom entries are stored in ~/.config/bsdrunner/files-places. Recent contains locations visited during the current session. Trash opens the user's trash files directory and changes the destructive action from “Move to Trash” to “Permanently Delete.”

Navigation and location controls

The top row contains Back, Forward, Up, Home, and Refresh. Beneath it, the location can be entered directly or traversed through clickable breadcrumbs. The filter narrows the current directory without changing location. New Folder opens a validated name dialog, and Show Hidden toggles dotfiles.

File list

The Name, Size, Type, and Modified headers sort ascending or descending. Column dividers are draggable. Directories open inside the app; files are handed to an appropriate desktop opener. Image files try common image viewers before falling back to Firefox.

Selecting an entry opens the Details drawer with type, size, modification time, permissions, hidden state, and full path. Its action grid offers Open, Rename, Copy Path, Terminal for directories, and Trash or Delete.

Context menus

Right-click an item for Open, Rename, Copy Path, Show Details, and the appropriate destructive action. Directories also offer Add to Places and Open Terminal Here. Right-click the background for New Folder, Add Current to Places, Open Terminal Here, and Refresh.

Keyboard workflow

Shortcut Action
Ctrl+L Focus the path field
Ctrl+F Focus the filter
Ctrl+R Refresh
Ctrl+H Toggle hidden files
Ctrl+N Create a folder
Ctrl+T Open a terminal here
Alt+Left / Alt+Right History back / forward
Backspace Parent directory
Enter Open selection
F2 Rename selection
Delete Move selection to Trash, or permanently delete it while in Trash

Arrow keys, Page Up/Down, Home, and End move the selection. Escape clears an active filter or closes a dialog.

Safety model

Names cannot be empty, ./.., or contain /. Moving to Trash and permanent deletion both require a confirmation dialog; the latter explicitly warns that it cannot be undone. Files with unusual byte sequences are represented safely rather than being interpreted as shell input.

Back to the BSDRunner Apps overview.

Clone this wiki locally