/ncurses-toolkit

Collection of C++ modules leveraging the power of ncurses library for console-based user interaction.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

nCurses Toolkit for C++

License nCurses Linux

Introduction

Welcome to the ncurses-toolkit for C++ repository! This project aims to provide a versatile and easy-to-use toolkit for building text-based user interfaces (TUIs) in C++ using the ncurses library. Designed specifically for Linux environments, this toolkit empowers developers to create dynamic and interactive console applications with ease.

Features

  • Menu Class: Our toolkit includes a robust Menu class to kickstart your TUI development journey.
  • Dialog Box Class: Our Dialog Box Class provides a versatile solution for creating interactive dialogue boxes within your text-based user interface (TUI).

Getting started

Prerequisites

Before getting started with ncurses-toolkit, ensure that you have the following dependencies installed on your Linux system:

  • g++ compiler
  • ncurses library

Installation

To use the ncurses-toolkit in your C++ projects, follow these steps:

  1. Clone the repository to your local machine:
git clone https://github.com/ignabelitzky/ncurses-toolkit.git
  1. Include the necessary header files in your C++ code:
#include "ncurses-toolkit/include/menu.hpp"
#include "ncurses-toolkit/include/dialog_box.hpp"
// Include other necessary headers for additional features
  1. Compile your project with the ncurses library:
g++ -o your_program your_program.cpp -lncurses

Usage

Check out the examples provided in the misc/ directory to see how to use the ncurses-toolkit in your projects.

Contributing

We welcome contributions from the community! Whether it's bug fixes, feature enhancements, or new ideas, feel free to open an issue or submit a pull request.

License

This project is licensed under the GNU General Public License v3.0, which means you are free to use, modify, and distribute the code for both commercial and non-commercial purposes.