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

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

noice is a small ncurses-based file manager.
It was first developped 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 direcotry. 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
| q    |       |       | exit program
| !    |       |       | spawn shell in current directory
+------+-------+-------+---------------------------------------------------

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

Depending on the filetype, noice will open the selected file with the
application specified in `config.h` at compilation time. The associations
specified are regexes, so you might experience issues when trying to open a file
that do 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.

Contact
=======

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