---
layout: project
title: Netctl GUI
short: netctl-gui
hasgui: true
developers:
    - Evgeniy Alelseev
license: GPLv3
links:
    - Page on <a href="http://linux.softpedia.com/get/System/Networking/Netctl-GUI-103383.shtml">Softpedia</a>
    - Page on <a href="http://kde-apps.org/content/show.php?content=164490">kde-apps.org</a>
    - <a href="https://aur.archlinux.org/pkgbase/netctl-gui/">AUR package</a>
---
<!-- info block -->
<h2><a name="info" class="anchor" href="#info"><span class="octicon octicon-link"></span></a>Information</h2>
<p>Graphical interface for <code>netctl</code> (several scripts for work with network connection in Archlinux). It is written on <code>CPP</code> using <code>Qt4</code> 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.</p>
<p><b>NOTE:</b> <a href="https://github.com/arcan1s/netctl-gui/issues/3">LOOKING FOR TRANSLATORS!</a></p>
{% 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 %}

<h3><a name="devel" class="anchor" href="#devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
<ul>
  {% for devel in page.developers %}
    <li>{{ devel }}</li>
  {% endfor %}
</ul>

<h3><a name="license" class="anchor" href="#license"><span class="octicon octicon-link"></span></a>License</h3>
<ul>
  <li>{{ page.license }}</li>
</ul>

<h3><a name="changelog" class="anchor" href="#changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
<p><a href="https://github.com/arcan1s/netctl-gui/blob/master/CHANGELOG">CHANGELOG</a></p>
<!-- end of info block -->

<!-- install block -->
<h2><a name="install" class="anchor" href="#install"><span class="octicon octicon-link"></span></a>Installation</h2>

<h3><a name="instruction" class="anchor" href="#instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
<ul>
  <li><p>Download an <a href="https://github.com/arcan1s/netctl-gui/releases">archive</a> with latest version of source files.</p></li>
  <li><p>Extract it and install the application:</p>
<p>If you want install it into <code>/</code>, you should run as root following commands:</p>
{% 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 %}
<p>Available cmake flags are:</p>
  <ul>
    <li><p><code>-DBUILD_DATAENGINE:BOOL=0</code> - do not build DataEngine;</p></li>
    <li><p><code>-DBUILD_DOCS:BOOL=0</code> - do not build developer documentation;</p></li>
    <li><p><code>-DBUILD_GUI:BOOL=0</code> - do not build GUI;</p></li>
    <li><p><code>-DBUILD_LIBRARY:BOOL=0</code> - do not build library;</p></li>
    <li><p><code>-DBUILD_PLASMOID:BOOL=0</code> - do not build Plasmoid;</p></li>
    <li><p><code>-DUSE_QT5:BOOL=0</code> - use Qt4 instead of Qt5 for GUI.</p></li>
  </ul>
  </li>
</ul>

<h3><a name="dependencies" class="anchor" href="#dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
<p>I want note that all were tested on latest version of dependencies.</p>
<ul>
  <li>netctl</li>
  <li>qt5-base <i>(if Qt5 is used)</i> <b>or</b> qt4 <i>(if Qt4 is used)</i></li>
  <li>automoc4 <i>(make)</i></li>
  <li>cmake <i>(make)</i></li>
  <li>qt5-tools <i>(make, if Qt5 is used)</i></li>
  <li>kdebase-workspace <i>(optional, widget)</i></li>
  <li>sudo <i>(optional, sudo support)</i></li>
  <li>wpa_actiond <i>(optional, netctl-auto support)</i></li>
  <li>wpa_supplicant <i>(optional, WiFi support)</i></
</ul>
<!-- end of install block -->

<!-- howto block -->
<h2><a name="howto" class="anchor" href="#howto"><span class="octicon octicon-link"></span></a>How to use</h2>
<p>Just run application <code>netctl-gui</code>. If it is needed (and if you use KDE), you may add widget <code>netctl</code>, which provides by the application.</p>
<!-- end of howto block -->

<!-- config block -->
<h2><a name="config" class="anchor" href="#config"><span class="octicon octicon-link"></span></a>Configuration</h2>
<p>It is recommended to use graphical interface for widget and DataEngine configuration. All settings of GUI are stored in <code>$HOME/.config/netctl-gui.conf</code>. It is highly recommended to edit it from graphical interface. </p>
<!-- end of config block -->

<!-- gui block -->
<h2><a name="gui" class="anchor" href="#gui"><span class="octicon octicon-link"></span></a>Graphical user interface</h2>
<p>Graphical interface provides by <code>netctl-gui</code> application.</p>

<h3><a name="screenshots" class="anchor" href="#screenshots"><span class="octicon octicon-link"></span></a>Screenshots</h3>
<p>DataEngine:<br>
<a href="/resources/screenshots/netctl-gui_dataengine.png"><img src="/resources/preview/netctl-gui_dataengine_prev.jpg"></a><br>
Widget:<br>
<a href="/resources/screenshots/netctl-gui_plasmoid.png"><img src="/resources/preview/netctl-gui_plasmoid_prev.jpg"></a><br>
Widget settings window:<br>
<a href="/resources/screenshots/netctl-gui_plasmoid_conf_01.png"><img src="/resources/preview/netctl-gui_plasmoid_conf_01_prev.jpg"></a><br>
<a href="/resources/screenshots/netctl-gui_plasmoid_conf_02.png"><img src="/resources/preview/netctl-gui_plasmoid_conf_02_prev.jpg"></a><br>
<a href="/resources/screenshots/netctl-gui_plasmoid_conf_03.png"><img src="/resources/preview/netctl-gui_plasmoid_conf_03_prev.jpg"></a><br>
Main window:<br>
<a href="/resources/screenshots/netctl-gui_main.png"><img src="/resources/preview/netctl-gui_main_prev.jpg"></a><br>
Profile creation tab:<br>
<a href="/resources/screenshots/netctl-gui_profile.png"><img src="/resources/preview/netctl-gui_profile_prev.jpg"></a><br>
WiFi menu:<br>
<a href="/resources/screenshots/netctl-gui_wifi.png"><img src="/resources/preview/netctl-gui_wifi_prev.jpg"></a><br>
About window:<br>
<a href="/resources/screenshots/netctl-gui_about.png"><img src="/resources/preview/netctl-gui_about_prev.jpg"></a><br>
netctl-auto window:<br>
<a href="/resources/screenshots/netctl-gui_netctl-auto.png"><img src="/resources/preview/netctl-gui_netctl-auto_prev.jpg"></a><br>
Settings window:<br>
<a href="/resources/screenshots/netctl-gui_settings.png"><img src="/resources/preview/netctl-gui_settings_prev.jpg"></a></p>
<!-- end of gui block -->