/rover

simple file browser for the terminal

Primary LanguageC

Introduction

Rover is a file browser for the terminal.

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