integrations

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

zoxide

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

config.toml

[plugins.zoxide]
enabled = true
show_scores = false  # include the zoxide scores in the results

keys.toml

[main]
"z" = { action = "cd_zoxide", desc = "Jump to a directory" }

bat

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

config.toml

[interface]
show_line_numbers = true
[plugins.bat]
enabled = true
executable = "bat"

fd

uses fd to search recursively in the current directory

config.toml

[plugins.fd]
enabled = true
executable = "fd"
relative_paths = true
follow_symlinks = false   # search inside symlinks as well
no_ignore_parent = false  # ignore .ignore files from parent directories
search_hidden = false
default_filter_types = ["file", "directory"]  # set default item filters (like `file`, `directory`, etc.)
timeout = 15  # set it to a reasonably high amount, searching without indexing takes time
threads = 2   # use multiple threads for faster searching

keys.toml

[main]
"f" = { action = "search_fd", desc = "Search for files" }

rg

uses ripgrep to search inside files

config.toml

[plugins.rg]
enabled = true
executable = "rg"
case_sensitive = true
no_ignore_parent = false  # ignore .ignore files from parent directories
follow_symlinks = false
search_hidden = false
timeout = 60  # set it to a much higher amount, content searching takes time
threads = 4   # use multiple threads for faster searching

keys.toml

[main]
"\" = { action = "search_rg", desc = "Search file contents" }

poppler

uses poppler to preview PDF files

config.toml

[plugins.poppler]
enabled = true
threads = 1
use_pdftocairo = false  # use pdftocairo instead of pdftoppm (may help performance)
poppler_folder = ""     # where the poppler tools are installed (auto detected).
pdf_batch_size = 2

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.

config.toml

[plugins.file_one]
enabled = false
get_description = true  # whether to get extra file description from `file -b <file>` (default: `true`)

resvg

uses the resvg_py module to provide svg image preview support

this cannot be disabled, as it doesn’t depend on the resvg binary, but rather the maturin binding itself.

config.toml

[plugins.resvg]
# refer to https://resvg-py.readthedocs.io/en/latest/api.html
dpi = 0 # svg default
shape_rendering = "geometric_precision"
text_rendering = "geometric_precision"
image_rendering = "optimize_quality"

imagemagick

uses the imagemagick command to provide image preview support for unsupported image formats (like jxl, heic, etc.)

config.toml

[plugins.magick]
enabled = true
executable = "magick"