aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 1cbefae8ed4c587bf73d1bee3d4042e3a1f1dcd9 (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
               __                  
  ___     ___ /\_\    ___     __   
/' _ `\  / __`\/\ \  /'___\ /'__`\ 
/\ \/\ \/\ \L\ \ \ \/\ \__//\  __/ 
\ \_\ \_\ \____/\ \_\ \____\ \____\
 \/_/\/_/\/___/  \/_/\/____/\/____/
                                    -- by lostd and sin
=======================================================

What is it?
===========

noice is a small ncurses-based file manager.
It was first developed to be used with a tv remote control for a media center
solution.

Getting started
===============

Get the latest version from the git-repository; build and install it.
Run noice in a directory to display its content in the form of a list, where
each line is a file or directory. The currently selected item will be preceded
with a " > " by default.

Navigation
----------

You can navigate the list using the following keybinds (hardcoded):

+------+-------+-------+---------------------------------------------------
| k    | UP    | ^P    | go up
| j    | DOWN  | ^N    | go down
|      | PGUP  | ^U    | go up (fast)
|      | PGDN  | ^D    | go down (fast)
| l    | RIGHT | ^M    | open file / directory (see section "File opening")
| h    | LEFT  | ^?    | navigate up one directory
| /    | &     |       | filter output
| !    |       |       | spawn shell in current directory
| c    |       |       | chdir into the given path
| q    |       |       | exit program
+------+-------+-------+---------------------------------------------------

File opening
------------

Depending on the filetype, noice will open the selected file with the
application specified in `config.h` at compilation time. The associations
are specified by regexes, so you might experience issues when trying to open a file
that does not match those regexes.

The default program is less(1).  For text files, you can use the 'v'
commaind in less(1) to open the file in your $EDITOR.

Filters
-------

Filters narrow down the view.  This effectively allows you to easily search/jump
to a particular file or directory.  If you want to reset the filter then you can
just use the match-any regex (i.e. .*).  You can think of noice being in search
mode all the time.

Filters do not stack or nest.  They are applied afresh every time.

Contact
=======

You can reach us through the freenode IRC network at #2f30.
If you have any patches, ideas or feedback feel free to join.
Un proyecto texto-plano.xyz