Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lecram/rover

simple file browser for the terminal
https://github.com/lecram/rover

file-browser file-manager terminal

Last synced: 11 days ago
JSON representation

simple file browser for the terminal

Awesome Lists containing this project

README

        

Introduction
============

Rover is a file browser for the terminal.

![Rover screenshot](/../screenshots/screenshot.png?raw=true "Screenshot")

The main goal is to provide a faster way to explore a file system from the
terminal, compared to what's possible by using `cd`, `ls`, etc. Rover has
vi-like key bindings for navigation and can open files in $PAGER and $EDITOR.
Basic file system operations are also implemented (see rover(1) for details).
Rover is designed to be simple, fast and portable.

Quick Start
===========

Building and Installing:
```
$ make
$ sudo make install
```

Running:
```
$ rover [DIR1 [DIR2 [DIR3 [...]]]]
```

Basic Usage:
```
q - quit Rover
? - show Rover manual
j/k - move cursor down/up
J/K - move cursor down/up 10 lines
g/G - move cursor to top/bottom of listing
l - enter selected directory
h - go to parent directory
H - go to $HOME directory
0-9 - change tab
RETURN - open $SHELL on the current directory
SPACE - open $PAGER with the selected file
e - open $VISUAL or $EDITOR with the selected file
/ - start incremental search (RETURN to finish)
n/N - create new file/directory
R - rename selected file or directory
D - delete selected file or (empty) directory
```

Please read rover(1) for more information.

Requirements
============

* Unix-like system;
* curses library.

Configuration
=============

Rover configuration (mostly key bindings and colors) can only be changed by
editing the file `config.h` and rebuilding the binary.

Note that the external programs executed by some Rover commands may be changed
via the appropriate environment variables. For example, to specify an editor:
```
$ VISUAL=vi rover
```

Rover will first check for variables prefixed with ROVER_. This can be used to
change Rover behavior without interfering with the global environment:
```
$ ROVER_VISUAL=vi rover
```

Please read rover(1) for more information.

Copying
=======

All of the source code and documentation for Rover is released into the public
domain and provided without warranty of any kind.