Manual

What is conler?

Conler stands for “Wi-Fi Connection Handler”. Conler is a configuration tool for Maemo OS which allow you to define reactions on connection with specified Wi-Fi Access Points (AP). ‘Reaction’ is supposed to be a list of user-defined commands which will be executed sequentially.

You do not need to spend you time doing such configurations in the the depths of OS anymore!

Conler is a Free Software, it is licensed under GNU GPL v3.

Important

Conler 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.

Note

conler is still under active development. Please feel free to send bug-reports, suggestions and just interesting ideas to conler-maemo {at} thekondor.net

When do I need conler?

You may need conler when you want:
  • To bring up/down firewall (e.g., iptables)
  • Start a synchronisation of your data (e.g., via rsync)
  • Change default IP routes
  • Start some application or play some sound :)

when you get connected to AP

Visit Conler’s Cookbook to get real examples of using.

User Interface

Main View

Main Window
Main view consists of the following major UI components:
  • List of Access Points to handle

  • List of Commands to execute

  • Toolbar which allows user to manage easily both these lists

    Control Toolbar

AP List

Access Point List

AP List contains names of Wi-Fi Access Points which will be handled on connection with. The list consists of two columns:

Status column
Defines if connection with this AP should be handled. Green colour means “yes, it certainly should”, Red means that connection with this AP will not be handled (disabled).
Access Point name column
Name of AP here must correspond to the name defined in Control Panel -> Settings -> Connectivity -> Connections

All operations to manage APs are placed on the left side of the toolbar.

Add new AP

New AP can be added with the following button on toolbar:

Add New AP button

After a click you will be asked to enter a name of AP:

Add New AP dialog

When you confirm your input, a new AP will be added after already selected AP or to the end of list if nothing is selected. By default, added AP will be enabled (it’s status can be changed any time later, see Disable/Enable AP for details)

Rename AP

From time to time names of APs are changed. You don’t need to create a new AP with a duplicate list of commands, you can just rename existing AP. Rename is performed with the following button:

Rename Access Point button

After a click you will be asked to enter a new name of the AP:

Rename Access Point dialog

Tip

Using this dialog you can also change AP’s status.

Disable/Enable AP

There is no need to delete AP or to clear command list when you need to stop handling connection with concrete AP. AP handling can be just disabled.

There are several ways to disable/enable AP:
  1. Toolbutton:
Toggle Access Point status (toolbutton)

It always indicates status of current AP.

  1. Corresponding icon in the AP list

Remove AP

Deletion of AP can be performed with the following button on the toolbar:

Delete Access Point button

Note

  1. No confirmation to delete is asked
  2. Command list related to deleted AP will be cleared as well

Command List

Command List

Command List contains a sequence of commands which will be executed for the chosen AP.

Note

Commands are executed sequentially Next command is executed only when previous one is finished.

Commands:
  • Each command can be enabled or disabled. Pixmap Enabled Command denotes that a command is enabled. Pixmap Disabled Command denotes that a command is disabled.

  • Each command can be run with non-root privileges or in the superuser’s environment.

    • Pixmap Run in superuser environment denotes that a command is run in the superuser’s environment.
    • Pixmap Run in superuser environment denotes that a command is run with non-root privileges.

Add command

New command can be added using the following button on the toolbar:

Add New Command button

After a click you will be asked to enter a command to add.

Enter New Command dialog

When input is confirmed, a new command is added after current selected one (if there is) or to the end of the list (command’s position can be changed anytime – see Change Command Position for details)

Edit command

Already existent command can be edited any time using the button:

Edit Current Command button

After a click you will be asked to edit selected command and update its properties.

Edit Current Command dialog

Tip

Using this dialog you can also enable/disable a command or change its run environment.

Change Command Position

Because commands are executed one by one, an order of them does matter. To change command’s position the following buttons are used:

Promote a command

Promote Current Command button

Demote a command

Demote Current Command button

Note

Functions to promote/demote command may be unavailable in some cases, when:

  1. Selected command is the last/first in the list
  2. Selected command is only one in the list

Remove command

Command can be removed by the following button:

Remove Current Command button

Note

No confirmation to delete is asked.