Browsing
Navigation and search
Section titled “Navigation and search”The location bar shows clickable folder breadcrumbs. Double-click a breadcrumb or unused space in the bar to edit the path; Ctrl+L also starts editing. Tab accepts a path completion when one is available. Home and its descendants use Home as the breadcrumb root; you can still navigate above it.
The mouse’s Back and Forward side buttons navigate folder history, like the toolbar arrows or Alt+Left/Alt+Right. Each press navigates once; releasing the button does not navigate again. In split view, pressing a side button over a browsing pane focuses that pane and uses its own history. Over shared chrome, the active pane’s history is used. Side buttons do not navigate behind an open dialog or during a captured drag, and do nothing when the corresponding history is empty.
By default, typing while browsing starts a recursive filename search rooted in the current folder. Settings → General → When typing also offers Filter current folder and Select names. Filtering immediately narrows the live folder listing by a literal, case-insensitive name substring, without looking inside subfolders. For example, temp matches Template1.csv, Template2.csv and Templates in the current folder, but not files inside Templates. Hidden-file and backup-file visibility still apply.
The field next to the location bar shows Search files… for recursive search, or Filter files… in current-folder mode. Clicking it or pressing Ctrl+F uses the same scope. Clear the query or press Escape to return to the folder listing. Select names changes typing to name selection while keeping explicit searches recursive. Content search and an indexing service are not part of the current search.
| Action | Shortcut |
|---|---|
| Back / Forward | Alt+Left / Alt+Right |
| Parent folder / Home | Alt+Up or Backspace / Alt+Home |
| Keyboard shortcuts | F1 |
| Edit location / Focus search | Ctrl+L / Ctrl+F |
| Open terminal in current folder | F4 |
| Refresh | F5 |
| Undo / Redo | Ctrl+Z / Ctrl+Shift+Z |
| Show hidden files | Ctrl+H |
| Show sidebar / Show preview | F9 / F8 |
Open Terminal Here is near the top of the folder background menu. A single folder’s context menu offers Open in Terminal directly, targeting that folder. F4 always uses the active pane’s current folder, regardless of selection; it also works while editing the location/search field, without submitting or clearing its text. Dialogs block the shortcut. Terminal actions require an accessible native folder and use Settings → General → Terminal, then the existing environment/discovery fallback.
Keyboard navigation
Section titled “Keyboard navigation”In List and Columns, Right or Enter enters the folder under the cursor and Left or Backspace goes to its parent. Entering a folder from the keyboard selects its first item; going up selects the folder you left. In a List view folder tree, Left and Right still collapse and expand folders first. Grid keeps Left and Right for moving between items. Backspace edits typeahead or the search query while one is active.
The cursor ring marks the item the keyboard acts on and stays visible inside a multi-selection. Ctrl+arrow keys move it without changing the selection, and Ctrl+Space selects or unselects the item under it. Ctrl+Enter opens the folder under the cursor in a new tab; Ctrl+Shift+Enter reverses the Switch to new folder tabs preference. Escape anywhere outside the file list, such as Places or the toolbar, returns focus to the list. In the search field, Down or Enter moves to the results with the first one selected. F1 lists every shortcut.
Views and selection
Section titled “Views and selection”Undo/redo affects the most recent supported creation, rename or native copy/link/move in the running application, independently of the current folder or selection. When a text input is focused, its text-editing undo takes precedence.
Use the toolbar or main menu to choose Grid (Ctrl+1), List (Ctrl+2) or Columns (Ctrl+3). Ctrl+wheel changes grid icon size. View, zoom, sort and hidden-file choices are saved as defaults for new browsing pages. Existing tabs and panes keep their own browsing state.
List and Columns shorten overflowing filenames in the middle by default, keeping their beginning and ending visible. Settings → Views → Long filenames also offers Shorten at the end. Changes apply to open panes immediately. Grid keeps its two-line name wrapping.
List headers sort by their column. Drag their dividers to resize columns; Settings → List columns controls visibility and order. Additional columns include accessed/created time, owner, group, permissions and location. Missing provider metadata stays unavailable rather than becoming a made-up value. Grid view uses the toolbar’s Sort menu.
In large folders, names can appear while detail values are still loading. “Reading…” means a value is pending; “Unknown” means it was unavailable after querying. Hidden extra columns are not queried by ordinary large-folder browsing. Enabling one loads its visible rows. Sorting by metadata or selecting many items can require facts from the rest of the folder; file actions wait for the facts they need.
The floating status pill reports actions, search and selection. Settings → Appearance → Always show status bar keeps it visible when idle with the item count and, when available, free space.
Click an entry to select it, Ctrl+click to toggle it and Shift+click to select a range. Clicking empty space clears selection. Drag an area over entries to select several. Ctrl+A selects all visible results, Ctrl+Shift+I inverts selection and Ctrl+S selects by pattern. Escape clears the selection when browsing. Opening uses double-click by default; Settings → General offers single-click opening.
Places and folder trees
Section titled “Places and folder trees”Places contains Home, available XDG user folders, Trash and your pinned folders. Pin or unpin a folder through its context menu, or drag a folder into Places. Drag rows to reorder them. Trash can move within the list but cannot be unpinned. Its context menu offers Empty Trash.
Pinned folders use the shared GTK bookmark file, also used by Nemo and Nautilus. Adding, removing, renaming or reordering user bookmarks in Luciole updates that file; changes from another application appear automatically. Built-in Places keep their Luciole layout and are not automatically added to other applications’ bookmarks. Old Luciole-only pins are not imported.
Drives starts with File System (/), followed by the volumes and mounts GIO reports: removable media, extra partitions and network mounts, but not other system mounts such as /home or /boot. Mounted drives come before unmounted ones. In the Places list, each mounted drive shows a bar of its used space under its row; the bar turns red at 90% used. Unmounted drives and filesystems that do not report a size have no bar.
The eject button and the drive’s context menu remove a mounted drive the way GNOME Files does: Safely Remove powers off a USB disk plugged in during the session, Eject ejects removable media, and Unmount unmounts anything else. Removal never forces: while a program still has files open on the drive, nothing is unmounted and the status bar names the programs or Luciole’s running file operations that keep it busy.
Settings → Appearance controls sidebar visibility, width, drive rows and the optional folder tree. The separate expandable-folder preference adds a tree within List view. Both tree options are off by default.
Tabs and split view
Section titled “Tabs and split view”Each tab can contain one or two browsing panes. A split belongs to its tab; it does not create another tab. Navigation, search, selection and scroll belong to each pane. Actions target the focused pane.
The tab bar is shown by default even with one tab. Settings → Appearance → Always show tab bar can hide it when there is only one tab.
Middle-click a folder, breadcrumb or Places row, or use a folder’s Open In → New Tab menu, to open it in another tab. Settings → General → Switch to new folder tabs is on by default. Turn it off to load those folders in background tabs while keeping your current tab, focused pane, search, selection and scroll. Shift+middle-click reverses the preference for that one opening. Click the tab or use Ctrl+Tab to visit it when ready.
Ctrl+T, the plus button and explicit New Tab menu actions always switch to the new tab. Duplicating or reopening a tab also selects it, and New Window retains its normal focus behavior. The folder-tab preference does not change those actions.
| Action | Shortcut |
|---|---|
| New tab / New window | Ctrl+T / Ctrl+N |
| Duplicate tab / Reopen closed tab | Ctrl+Shift+D / Ctrl+Shift+T |
| Close tab / Close focused split pane | Ctrl+W / Ctrl+Alt+W |
| Next / Previous tab | Ctrl+Tab / Ctrl+Shift+Tab |
| Toggle split / Switch pane | F3 / F6 |
Enable Restore tabs from last closed window in Settings → General to reopen the last closed window’s tabs once in a new window or on startup without a requested location. The saved session is consumed when restored.
Miller columns
Section titled “Miller columns”Columns show successive folder levels inside one pane. Selecting one folder reveals its child column. Selecting a different folder replaces the descendant branch. Right or Enter moves into the selected folder’s column with its first item selected; Left, Backspace or Alt+Up moves back to the parent column. Each column scrolls vertically, and horizontal scrolling reveals additional levels. Dividers resize columns.
Show parent folders is enabled by default in Settings → Views. Disable it to start Column view at the current folder alone. Deep navigation remains possible, while the application retains only a bounded set of live columns.
Preview and Properties
Section titled “Preview and Properties”The side preview is on by default. Resize its divider to change the saved width; small windows temporarily collapse it when there is insufficient room. F8 toggles it, and Space opens a quick preview for one selected item. In the quick preview, the arrow keys move the selection as in the view behind it: Left and Right step one item, Up and Down one list item or one grid row. Space or Escape closes it. Images, video stills, the first PDF page and embedded audio artwork depend on installed providers. Video previews are still images, not playback.
The preview shows essential content facts such as file size, dimensions, format and duration when available. Properties (Alt+Return) includes additional technical and permission information. Properties and file-operation dialogs stay open when you switch windows; use their buttons or Escape to close them. See file operations.
File types use the system MIME database and GIO content detection when the name alone is insufficient. For example, a text .bash_history can show as Plain text document with MIME text/plain; an unrecognized binary stays a generic file. The detected type is shared by the list, preview and Properties. Readable local UTF-8 text formats, including YAML and desktop-entry contents, support text previews. Desktop entries also show their localized application or link name and description in preview and Properties.
Background operations
Section titled “Background operations”The toolbar’s File Operations button shows the number of active jobs. Open it, or use File operations in the main menu, for progress and recent results across the running application’s tabs and windows. See file operations for cancellation, reports and retry behavior.