--- layout: project title: Netctl GUI short: netctl-gui hasgui: true developers: - Evgeniy Alelseev license: GPLv3 links: - Page on Softpedia - Page on kde-apps.org - AUR package ---

## Information

Graphical interface for `netctl` (several scripts for work with network connection in Archlinux). It is written on `CPP` using `Qt4` library. Now it may work with profiles and may create new profiles. Also it may create a connection to WiFi. Moreover, it provides a Qt library for interaction with netctl and widget and DataEngine for KDE.

NOTE: LOOKING FOR TRANSLATORS!

{% highlight bash %} $ netctl-gui --help Usage: netctl-gui [ --about ] [ --netctl-auto ] [ --settings ] [ -e ESSID | --essid ESSID ] [ -o PROFILE | --open PROFILE ] [ -s PROFILE | --select PROFILE ] [ --config FILE ] [ -d | --debug ] [ --default ] [ --set-opts OPTIONS ] [ -t NUM | --tab NUM ] [ -v | --version ] [ -i | --info ] [ -h | --help] Parametrs: Open window: --about - show about window --netctl-auto - show netctl-auto window --settings - show settings window Functions: -e ESSID --essid ESSID - select ESSID ESSID -o PROFILE --open PROFILE - open profile PROFILE -s PROFILE --select PROFILE - select profile PROFILE Additional flags: --config /home/arcanis/.config/netctl-gui.conf - read configuration from this file -d --debug - print debug information --default - start with default settings --set-opts OPTIONS - set options for this run, comma separated -t 1 --tab 1 - open a tab with number 1 Show messages: -v --version - show version and exit -i --info - show build information and exit -h --help - show this help and exit {% endhighlight %}

### Developers and contributors

{% for devel in page.developers %}
- {{ devel }}
{% endfor %}

### License

- {{ page.license }}

### Changelog

CHANGELOG

## Installation

### Instruction

- Download an archive with latest version of source files.

- Extract it and install the application:

  If you want install it into `/`, you should run as root following commands:

  {% highlight bash %} cd /path/to/extracted/archive mkdir build && cd build cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../ make sudo make install {% endhighlight %}

  Available cmake flags are:

  - `-DBUILD_DATAENGINE:BOOL=0` - do not build DataEngine;

  - `-DBUILD_DOCS:BOOL=0` - do not build developer documentation;

  - `-DBUILD_GUI:BOOL=0` - do not build GUI;

  - `-DBUILD_LIBRARY:BOOL=0` - do not build library;

  - `-DBUILD_PLASMOID:BOOL=0` - do not build Plasmoid;

  - `-DUSE_QT5:BOOL=0` - use Qt4 instead of Qt5 for GUI.

### Dependencies

I want note that all were tested on latest version of dependencies.

- netctl
- qt5-base (if Qt5 is used) or qt4 (if Qt4 is used)
- automoc4 (make)
- cmake (make)
- qt5-tools (make, if Qt5 is used)
- kdebase-workspace (optional, widget)
- sudo (optional, sudo support)
- wpa_actiond (optional, netctl-auto support)
- wpa_supplicant (optional, WiFi support)

  ## How to use

  Just run application `netctl-gui`. If it is needed (and if you use KDE), you may add widget `netctl`, which provides by the application.

  ## Configuration

  It is recommended to use graphical interface for widget and DataEngine configuration. All settings of GUI are stored in `$HOME/.config/netctl-gui.conf`. It is highly recommended to edit it from graphical interface.

  ## Graphical user interface

  Graphical interface provides by `netctl-gui` application.

  ### Screenshots

  DataEngine:
  Widget:
  Widget settings window:
  Main window:
  Profile creation tab:
  WiFi menu:
  About window:
  netctl-auto window:
  Settings window: