Text user interface for simple-netaid based on the ncurses library
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Aitor faff52f97e Send SIGTERM signal from inotinit to the parent process when snetaid stops 3 months ago
cdk Start monitoring netlink events even when running within the vte container 3 months ago
libs Send SIGTERM signal from inotinit to the parent process when snetaid stops 3 months ago
screenshots Update screenshots 5 months ago
Makefile Move from GNU Autotools to GNU Make build system and restructure the tree 3 months ago
README.md Bump to 1.0 1 year ago
globals.h Make interface reactive to netlink events 3 months ago



Text user interface for simple-netaid developed with the Curses Development Kit (CDK), based on the ncurses library. Simple-netaid is a networking management tool with minimal dependencies and easy to use, without the need of an specific Desktop Environment.


Use the APT package manager to install simple-netaid-cdk.

apt-get install simple-netaid-cdk

Building your own packages

You can build your own debian packages in a very easy way using git-buildpackage (a wrapper for dpkg-buildpackage). All you need to do is:

$ git clone https://git.devuan.org/aitor_czr/simple-netaid-cdk.git
$ cd simple-netaid-cdk

If you type git status you can see all:

On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean

To list all the local and remote branches type:

$ git branch -a

Let's checkout on the following branches (in this order):

$ git checkout -b pristine-tar origin/pristine-tar
$ git checkout -b gbp-release_0.1 origin/gbp-release_0.1

The prefix gbp reflects those branches containing the debian folder. Now we can build the packages:

$ gbp buildpackage

Once the packages have been generated, go to the build directory and install them:

$ cd ../build-area
$ sudo dpkg -i *.deb

Building from source

If you are using a different package management system, then you'll need to build the project from source.

Build dependencies

The current version of snetaid has been tested under Devuan Beowulf, requiring:

  • gcc (4:8.3.0-1)
  • cmake (3.13.4-1)
  • libcdk5-dev (5.0.20180306-3)
  • libnetaid-dev (0.1-1)

Practical dependencies at run time:

  • wpasupplicant
  • ifupdown

libnetaid is available here.


Download the tarball from the git repository of devuan simple-netaid-cdk, extract it with tar xvf master.tar.gz and go into the extracted folder. There, run the following commands:

$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install

Note: By default, CMake does not provide the "make uninstall" target; so, in general, you cannot do this. However, snetaid adds an uninstall target to the CMAKE generated Makefile, in such a way that you can run:

$ sudo make uninstall


The usage of simple-netaid-cdk is very intuitive, since it consists of a very simple and user-friendly interface. You need root permissions to run the application. All the saved active wifis are installed in /etc/network/wifi by wpa_passphrase.

If you want to automatically connect on boot, then you need to install the snetaid service.


Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.


simple-netaid-cdk is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

simple-netaid-cdk is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

See the COPYING file.