noice.1 - noice - small file browser (mirror / fork from 2f30.org)
 (HTM) git clone git://git.codemadness.org/noice
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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 lostd@2f30.org ,
          142 .An Dimitris Papastamos Aq Mt sin@2f30.org .