2016-02-25 18:06:57 +03:00
|
|
|
.Dd February 25, 2016
|
2014-10-22 15:52:45 +04:00
|
|
|
.Dt NOICE 1
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm noice
|
2014-10-22 18:27:53 +04:00
|
|
|
.Nd small file browser
|
2014-10-22 15:52:45 +04:00
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm noice
|
|
|
|
.Op Ar dir
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm
|
2014-10-22 18:27:53 +04:00
|
|
|
is a simple and efficient file browser that gets out of your way
|
2014-10-22 15:52:45 +04:00
|
|
|
as much as possible. It was initially implemented to be controlled
|
|
|
|
with a TV remote control.
|
|
|
|
.Pp
|
|
|
|
.Nm
|
2014-10-22 16:28:00 +04:00
|
|
|
defaults to the current directory if
|
|
|
|
.Ar dir
|
2014-11-14 17:22:07 +03:00
|
|
|
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.
|
2014-10-22 16:28:00 +04:00
|
|
|
.Pp
|
|
|
|
.Nm
|
2014-10-22 15:52:45 +04:00
|
|
|
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
|
2014-11-14 17:41:46 +03:00
|
|
|
.Bl -tag -width "l, [Right], [Return] or C-mXXXX" -offset indent -compact
|
|
|
|
.It Ic k, [Up] or C-p
|
2014-10-22 15:52:45 +04:00
|
|
|
Move to previous entry.
|
2014-11-14 17:41:46 +03:00
|
|
|
.It Ic j, [Down] or C-n
|
2014-10-22 15:52:45 +04:00
|
|
|
Move to next entry.
|
2014-11-14 17:41:46 +03:00
|
|
|
.It Ic [Pgup] or C-u
|
|
|
|
Scroll up half a page.
|
|
|
|
.It Ic [Pgdown] or C-d
|
|
|
|
Scroll down half a page.
|
2015-11-26 18:03:26 +03:00
|
|
|
.It Ic [Home], ^ or C-a
|
2015-07-12 15:32:31 +03:00
|
|
|
Move to the first entry.
|
2015-11-26 18:03:26 +03:00
|
|
|
.It Ic [End], $ or C-e
|
2015-07-12 15:32:31 +03:00
|
|
|
Move to the last entry.
|
2014-11-14 17:41:46 +03:00
|
|
|
.It Ic l, [Right], [Return] or C-m
|
2014-10-22 15:52:45 +04:00
|
|
|
Open file or enter directory.
|
2015-11-26 18:03:26 +03:00
|
|
|
.It Ic h, C-h, [Left] or [Backspace]
|
2014-10-22 15:52:45 +04:00
|
|
|
Back up one directory level.
|
2014-11-14 17:41:46 +03:00
|
|
|
.It Ic / or &
|
|
|
|
Change filter (see below for more information).
|
2014-10-22 15:52:45 +04:00
|
|
|
.It Ic c
|
|
|
|
Change into the given directory.
|
2016-02-25 18:06:57 +03:00
|
|
|
.It Ic ~
|
|
|
|
Change to the HOME directory.
|
2016-02-25 17:54:41 +03:00
|
|
|
.It Ic \&.
|
|
|
|
Toggle hide .dot files.
|
2015-02-01 01:02:59 +03:00
|
|
|
.It Ic t
|
2015-02-05 18:53:50 +03:00
|
|
|
Toggle sort by time modified.
|
2015-11-26 18:03:26 +03:00
|
|
|
.It Ic C-l
|
2015-03-11 21:55:28 +03:00
|
|
|
Force a redraw.
|
2015-07-02 19:49:17 +03:00
|
|
|
.It Ic \&!
|
2016-02-19 16:56:42 +03:00
|
|
|
Spawn a shell in current directory.
|
2015-03-12 17:12:01 +03:00
|
|
|
.It Ic z
|
|
|
|
Run the system top utility.
|
|
|
|
.It Ic e
|
|
|
|
Open selected entry with the vi editor.
|
2015-11-26 18:03:26 +03:00
|
|
|
.It Ic p
|
|
|
|
Open selected entry with the less pager.
|
2014-10-22 15:52:45 +04:00
|
|
|
.It Ic q
|
2014-11-14 17:41:46 +03:00
|
|
|
Quit.
|
2014-10-22 15:57:22 +04:00
|
|
|
.El
|
2014-11-14 17:45:17 +03:00
|
|
|
.Pp
|
|
|
|
Backing up one directory level will set the cursor position at the
|
|
|
|
directory you came out of.
|
2014-10-22 15:52:45 +04:00
|
|
|
.Sh CONFIGURATION
|
|
|
|
.Nm
|
|
|
|
is configured by modifying
|
|
|
|
.Pa config.h
|
|
|
|
and recompiling the code.
|
|
|
|
.Pp
|
|
|
|
The file associations are specified by regexes
|
|
|
|
matching on the currently selected filename. If a match is found the associated
|
|
|
|
program is executed with the filename passed in as the argument. If no match
|
2014-11-14 17:41:46 +03:00
|
|
|
is found the program
|
|
|
|
.Xr less 1
|
|
|
|
is invoked. This is useful for editing text files
|
|
|
|
as one can use the 'v' command in
|
2015-11-26 18:05:16 +03:00
|
|
|
.Xr less 1 to edit the file using the EDITOR environment variable.
|
2014-10-22 15:52:45 +04:00
|
|
|
.Pp
|
|
|
|
See the examples section below for more information.
|
|
|
|
.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
|
2015-01-27 13:24:09 +03:00
|
|
|
To reset the filter you can input an empty filter expression.
|
2014-10-22 16:28:00 +04:00
|
|
|
.Pp
|
|
|
|
If
|
|
|
|
.Nm
|
|
|
|
is invoked as root the default filter will also match hidden
|
|
|
|
files.
|
2015-11-26 18:03:26 +03:00
|
|
|
.Sh ENVIRONMENT
|
|
|
|
The SHELL, EDITOR and PAGER environment variables take precedence
|
|
|
|
when dealing with the !, e and p commands respectively.
|
2014-10-22 15:52:45 +04:00
|
|
|
.Sh EXAMPLES
|
|
|
|
The following example shows one possible configuration for
|
2014-11-14 17:41:46 +03:00
|
|
|
file associations which is also the default:
|
2014-10-22 15:52:45 +04:00
|
|
|
.Bd -literal
|
|
|
|
struct assoc assocs[] = {
|
2015-08-19 10:39:19 +03:00
|
|
|
{ "\\.(avi|mp4|mkv|mp3|ogg|flac|mov)$", "mplayer" },
|
2015-01-12 20:10:45 +03:00
|
|
|
{ "\\.(png|jpg|gif)$", "feh" },
|
|
|
|
{ "\\.(html|svg)$", "firefox" },
|
|
|
|
{ "\\.pdf$", "mupdf" },
|
|
|
|
{ "\\.sh$", "sh" },
|
|
|
|
{ ".", "less" },
|
2014-10-22 15:52:45 +04:00
|
|
|
};
|
|
|
|
.Ed
|
2014-10-22 17:59:15 +04:00
|
|
|
.Sh KNOWN ISSUES
|
2015-02-01 01:58:08 +03:00
|
|
|
If you are using urxvt you might have to set backspacekey to DEC.
|
2014-10-22 15:52:45 +04:00
|
|
|
.Sh AUTHORS
|
2015-07-02 19:49:17 +03:00
|
|
|
.An Lazaros Koromilas Aq Mt lostd@2f30.org ,
|
|
|
|
.An Dimitris Papastamos Aq Mt sin@2f30.org .
|