rovr 0.0.4

A post-modern terminal file explorer

rovr

[!caution] This project is in its very early stages. Feedback is appreciated, but this cannot be daily-driven yet.

• What and Why?
• Installation
• Screenshots
• FAQ
• Road map
  • Version 1
  • Version 2

What and Why?

• What:
  • It is a file manager made using the Textual framework.
• Why:
  • Because I can :3
  • I'm using this as a learning opportunity to learn more about Textual, and designing a neat little app for myself.

Installation

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

Screenshots

Startup

Create new Item

Delete selected items

Zoxide integration

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. Why did you say it cannot be daily driven?

• Refer to the road map. There is many features yet to be completed. Pull Requests are appreciated

4. What can I contribute?

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

5. 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.

6. How do I make a feature suggestion?

• Open an issue using the feature-request tag. Issue templates will come soon.

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

• I like python.

8. When will it be completed?

• When it is completed.

Road map

This is a list of features that I plan to add before releasing the appropriate version and where they are inspired from.

Version 1

Status: 26/29

• Directory Auto-completion (explorer)
• Button Navigation (explorer)
• Keyboard Navigation
  • Directory Navigation (explorer)
  • Others (superfile)
• Double Click to enter into directories (explorer)
• Configuration (superfile)
  • Base
  • Schema
  • Extending custom themes via configuration
• zoxide support (ranger)
  _{There is no command line for rovr, which means it will use keybinds to launch either a modified current folder bar or a panel}
• Previewing files
  • Image files using textual-image (superfile)
    _{Explorer kinda supports image viewing, but this is a TUI, so inspiration is from superfile}
  • Directories (superfile)
  • Compressed Files
• Pinned folder sidebar (superfile)
  _{Explorer also supports a pinned sidebar, but it also includes the massive file tree, which I won't add.}
• Search Bar (superfile)
• Metadata
• Clipboard (superfile)
  • Copy files and folders
  • Cut files and folders
  • Paste files and folders
    • Warn when overwriting same named files
• Multiple File Lists
  • Tabs
• Active and Completed processes (superfile)
• Actions bar (explorer)
  • Change sort order of files
  • Copy files
  • Cut files
  • Paste files
  • Create new files/folders
  • Delete files/folders
  • Rename a file/folder
• bat as previewer

Version 2

• Plugins using pytest-dev/pluggy or a custom way (I wish not)
• Cross process clipboard sync (two rovr instances should have synced clipboards)
• Recycle Bin of 1-day when files get overwritten (Currently handled with sendtotrash but it doesn't work at times, so not a reliable solution)

Declined Features

• Horizontal and Vertical Splits
• Transparent UI