# Running TkGoodStuff

## Table of Contents (this document)

- Invocation
- Geometry
- Determination of Configuration File

## Invocation

You invoke tkgoodstuff by issuing a command of the following form:

    tkgoodstuff [-geometry -3+0] [-f configfilename ]

Here, the brackets indicate optional arguments, which are discussed below.

## Geometry

There are two geometry modes: screen-edge and normal:

### Screen-edge mode

If you set screen-edge mode ("no" by default) to "left", "right", "top", or "bottom", tkgoodstuff will span that edge of the screen.

### Normal mode

If fullscreen mode is "no" (as by default), tkgoodstuff looks in two places for geometry (screen location) information. A geometry specification is a string that identifies a point on the screen by its x and y distances in pixels from the top (or bottom) and left (or right) edges of your screen:

Specification | Puts the tkgoodstuff Panel . . .
--- | ---
+1-123 | 1 pixel from the left and 123 pixels from the bottom of the screen
-1+123 | 1 pixel from the right and 123 pixels from the bottom of the screen

tkgoodstuff chooses the first geometry specification it finds in the following ways:

1. In the command line, as follows:

              tkgoodstuff -geometry +34-88

2. In the current preferences.

## Determination of Configuration File

tkgoodstuff needs a configuration file to run. It uses the first file it finds in the following ways:

1. Named on the command line, as follows (where "configfilename" is the name of your file):

              tkgoodstuff -f configfilename

2. In your home directory (as set in the environment variable HOME) under the name .tkgrc.
3. In the tkgoodstuff directory (by default, /usr/local/lib/tkgoodstuff), under the name system-tkgrc.

Using the "-f configfilename" form allows you to have many different panels defined for different purposes.