netctl-gui/README.md
2014-07-10 14:33:04 +04:00

2.1 KiB

Netctl GUI

Information

Qt4/Qt5 graphical interface for netctl. It may work with profiles and may create new profiles. Also it may create a connection to WiFi. Moreover, it provides a widget and DataEngine for KDE.

NOTE LOOKING FOR TRANSLATORS!

Configuration

It is recommended to use graphical interface for widget configuration. DataEngine settings are stored in /usr/share/config/netctl.conf:

  • CMD - netctl command. Default value is /usr/bin/netctl.
  • IPCMD - ip command. /usr/bin/ip by default.
  • NETDIR - a directory, which contains subdirectories with names of network interfaces. Default is /sys/class/net/.
  • EXTIPCMD - a command, which returns external IP address. Default value is wget -qO- http://ifconfig.me/ip.
  • EXTIP - true will enable external IP definition. Default is false.

All settings of GUI are stored in $HOME/.config/netctl-gui.conf. It is highly recommended to edit it from graphical interface.

Instruction

Dependencies

  • netctl
  • qt5-base (if Qt5 is used) or qt4 (if Qt4 is used)

Optional dependencies

  • kdebase-workspace (widget)
  • sudo (sudo support)
  • wpa_supplicant (WiFi support)

Make dependencies

  • automoc4
  • cmake
  • qt5-tools (if Qt5 is used)

Installation

  • download sources

  • extract it and install the application:

      cd /path/to/extracted/archive
      mkdir build && cd build
      cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ../
      make
      sudo make install
    

    Available cmake flags:

    • -DBUILD_DATAENGINE:BOOL=0 - do not build DataEngine
    • -DBUILD_GUI:BOOL=0 - do not build GUI
    • -DBUILD_PLASMOID:BOOL=0 - do not build Plasmoid
    • -DUSE_QT5:BOOL=0 - use Qt4 instead of Qt5 for GUI

Additional information

TODO (wish list)

  • netctl-auto frontend