1.3.1

Fixes compatibility with non-glibc systems. Thanks to @jirutka for the fix.

1.3.0

New options

Option	Short description
-file-browser-resume	Resume from the last opened location.
-file-browser-resume-file	Set the file used to store the last opened location.

1.2.0

This update fixes icons and key bindings with newer versions of rofi.

Removed options

Option	Short description
-file-browser-icon-theme	Set the GTK icon theme.
-file-browser-theme	Same as -file-browser-icon-theme.

New options

Option	Short description
-file-browser-disable-tumbnails	Disable thumbnails for image files.

Key bindings

Default key bindings are now:

Key	Action
kb-accept-alt (default: Shift+Return)	open custom: Open the selected file with a custom command.
kb-custom-1 (default: Alt+1)	open multi: Open the selected file without closing rofi. Can be
kb-custom-2 (default: Alt+2)	Toggle hidden files.

none is now an available key for key bindings to disable the binding, e.g. -file-browser-toggle-hidden-key none.

1.1.0

New Features

Manual page

See man rofi-file-browser after installing.

Config files

The default config file location is $XDG_USER_CONFIG_DIR/rofi/file-browser (defaults to $HOME/config/rofi/file-browser). The config file consists of newline-separated command line options without the "-file-browser-" prefix.

Example:

icon-theme "Numix-Circle"
cmd        "exo-open"
oc-cmd     "evince;icon:evince"
oc-cmd     "gimp;icon:gimp"
depth      2

# use-mode-keys
open-parent-as-self

Stdin mode

Pass paths (either absolute or relative to the starting dir) for rofi to show through stdin, e.g.:

fd | rofi -show file-browser -file-browser-stdin

Command list for open-custom

Specify a list of commands to be shown in open-custom mode.

• All executables in $PATH can be added to this list with -file-browser-oc-search-path.
• User-defined commands can be added with -file-browser-oc-cmd (multiple by passing the option multiple times).
• If no commands are specified, the file to be opened will be shown instead of a list of commands.

User-defined commands can optionally specify an icon and a display name (with pango markup), e.g.:

-file-browser-oc-cmd "gimp"
-file-browser-oc-cmd "pcmanfm-qt;icon:system-file-manager;name:pcmanfm"
-file-browser-oc-cmd "deadbeef --queue;icon:deadbeef;name:deadbeef <span alpha='75%%'>(queue)</span>"

Exclude patters

Files / directories can be excluded by matching filenames (i.e. only the filename, not the relative or absolute path) to glob patterns, e.g.:

-file-browser-exclude workspace
-file-browser-exclude '*.pdf'

New options

Option	Short description
-file-browser-only-dirs	Only show directories.
-file-browser-only-files	Only show files.
-file-browser-follow-symlinks	Self explanatory, only impacts the behaviour if used together with -file-browser-depth.
-file-browser-hide-parent	Hide the parent directory (..).
-file-browser-no-descend	Open directories instead of descending into them.
-file-browser-open-parent-as-self	Treat the parent directory (..) as the current directory when opened.
-file-browser-exclude	Exclude files / directories with glob patterns.
-file-browser-stdin	Read paths from stdin.
-file-browser-oc-cmd	Specify user-defined cmd(s) for open-custom mode.
-file-browser-oc-search-path	Search $PATH for cmds for open-custom mode.
-file-browser-config	Specify config file(s).

Changes

Symlinks are not followed by default

Symlinks are no longer followed by default, which can prevent some trouble when using -file-browser-depth.
-file-browser-follow-symlinks can be used to enable this again. When following symlinks is enabled, every file will still only be reported once.

Mode keys switch the mode by default:

The mode keys no longer hide / show hidden files by default, but actually switch the mode. Accordingly, the option -file-browser-disable-mode-keys is now replaced by -file-browser-use-mode-keys.

Renamed dmenu mode to stdout mode

Since dmenu mode kind of implies stdin mode, dmenu mode was renamed to stdout mode.
Accordingly the command line option was renamed from -file-browser-dmenu to -file-browser-stdout.

Changed sorting options

-file-browser-sort-by-type <0/1> is now split into -file-browser-sort-by-type and -file-browser-no-sort-by-type. The same thing for -file-browser-sort-by-depth.

1.0.2

Reference point for changelog in the next release.