https://github.com/lecram/rover
simple file browser for the terminal
https://github.com/lecram/rover
file-browser file-manager terminal
Last synced: 6 months ago
JSON representation
simple file browser for the terminal
- Host: GitHub
- URL: https://github.com/lecram/rover
- Owner: lecram
- Created: 2014-11-07T20:12:49.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-01-07T21:10:36.000Z (over 3 years ago)
- Last Synced: 2025-06-21T16:39:12.286Z (12 months ago)
- Topics: file-browser, file-manager, terminal
- Language: C
- Homepage: http://lecram.github.io/p/rover/
- Size: 375 KB
- Stars: 335
- Watchers: 11
- Forks: 29
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
Awesome Lists containing this project
- awesome-starred - lecram/rover - simple file browser for the terminal (terminal)
- awesome-ricing - rover - simple file browser for the terminal. (C) (Packages / CLI Tools)
README
Introduction
============
Rover is a file browser for the terminal.
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.