1 8fe7904a 2014-11-07 marcelgmr Introduction
2 8fe7904a 2014-11-07 marcelgmr ============
4 ee238663 2014-11-09 marcelgmr Rover is a file browser for the terminal.
6 95bdeca1 2014-11-07 marcelgmr 
8 cc8a22df 2014-11-07 marcelgmr The main goal is to provide a faster way to explore a file system from the
9 d781a4b9 2015-04-17 marcelgmr terminal, compared to what's possible by using `cd`, `ls`, etc. Rover has
10 d781a4b9 2015-04-17 marcelgmr vi-like key bindings for navigation and can open files in $PAGER and $EDITOR.
11 d781a4b9 2015-04-17 marcelgmr Basic file system operations are also implemented (see rover(1) for details).
12 d781a4b9 2015-04-17 marcelgmr Rover is designed to be simple, fast and portable.
15 8fe7904a 2014-11-07 marcelgmr Quick Start
16 8fe7904a 2014-11-07 marcelgmr ===========
18 d781a4b9 2015-04-17 marcelgmr Building and Installing:
21 8faaef35 2014-11-09 marcelgmr $ sudo make install
24 8fe7904a 2014-11-07 marcelgmr Running:
26 ac947adb 2014-11-09 marcelgmr $ rover [DIR1 [DIR2 [DIR3 [...]]]]
29 179ab105 2017-02-15 marcelgmr Basic Usage:
31 8fe7904a 2014-11-07 marcelgmr q - quit Rover
32 33a574e8 2014-12-02 marcelgmr ? - show Rover manual
33 8986353b 2014-11-11 marcelgmr j/k - move cursor down/up
34 8986353b 2014-11-11 marcelgmr J/K - move cursor down/up 10 lines
35 b90df0a4 2015-06-05 marcelgmr g/G - move cursor to top/bottom of listing
36 8fe7904a 2014-11-07 marcelgmr l - enter selected directory
37 8fe7904a 2014-11-07 marcelgmr h - go to parent directory
38 8fe7904a 2014-11-07 marcelgmr H - go to $HOME directory
39 179ab105 2017-02-15 marcelgmr 0-9 - change tab
40 8fe7904a 2014-11-07 marcelgmr RETURN - open $SHELL on the current directory
41 2f7057e8 2014-11-09 marcelgmr SPACE - open $PAGER with the selected file
42 2f7057e8 2014-11-09 marcelgmr e - open $EDITOR with the selected file
43 8fe7904a 2014-11-07 marcelgmr / - start incremental search (RETURN to finish)
44 7b9cb44d 2014-11-14 marcelgmr n/N - create new file/directory
45 2a2e3586 2015-07-27 marcelgmr R - rename selected file or directory
46 5544fe58 2015-07-22 marcelgmr D - delete selected file or (empty) directory
49 179ab105 2017-02-15 marcelgmr Please read rover(1) for more information.
52 335bf069 2015-06-21 marcelgmr Requirements
53 0aeec769 2014-11-07 marcelgmr ============
55 335bf069 2015-06-21 marcelgmr * Unix-like system;
56 335bf069 2015-06-21 marcelgmr * curses library.
59 8fe7904a 2014-11-07 marcelgmr Configuration
60 8fe7904a 2014-11-07 marcelgmr =============
62 335bf069 2015-06-21 marcelgmr Rover configuration (mostly key bindings and colors) can only be changed by
63 335bf069 2015-06-21 marcelgmr editing the file `config.h` and rebuilding the binary.
65 0aeec769 2014-11-07 marcelgmr Note that the external programs executed by some Rover commands may be changed
66 719c5cd4 2014-11-08 marcelgmr via the appropriate environment variables. For example, to specify an editor:
68 719c5cd4 2014-11-08 marcelgmr $ EDITOR=vi rover
71 8225771f 2016-12-05 marcelgmr Rover will first check for variables prefixed with ROVER_. This can be used to
72 8225771f 2016-12-05 marcelgmr change Rover behavior without interfering with the global environment:
74 8225771f 2016-12-05 marcelgmr $ ROVER_EDITOR=vi rover
77 d1f7bb95 2015-06-02 marcelgmr Please read rover(1) for more information.
80 d1f7bb95 2015-06-02 marcelgmr Copying
81 d1f7bb95 2015-06-02 marcelgmr =======
83 d1f7bb95 2015-06-02 marcelgmr All of the source code and documentation for Rover is released into the public
84 cfa4fe73 2014-12-03 marcelgmr domain and provided without warranty of any kind.
