This is tcllauncher, a launcher program for Tcl applications.
M4 Shell Makefile C Tcl
Switch branches/tags
Failed to load latest commit information.
doc Update copyright year in the manpage and regenerate. Oct 3, 2014
.gitignore Add configure script. Aug 17, 2015
ChangeLog Update ChangeLog Aug 17, 2015 Detect and call setproctitle_init for libbsd May 9, 2017
README.Debian Update build instructions for Debian. Apr 25, 2013
README.FreeBSD Add autoconf to FreeBSD README Aug 31, 2016
README.MacOSX Add of README file for Mac OS X. Aug 30, 2009 Add note about FlightAware open source projects Sep 29, 2015
aclocal.m4 * Add aclocal.m4 to create a rule for finding the path to dtplite and Jul 17, 2009
license.terms New README. remove superfluous stuff form launcher.h. Update license. Jan 13, 2014 No longer load the shlib Sep 26, 2014 if unable to lock, ID file in errmsg Jun 24, 2017
tcllauncher.tcl daemonize -noclose improvement and minor stuff Aug 17, 2015

tcllauncher, a launcher program for Tcl applications.

tcllauncher is a way to have Tcl programs run out of /usr/local/bin under their own name, be installed in one place with their support files, and provides commands to facilitate server-oriented application execution.

While there is another wrapper system that also does this, that system produces a single executable that contains all the code and support files within a built-in virtual filesystem wrapped inside the executable. Tcllauncher keeps the support files distinct, typically in a subdirectory of /usr/local/lib that's named after the application.

This package is a freely available open source released under the liberal Berkeley copyright. You can do virtually anything you like with it, such as modifying it, redistributing it, and selling it either in whole or in part. See the file "license.terms" for complete information.

UNIX Build

Building under most UNIX systems is easy, just run the configure script and then run make. For more information about the build process, see the tcl/unix/README file in the Tcl src dist. The following minimal example will install the extension in the /opt/tcl directory.

$ cd tcllauncher
$ autoconf
$ ./configure --prefix=/opt/tcl
$ make
$ make install


Beware it building against the source dirs instead of installed dirs and then not being able to find stuff. If, for instace, you're building in /usr/fa, use something like

./configure --prefix=/usr/fa --with-tcl=/usr/fa/lib

The --with-tcl is important! Otherwise it will probably find the Tcl source in a parallel directory and build against that instead and cause problems later.


The installation of a TEA package is structure like so:

      /       \
    lib       bin
     |         |

PACKAGEx.y (dependent .dll files on Windows) | pkgIndex.tcl (.so|.dll files)

The main .so|.dll library file gets installed in the versioned PACKAGE directory, which is OK on all platforms because it will be directly referenced with by 'load' in the pkgIndex.tcl file. Dependent DLL files on Windows must go in the bin directory (or other directory on the user's PATH) in order for them to be found.


FlightAware has released over a dozen applications (under the free and liberal BSD license) into the open source community. FlightAware's repositories are available on GitHub for public use, discussion, bug reports, and contribution. Read more at