Blame


1 8fe7904a 2014-11-07 marcelgmr Introduction
2 8fe7904a 2014-11-07 marcelgmr ============
3 8fe7904a 2014-11-07 marcelgmr
4 ee238663 2014-11-09 marcelgmr Rover is a file browser for the terminal.
5 cc8a22df 2014-11-07 marcelgmr
6 95bdeca1 2014-11-07 marcelgmr ![Rover screenshot](/../screenshots/screenshot.png?raw=true "Screenshot")
7 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 8fe7904a 2014-11-07 marcelgmr terminal, compared to what's possible by using `cd`, `ls`, etc. Rover
10 8fe7904a 2014-11-07 marcelgmr is designed to be simple and portable. It was originally written to be
11 8fe7904a 2014-11-07 marcelgmr used on a headless Raspberry Pi accessed via ssh. The [Ranger file manager](http://ranger.nongnu.org/)
12 8fe7904a 2014-11-07 marcelgmr was a major inspiration for the user interface design, but Rover has
13 8fe7904a 2014-11-07 marcelgmr significantly less features and dependencies.
14 8fe7904a 2014-11-07 marcelgmr
15 8fe7904a 2014-11-07 marcelgmr
16 8fe7904a 2014-11-07 marcelgmr Quick Start
17 8fe7904a 2014-11-07 marcelgmr ===========
18 8fe7904a 2014-11-07 marcelgmr
19 8fe7904a 2014-11-07 marcelgmr Building:
20 8fe7904a 2014-11-07 marcelgmr ```
21 8fe7904a 2014-11-07 marcelgmr $ make
22 8fe7904a 2014-11-07 marcelgmr ```
23 8fe7904a 2014-11-07 marcelgmr
24 719c5cd4 2014-11-08 marcelgmr Installing:
25 719c5cd4 2014-11-08 marcelgmr ```
26 8faaef35 2014-11-09 marcelgmr $ sudo make install
27 719c5cd4 2014-11-08 marcelgmr ```
28 719c5cd4 2014-11-08 marcelgmr
29 8fe7904a 2014-11-07 marcelgmr Running:
30 8fe7904a 2014-11-07 marcelgmr ```
31 719c5cd4 2014-11-08 marcelgmr $ rover
32 8fe7904a 2014-11-07 marcelgmr ```
33 8fe7904a 2014-11-07 marcelgmr
34 ac947adb 2014-11-09 marcelgmr Specify path for some (up to 9) tabs at startup:
35 ac947adb 2014-11-09 marcelgmr ```
36 ac947adb 2014-11-09 marcelgmr $ rover [DIR1 [DIR2 [DIR3 [...]]]]
37 ac947adb 2014-11-09 marcelgmr ```
38 ac947adb 2014-11-09 marcelgmr
39 8fe7904a 2014-11-07 marcelgmr Using:
40 8fe7904a 2014-11-07 marcelgmr ```
41 8fe7904a 2014-11-07 marcelgmr q - quit Rover
42 33a574e8 2014-12-02 marcelgmr ? - show Rover manual
43 8986353b 2014-11-11 marcelgmr j/k - move cursor down/up
44 8986353b 2014-11-11 marcelgmr J/K - move cursor down/up 10 lines
45 8fe7904a 2014-11-07 marcelgmr l - enter selected directory
46 8fe7904a 2014-11-07 marcelgmr h - go to parent directory
47 8fe7904a 2014-11-07 marcelgmr H - go to $HOME directory
48 8fe7904a 2014-11-07 marcelgmr RETURN - open $SHELL on the current directory
49 2f7057e8 2014-11-09 marcelgmr SPACE - open $PAGER with the selected file
50 2f7057e8 2014-11-09 marcelgmr e - open $EDITOR with the selected file
51 8fe7904a 2014-11-07 marcelgmr / - start incremental search (RETURN to finish)
52 7b9cb44d 2014-11-14 marcelgmr f/d/s - toggle file/directory/hidden listing
53 7b9cb44d 2014-11-14 marcelgmr n/N - create new file/directory
54 7b9cb44d 2014-11-14 marcelgmr r - rename selected file or directory
55 7b9cb44d 2014-11-14 marcelgmr m - toggle mark on the selected entry
56 7b9cb44d 2014-11-14 marcelgmr M - toggle mark on all visible entries
57 7b9cb44d 2014-11-14 marcelgmr a - mark all visible entries
58 7b9cb44d 2014-11-14 marcelgmr X/C/V - delete/copy/move all marked entries
59 c78b45be 2014-11-09 marcelgmr 0-9 - change tab
60 8fe7904a 2014-11-07 marcelgmr ```
61 8fe7904a 2014-11-07 marcelgmr
62 a31a7b29 2014-11-15 marcelgmr **Important Note**: Currently, Rover never asks for confirmation before
63 a31a7b29 2014-11-15 marcelgmr overwriting existing files while copying/moving marked entries. Please be
64 a31a7b29 2014-11-15 marcelgmr careful to not accidentally lose your data.
65 8fe7904a 2014-11-07 marcelgmr
66 7fa0e315 2014-11-14 marcelgmr
67 0aeec769 2014-11-07 marcelgmr Dependencies
68 0aeec769 2014-11-07 marcelgmr ============
69 0aeec769 2014-11-07 marcelgmr
70 0aeec769 2014-11-07 marcelgmr Rover is supposed to run on any Unix-like system with a curses implementation.
71 d925320d 2014-11-07 marcelgmr To build Rover, you need a C compiler (supporting at least C89) and a `curses.h`
72 d925320d 2014-11-07 marcelgmr header file.
73 0aeec769 2014-11-07 marcelgmr
74 93f75985 2014-11-07 marcelgmr
75 8fe7904a 2014-11-07 marcelgmr Configuration
76 8fe7904a 2014-11-07 marcelgmr =============
77 8fe7904a 2014-11-07 marcelgmr
78 2254ef43 2014-11-11 marcelgmr By default, rover is installed to `/usr/local/bin/rover`. To change this and other
79 719c5cd4 2014-11-08 marcelgmr build options, such as the name of the curses library, please edit `Makefile`
80 719c5cd4 2014-11-08 marcelgmr before executing `make` or specify the options during invocation. For example,
81 719c5cd4 2014-11-08 marcelgmr to link against `libncurses.so` and install to `/opt/bin/rover`:
82 719c5cd4 2014-11-08 marcelgmr ```
83 2254ef43 2014-11-11 marcelgmr make LDLIBS=-lncurses PREFIX=/opt install
84 719c5cd4 2014-11-08 marcelgmr ```
85 719c5cd4 2014-11-08 marcelgmr
86 8fe7904a 2014-11-07 marcelgmr Rover configuration (mostly key bindings and colors) can only be changed
87 d925320d 2014-11-07 marcelgmr by editing the file `config.h` and rebuilding the binary (with `make`).
88 8fe7904a 2014-11-07 marcelgmr
89 0aeec769 2014-11-07 marcelgmr Note that the external programs executed by some Rover commands may be changed
90 719c5cd4 2014-11-08 marcelgmr via the appropriate environment variables. For example, to specify an editor:
91 0aeec769 2014-11-07 marcelgmr ```
92 719c5cd4 2014-11-08 marcelgmr $ EDITOR=vi rover
93 0aeec769 2014-11-07 marcelgmr ```
94 8fe7904a 2014-11-07 marcelgmr
95 0aeec769 2014-11-07 marcelgmr
96 8fe7904a 2014-11-07 marcelgmr Copyright
97 8fe7904a 2014-11-07 marcelgmr =========
98 8fe7904a 2014-11-07 marcelgmr
99 8fe7904a 2014-11-07 marcelgmr All of the code and documentation in Rover has been dedicated to the
100 8fe7904a 2014-11-07 marcelgmr public domain.