Contents

• Manual
  • What is conler?
  • When do I need conler?
  • Requirements
  • User Interface
    • Main View
    • AP List
      • Add new AP
      • Rename AP
      • Disable/Enable AP
      • Remove AP
    • Command List
      • Commands
      • Add command
      • Edit command
      • Change Command Position
      • Disable/Enable command
      • Remove command

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 enable a firewall (e.g., iptables)
• To make backup of your data (e.g., via rsync)
• To change default IP routes
• To update RSS feeds
• To get new podcasts
• To start some application or play some sound :)

when your Internet Tablet goes online.

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

Requirements

All you need to use Conler is a Nokia Internet Tablet device with installed OS2008 (Chinook, Diablo). No extra dependencies are required.

User Interface

Main View

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

  

AP List

AP List contains names of handled Wi-Fi Access Points. The list consists of two columns:

Status column

Indicates if connection with this AP should be handled. Green colour means “yes, it certainly should”, Red means that handling is disabled.

Access Point name column

Name of AP here must correspond to the name defined in Control Panel -> Settings -> Connectivity -> Connections

The list can be managed using the buttons placed on the left side of the toolbar.

Add new AP

• New AP can be added using the corresponding button on the toolbar:

  

• On button click user will be asked to enter a name of AP to handle or be able to select already existent one.

• By default all newly created APs are enabled. AP can be disabled on creation using the corresponding ‘Disabled’ checkbox on the dialog.

• AP’s status can be changed (enabled/disabled) any time later, see Disable/Enable AP for details.

• All newly created APs are added after currently selected one, or added to the end of the list otherwise.

  Tip

  AP’s position in the list does not matter anything. Anyway AP’s position can be changed using Drag’n’Drop.

Rename AP

From time to time names of APs are changed. There is no need to create a new AP in the list with a duplicate list of the commands – AP’s can just be renamed.

• New AP can be added using the corresponding button on the toolbar:

  

• On button click user will be asked to enter a new name of AP to handle or be able to select already existent one.

Tip

It is also possible to change AP’s status using the corresponding the dialog’s ‘Disabled’ checkbox.

Tip

Use double-tap to get the fast way to rename a command.

Disable/Enable AP

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

Ways to enable/disable AP:

• Toolbutton:

  

  It always indicates status of current AP.

• Corresponding pixmap in the AP list

When toolbutton or icon is tapped, status of AP is changed: colour is changed to the opposite one.

Remove AP

• Existing AP can be removed using the corresponding button on the toolbar:

  

• Related to AP command list is deleted as well

Note

No confirmation to delete is asked

Command List

Command List contains a sequence of commands which are executed for the chosen AP. The list consists of the three columns:

Status column

Defines if command is enabled and it should be executed.

Run Environment column

Indicates command’s run environment.

Command column

Contains command itself.

The list can be manager using the buttons places in the middle of the toolbar.

Commands

Commands execution order:

• Commands are executed sequentially
• Each command can be turned to run either in foreground or background. Default is: run in background.
• Commands run in the background are denoted using pixmap , disabled .
• Commands run in the foreground are denoted using pixmap , disabled .

Commands execution environment:

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

• Command’s execution environment is important: when run with user privileges it is possible to run GUI application without any additional ‘magic’; when run in the superuser’s environment it is possible to have access to the system’s files.

  Important

  Run commands in the superuser’s environment with care!

• By default commands are run with user (non-root) privileges

• Commands run with user privileges are denoted using pixmap

• Commands run in the superuser’s environment are denoted using pixmap

Add command

• New command can be added using the corresponding button on the toolbar:

  

• On button click user will be asked to enter a command to add

• By default all newly created commands are:

  • Enabled
  • Run in the user’s environment
  • Run in the background

• All default command’s properties can be changed using corresponding dialog’s checkboxes.

• All newly created commands are added after currently selected one, or add to the of the list otherwise. Command’s position can be changed anytime later – see Change Command Position for details.

Edit command

• Already existent command can be edited any time using the corresponding button on the toolbar:

  

• On button click user will be asked to edit the current command and change the corresponding options.

Tip

Use double-tap to get the fast way to edit a command.

Change Command Position

Because commands are execution sequentially, an order of them does matter. To change command’s position in the list the corresponding buttons are used:

• Promote a command

  

• Demote a command

  

Note

Promote/demote command function may be unavailable in cases when:

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

Tip

Command’s position in the list can be changed using Drag’n’Drop.

Disable/Enable command

There is no need to delete a command where there is a need to temporary stop command’s execution for a concrete AP – command can just be disabled.

A command can be easily disabled tapping on the corresponding pixmap: or .

A command can be easily enabled tapping on the corresponding pixmap: or .

Remove command

• Existing command can be removed using the corresponding button on the toolbar:

  

Note

No confirmation to delete is asked.