cmanager

CLI (Command Line Interface) for DracOS Linux's users to manage their connection ex: wifi connection.


Keywords
cmanager, dracos, connection, manager
License
GPL-3.0
Install
pip install cmanager==2.2

Documentation

DCM or CManager

https://img.shields.io/pypi/v/cmanager.svg?style=flat-square&label=version https://img.shields.io/badge/license-GNUGPLv3-blue.svg?style=flat-square https://img.shields.io/pypi/pyversions/cmanager.svg?style=flat-square https://img.shields.io/pypi/dm/cmanager.svg?style=flat-square

DracOS Connection Manager/Connection Manager is a CLI (Command Line Interface) based program written in Python. This program help DracOS Linux's users to manage their connection ex: wifi connection. For other Linux distros' users, feel free to use this program.

Installation

CManager require the user as sudoers.

You can install CManager directly from PyPI:

$ sudo pip install cmanager
$ sudo cmanager configure

Or download from github repository, then:

$ sudo python setup.py install
$ sudo cmanager configure
# Or
$ sudo ./install.sh

DCM needs some python module below, (this modules already included at pypi installed requires).

  • colorama: sudo pip install colorama
  • terminaltables: sudo pip install terminaltables
  • pbkdf2: sudo pip install pbkdf2
  • netifaces: sudo pip install netifaces
  • python-wifi: sudo pip install python-wifi

CManager needs some program/binary in sudoers file's whitelist so it won't ask for password while executing those program:

  • iwlist
  • wpa_supplicant
  • dhclient
  • pkill

To make you easier in installing CManager, just use install.sh script. You just need to run it with ./install.sh

Usage

$ sudo cmanager

Documentation

Don't forget to run cmanager as with sudo cmanager, type help inside DCM to get information about available commands

https://raw.githubusercontent.com/fachrioktavian/CManager/master/screenshots/help.jpeg

Dashboard section

See available interfaces

CManager will detect interfaces on your system, categorize them into three types of interface (wireless, ethernet, localhost). Use show interface to print those interface

https://raw.githubusercontent.com/fachrioktavian/CManager/master/screenshots/show_interfaces.jpeg

Wifi-wizard section

Specifying wireless interface to used by DCM

Before you can ask CManager to scan available networks and connecting to one of them using profile that you've been created (see profile explanation), you should specify wireless interface that CManager will use to do those activity, type use [wireless_interface].

https://raw.githubusercontent.com/fachrioktavian/CManager/master/screenshots/use_interface.jpeg


Scan available wifi networks

To scan available network, simply type scan.

https://raw.githubusercontent.com/fachrioktavian/CManager/master/screenshots/scan_networks.jpeg


Creating profile

Profile in CManager is a configuration file that has information about wifi connection like SSID, type of connection (Open/WPA), and passphrase if the connection is WPA type. To create a profile, simply input value to available option (name, ssid, type, passphrase) using set name [value], set ssid [value], set type [value], set passphrase [value]. show options to see available options. For Open type connection, you just need to input name, ssid, and type, no need to supply passphrase information.

After all informations needed to create a profile have been provided, simply save profile and your profile will be saved. To see all information about all profiles that have been saved, type show profile.

https://raw.githubusercontent.com/fachrioktavian/CManager/master/screenshots/create_profile.jpeg


Connecting to a network

To connecting CManager to a network use a specified profile name, type connect [profile]. To disconnect it, simply type CTRL+C.

https://raw.githubusercontent.com/fachrioktavian/Cmanager/master/screenshots/connect_wifi.jpeg

Contributing to CManager

The easiest way to contribute to CManager is to file issues.

License

See LICENSE

Changelog

See CHANGELOG.md

Special thanks to

  • Agus Makmun for the contribution making this program downloadable via PyPi