File Browser

The native interface includes a built-in file browser for quick filesystem navigation using keyboard shortcuts.

Note

The file browser is only available in native mode. It is not available when using Fuzzel mode.

Overview

Navigate your filesystem directly from the launcher with fuzzy filtering, hidden file support, and keyboard-driven actions.

Activation

Start the file browser by typing one of these prefixes:

• Type / to browse from the root filesystem
• Type ~ to browse from your home directory

Examples

/                  # Browse root directory
~                  # Browse home directory
/home/user/        # Browse specific directory
~/Documents/       # Browse Documents folder

Navigation

Directory Structure

• Directories are listed first in accent color
• Files are listed after directories
• Current path shows in the input field

Keyboard Shortcuts

Key	Action
Enter	Navigate into directory OR open file with xdg-open
Alt+Enter	Copy file/directory path to clipboard
Tab	Autocomplete selected entry into search bar
Ctrl+H	Toggle hidden file visibility
Esc	Exit file browser
↑/↓	Navigate through results

Fuzzy Filtering

Text after the last / fuzzy-filters the current directory listing:

Basic Filter

/home/us
# Filters /home/ by "us"
# Matches: user, username, usr, etc.

Deep Filter

~/Documents/proj
# Filters ~/Documents/ by "proj"
# Matches: projects, my-project, old_projects, etc.

Extension Filter

~/Downloads/.pdf
# Filters ~/Downloads/ by ".pdf"
# Shows all PDF files

Hidden Files

Control visibility of hidden files (dotfiles):

Toggle at Runtime

Press Ctrl+H to toggle hidden file visibility while browsing

Default Hidden

addons:
  file_browser:
    enabled: true
    show_hidden: false

Default Visible

addons:
  file_browser:
    enabled: true
    show_hidden: true

Note

Hidden files start with a dot (.), like .bashrc, .config, etc.

Actions

Open File

1. Navigate to file
2. Press Enter
3. File opens with xdg-open (system default application)

~/Documents/report.pdf
[Enter] → Opens PDF in default viewer

Navigate Directory

1. Navigate to directory
2. Press Enter
3. Directory contents are displayed

~/Documents/
[Enter] → Shows contents of Documents/

Copy Path

1. Navigate to file or directory
2. Press Alt+Enter
3. Full path copied to clipboard

~/Documents/report.pdf
[Alt+Enter] → Copies: /home/user/Documents/report.pdf

Autocomplete

1. Navigate to file or directory
2. Press Tab
3. Entry is autocompleted into search bar

Current: /home/us
Selected: user/
[Tab] → Input becomes: /home/user/

Configuration

Configure the file browser in raffi.yaml:

addons:
  file_browser:
    enabled: true
    show_hidden: false

Configuration Options

enabled boolean (default: true)

Enable or disable the file browser addon

show_hidden boolean (default: false)

Show hidden files (dotfiles) by default. Can be toggled at runtime with Ctrl+H.

Disable File Browser

addons:
  file_browser:
    enabled: false

Use Cases

Quick File Access

latest-report.pdf

~/Downloads/
# Type: latest
# [Enter] to open

Copy File Paths

main.rs

~/Projects/myapp/src/
# [Alt+Enter] to copy path
# Paste into terminal or IDE

Browse Config Files

~/.config/
# [Ctrl+H] to show hidden files
# Navigate to: .bashrc, .vimrc, etc.
# [Enter] to edit

Project Navigation

~/Projects/
# Filter: myapp
# [Enter] to navigate
# Filter: src
# [Tab] to autocomplete

Visual Indicators

• Directories — Listed first in accent color
• Files — Listed after directories in normal text

Requirements

Caution

The file browser requires xdg-open to open files (standard on most Linux distributions)

Note

Clipboard operations require wl-copy (wl-clipboard) for Wayland

Examples

Navigate to Documents

1. Type Prefix

   Type ~ to start browsing home directory

2. Filter

   Type Doc to filter for Documents

3. Navigate

   Press Enter on Documents folder

4. Browse Files

   See all files in ~/Documents/

Open Configuration File

1. Go to Config

   Type ~/.config/

2. Show Hidden

   Press Ctrl+H if needed

3. Filter

   Type filename to filter (e.g., raf for raffi)

4. Open

   Press Enter to open with default editor

Copy Script Path

1. Navigate

   Type ~/bin/ or /usr/local/bin/

2. Find Script

   Filter by name (e.g., my-script)

3. Copy Path

   Press Alt+Enter to copy full path

4. Use Path

   Paste into terminal, config, or documentation

Tips

Tip

Directories are always listed first and highlighted in the accent color, making it easy to distinguish them from files.

Tip

Use fuzzy filtering after the last / to quickly find files: /home/user/doc matches /home/user/Documents/

Tip

Toggle hidden files with Ctrl+H without leaving the file browser.