Skip to content
rovr

plugins

there are a couple plugins to improve rovr’s functionality. enable and configure them in your config.toml file.

zoxide

Section titled “zoxide”

zoxide allows you to zip around your filesystem, and can be integrated into rovr

  • enable: plugins.zoxide.enabled = true
  • keybinding: the default keybinding to open the zoxide dialog is z.

bat

Section titled “bat”

to allow for more file previews, bat can be used for its syntax highlighting capabilities.

  • enable: plugins.bat.enabled = true
  • executable: specify the path to the bat executable if it’s not in your system’s PATH.
  • line numbers: toggle line numbers with plugins.bat.show_line_numbers.

fd

Section titled “fd”

uses fd to search recursively in the current directory

  • enable: plugins.fd.enabled = true
  • executable: set the executable used to call fd
  • relative_paths: whether to see paths as relative or absolute
  • follow_symlinks: search inside symlinks as well
  • no_ignore_parent: do not respect ignore files from parent directories (e.g., .gitignore)
  • default_filter_types: set default item filters (like file, directory, etc.)

rg

Section titled “rg”

uses ripgrep to search inside files

  • enable: plugins.rg.enabled = true
  • executable: set the executable used to call rg
  • case_sensitive: whether the search is case sensitive
  • follow_symlinks: search inside symlinks as well
  • no_ignore_parent: do not respect ignore files from parent directories (e.g., .gitignore)
  • search_hidden: whether to search hidden files and directories

poppler

Section titled “poppler”
rovr's poppler integration

uses poppler to preview PDF files

  • enable: plugins.poppler.enabled = true
  • poppler_folder: set the location where the poppler tools are installed (e.g., /usr/bin or C:\Program Files\poppler\bin).
  • pdf_batch_size: number of PDF pages to load in each batch
  • use_pdftocairo: whether to use pdftocairo instead of pdftoppm (may help performance)
  • threads: number of threads to use for processing PDF files (default is 1)

file(1)

Section titled “file(1)”

uses the file command as an alternative to puremagic if it fails to detect a file’s type.

rovr automatically detects file in your PATH, or you can set the YAZI_FILE_ONE or ROVR_FILE_ONE (higher priority) environment variables to specify a custom path.

  • enable: plugins.file_one.enabled = true
  • get_description: whether to get extra file description from file -b <file> (default: true)

a plugin system is also under works, stay tuned!