User Tools

Site Tools


programming:ncurses

This is an old revision of the document!


ncurses

Installation

Debian package

In Debian, the easiest way to install is with:

sudo apt install libncurses6

Build from source

To build from source, get the latest version from the download page.

# Download ncurses
wget ftp://ftp.invisible-island.net/ncurses/ncurses.tar.gz
# Extract
tar xzf ncurses.tar.gz
# Enter the directory
cd ncurses-6.3
 
# Typical build steps
./configure --help | less
# Set to install in home rather than system
./configure --prefix=$HOME/.local --with-shared
make
make install

The man pages with API documentation will be in ~/.local/share/man/ if you used the home prefix.

If you install to your home rather than the system, when compiling, linking, and running, you may need to specify where the header files and libraries are. With gcc, that's the -I and -L options. When running, set the environment variable LD_LIBRARY_PATH to include path to libraries.

ncurses6-config tool

Ncurses comes with a helper function useful for these tasks, ncurses6-config which will be in ~/.local/bin/ if you used the home prefix.

# For compiling and specifying include dirs
ncurses6-config --cflags
# -D_DEFAULT_SOURCE -D_XOPEN_SOURCE=600 -I/home/dano/.local/include/ncurses -I/home/dano/.local/include
 
# For linking and specifying lib dirs
ncurses6-config --libs
# -L/home/dano/.local/lib -lncurses
 
# For LD_LIBRARY_PATH when executing and linking dynamically
ncurses6-config  --libdir
#/home/dano/.local/lib

Hello world example

hello_curses.cpp
 
int main(int argc, char* argv[]) {
  return 0;
}
programming/ncurses.1647664225.txt.gz · Last modified: 2022/03/19 04:30 by nanodano