adventures logo
adventures in linux programming


microterminal (FPGA)
KeenView driver
Tiny Cobol


C básico
Linux sob medida
tclslides talk
FSL(P.Alegre) 2003
Forum linux I
Real Time Linux
Americano Batista Linux


GDI printers
SOS Linux
gimp tutorial
hardware projects
free photos
short commands
brazilian keyboard
personal info
html editing
favorite places (links)


Chapeuzinho Vermelho
Linux Pernambuco
Why Linux?
Day after

EasyRunner - a program launcher

EasyRunner is a program launcher easy to operate and compatible with Windows, Linux and other Unix systems. You add buttons simply by clicking in an empty place at the main window grid and defining its associated command. You can also have indefinite levels of sub-menus, each with their own buttons and hotkeys. If wanted, you may lock the user interface to keep it from change by the end user. To be unlocked a password is required.

EasyRunner is distributed as a starkit. You will need the tclkit executable for your platform. Get it at the TclKit download page at Equi4 Software, by Jean-Claude Wippler.

The documentation, README and LICENSE files, are embedded in the kit itself, as is the full source of the scripts, and configuration file. The easyrunner.kit file must be made writable, or the program will refuse to run, because it stores in itself the configuration. If you want separate configurations, copy the kit with any other name.

The program messages are in portuguese. You are invited to translate them to english, or better yet, to make it msgcat aware, so it may run in multiple languages. The source code is included and may be navigated with the program itself. You may also get a tkcon (console) with the hotkey <Control-Shift-D>.

We are thankful to Ricardo Dália, Sérgio Limongi and the other friends at Acesso Ltda, Recife, Brazil for their support to get this software written.

Quick How To

Here is a quick guide, the same as found inside the starkit.

  • By clicking with the left mouse button in the blank areas below or to the right of existing buttons, you are allowed to define a new button (launcher).
  • If in an already placed button, clicking with the right mouse button, will bring you an edit window for the defined button.
  • If you click in the header area (with left mouse button), you will get a configuration screen. The "lock" checkbutton should be left unchecked until you have defined all buttons. To unlock, you must enter the user "admin" and initial password "admin". This password may be changed by filling the corresponding field in this screen.
  • Launcher buttons may open a new shell (xterm in Linux, dos_prompt in Windows) or run straight from its command with no terminal. Also, for commands (Linux only) which will finish, you may want to use "hold" to keep it from closing prematurely.
  • A button which have "submenu" activated will change for a new window with other buttons, and may be navigate back by pressing the upper back button. Each submenu have their own sub-title but share the main title with the main window.
  • You can drag and drop buttons to move them. Hold <Control> and drag with the left mouse button pressed. Any empty grid space, or the bottom row, or right column are suitables as a drop site.
  • Hot keys (tk bindings) can be attached to any button. Click the hotkey button and enter and combination of <Control>, <Alt>, or <Shift> plus any other regular key, like the letters, numbers or Fxx keys. The hotkey entry will change its color to red while waiting for the hotkey definition. You may also edit this definition by hand, using the same syntax. The <Control-Backspace> hotkey is predefined to allow us to return to the previous menu window, doing the same as the corresponding button.
  • Complex commands may have substitution rules for arguments. The symbols %1, %2, %3, ... are substituted for the first, second, third, and so on, arguments given as a list, enclosed in braces. Each argument list should have two elements, the first is the type, which must be one of "fileread", "filewrite", "dir", or "text". The second item of the list is a message that will be shown when asking for the arguments. Please see the example with "ls" in the program.



Last updated: 2007/08/27 11:11:55