installation

requirements

• a patched font that supports nerd font icons
  if you don’t have any supported fonts, get one from nerdfonts.com for the best experience.
  if you prefer to not use a nerd font, you will need to disable the nerd font in the config
• a python package installer
  you are recommended to use uv, as it handles everything for you, like installing the python version, a lot faster than what pipx, or pip would take
• an editor with lsp support for toml
  only necessary if you want an autocomplete box while configuring rovr.

Installation scripts

Linux/macOS With curl:

curl -fsSL https://nspc911.github.io/rovr/install.sh | bash

With wget:

wget -qO- https://nspc911.github.io/rovr/install.sh | bash

Windows

Invoke-Expression (Invoke-WebRequest https://nspc911.github.io/rovr/install.ps1)

uv (test run)

uvx rovr

uv (install)

uv tool install --compile-bytecode rovr --python 3.13t

Note

I highly recommend installing with --compile-bytecode, as startup times will be slower (albeit by not that much) if not cached.

I also recommend installing with --python 3.13t (the free threaded build) because proper concurrency is supported aside from spawning new Processes (which tanks system resources)

pipx (install)

pipx install rovr

Arch Linux (install)

Python version

yay -S rovr

Compiled version

yay -S rovr-bin

Pixi (install)

pixi global install rovr

Homebrew (install)

Proceed with precaution, I don’t own this tap!

brew tap chenrui333/homebrew-tap
brew install rovr

if successful, you can run

rovr --version

to see the current version installed

the commit hash may not exist, depends on how the package was built, but the version should be correct.

you can then start the installation by just invoking

rovr

If you dont see something like this

you can force the install helper by running

rovr --force-first-launch

you can make the changes you want (optionally, hover over certain options to see a tooltip explaining what it does)

once done, you can press the big green button at the end, take a final glance at your config, before it writes it down.

You finally installed rovr!