rovr 0.2.1

A post-modern terminal file explorer

  ___ ___ _ _ ___
  |  _| . | | |  _|
  |_| |___|\_/|_|  

[!warning] This project is in its very early stages. While this can be daily driven, expect some issues here and there.

• Screenshot
• Installation
• Running from source
• FAQ

Screenshot

Installation

# Test the main branch
uvx git+https://github.com/NSPC911/rovr.git
# Install
## uv (my fav)
uv tool install rovr
## or pipx
pipx install rovr
## or plain old pip
pip install rovr

Running from source

uv run poe run

Running in dev mode to see debug outputs and logs

# Runs it in development mode, allowing a connected console
# to capture the output of its print statements
uv run poe dev
# Runs a separate console to capture print statements
uv run poe log
# capture everything
uv run textual console

For more info on Textual's console, refer to https://textual.textualize.io/guide/devtools/#console

FAQ

1. There isn't X theme/Why isn't Y theme available?

• Textual's currently available themes are limited. However, extra themes can be added via the config file in the format below
• You can take a look at what each color represents in https://textual.textualize.io/guide/design/#base-colors
  Inheriting themes will not be added.

[[custom_theme]]
name = "<str>"
primary = "<hex>"
secondary = "<hex>"
success = "<hex>"
warning = "<hex>"
error = "<hex>"
accent = "<hex>"
foreground = "<hex>"
background = "<hex>"
surface = "<hex>"
panel = "<hex>"
is_dark = "<bool>"
variables = {
  "<key>" = "<value>"
}

2. Why is it considered post-modern?

• Parody to my current editor, helix
  • If NeoVim is considered modern, then Helix is post-modern
  • If superfile is considered modern, then rovr is post-modern

3. What can I contribute?

• Themes, and features can be contributed.
• Refactors will be frowned on, and may take a longer time before merging.

4. I want to add a feature/theme/etc! How do I do so?

• You need uv at minimum. pre-commit and ruff are recommended to be installed.
• Clone the repo, and inside it, run uv sync and pre-commit install.
• Make your changes, ensure that your changes are properly formatted (via the pre-commit hook), before pushing to a custom branch on your fork.
• For more info, check the how to contribute page.

5. How do I make a feature suggestion?

• Open an issue using the feature-request tag, with an estimated difficulty as an optional difficulty level label

6. Why not ratatui or bubbletea??? _{angry noises}

• I like python.