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


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

noice is a small curses-based file browser.
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.

For more information refer to the manpage.


Building
========

To build noice you need a curses implementation available.  In most
cases you just do:

    make

It is known to work on OpenBSD, NetBSD, FreeBSD, DragonFly BSD, Linux,
IRIX 6.5, Haiku and Solaris 9.  Some notes for building on certain systems
follow.

 * IRIX 6.5:
   Tested with gcc from http://freeware.sgi.com/.

    make CC="gcc" LDLIBS="-lgen -lcurses"

 * Haiku:

    make LDLIBS="-lncurses"

 * Solaris 9:
   Tested with gcc from http://www.opencsw.org/.

    export PATH=/usr/ccs/bin:/opt/csw/bin:$PATH
    make CC="gcc"


Contact
=======

To report bugs and/or submit patches, you can reach us through
the freenode IRC network at #2f30.