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