noice.1 - noice - small file browser (mirror / fork from 2f30.org) | |
git clone git://git.codemadness.org/noice | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
noice.1 (3022B) | |
--- | |
1 .Dd August 23, 2019 | |
2 .Dt NOICE 1 | |
3 .Os | |
4 .Sh NAME | |
5 .Nm noice | |
6 .Nd small file browser | |
7 .Sh SYNOPSIS | |
8 .Nm | |
9 .Op Fl c | |
10 .Op Ar dir | |
11 .Sh DESCRIPTION | |
12 .Nm | |
13 is a simple and efficient file browser that gets out of your way | |
14 as much as possible. | |
15 It was initially implemented to be controlled with a TV remote control. | |
16 .Pp | |
17 .Nm | |
18 defaults to the current directory if | |
19 .Ar dir | |
20 is not specified. | |
21 As an extra feature, if | |
22 .Ar dir | |
23 is a relative path, | |
24 .Nm | |
25 will not go back beyond the first component of the path using standard | |
26 navigation key presses. | |
27 .Pp | |
28 .Nm | |
29 supports both vi-like and emacs-like key bindings in the default | |
30 configuration. | |
31 The default key bindings are described below; | |
32 their functionality is described in more detail later. | |
33 .Pp | |
34 .Bl -tag -width "l, [Right], [Return] or C-mXXXX" -offset indent -compact | |
35 .It Ic k, [Up] or C-p | |
36 Move to previous entry. | |
37 .It Ic j, [Down] or C-n | |
38 Move to next entry. | |
39 .It Ic [Pgup] or C-u | |
40 Scroll up half a page. | |
41 .It Ic [Pgdown] or C-d | |
42 Scroll down half a page. | |
43 .It Ic [Home], ^ or M-< | |
44 Move to the first entry. | |
45 .It Ic [End], $ or M-> | |
46 Move to the last entry. | |
47 .It Ic l, [Right], [Return] or C-m | |
48 Open file or enter directory. | |
49 .It Ic h, C-h, [Left] or [Backspace] | |
50 Back up one directory level. | |
51 .It Ic / or & | |
52 Change filter (see below for more information). | |
53 .It Ic c | |
54 Change into the given directory. | |
55 .It Ic ~ | |
56 Change to the | |
57 .Ev HOME | |
58 directory. | |
59 .It Ic \&. | |
60 Toggle hidden .dot files. | |
61 .It Ic d | |
62 Toggle sort by directory first. | |
63 .It Ic t | |
64 Toggle sort by time modified. | |
65 .It Ic i | |
66 Toggle case sensitive sort. | |
67 .It Ic v | |
68 Toggle sort by version number. | |
69 .It Ic C-l | |
70 Force a redraw. | |
71 .It Ic \&! | |
72 Spawn a shell in current directory. | |
73 .It Ic z | |
74 Run the system top utility. | |
75 .It Ic e | |
76 Open selected entry with the vi editor. | |
77 .It Ic p | |
78 Open selected entry with the less pager. | |
79 .It Ic q | |
80 Quit. | |
81 .El | |
82 .Pp | |
83 Backing up one directory level will set the cursor position at the | |
84 directory you came out of. | |
85 .Sh OPTIONS | |
86 .Bl -tag -width "-c" | |
87 .It Fl c | |
88 Enable colors. | |
89 .El | |
90 .Sh CONFIGURATION | |
91 .Nm | |
92 is configured by modifying | |
93 .Pa noiceconf.h | |
94 and recompiling the code. | |
95 .Pp | |
96 .Nm | |
97 invokes | |
98 .Xr nopen 1 | |
99 to open a file in the user's preferred application. | |
100 .Sh FILTERS | |
101 Filters allow you to use regexes to display only the matched | |
102 entries in the current directory view. | |
103 This effectively allows searching through the directory tree | |
104 for a particular entry. | |
105 .Pp | |
106 Filters do not stack on top of each other. | |
107 They are applied anew every time. | |
108 .Pp | |
109 To reset the filter you can input an empty filter expression. | |
110 .Pp | |
111 If | |
112 .Nm | |
113 is invoked as root the default filter will also match hidden files. | |
114 .Sh ENVIRONMENT | |
115 The | |
116 .Ev SHELL , | |
117 .Ev EDITOR | |
118 and | |
119 .Ev PAGER | |
120 environment variables take precedence when dealing with the | |
121 .Ic \&! , | |
122 .Ic e | |
123 and | |
124 .Ic p | |
125 commands respectively. | |
126 .Pp | |
127 The | |
128 .Ev NOPEN | |
129 environment variable can be used to specify the plumber | |
130 program used by | |
131 .Nm . | |
132 It defaults to | |
133 .Xr nopen 1 . | |
134 .Sh KNOWN ISSUES | |
135 If you are using | |
136 .Xr urxvt 1 | |
137 you might have to set backspace key to DEC. | |
138 .Sh SEE ALSO | |
139 .Xr nopen 1 | |
140 .Sh AUTHORS | |
141 .An Lazaros Koromilas Aq Mt [email protected] , | |
142 .An Dimitris Papastamos Aq Mt [email protected] . |