Running TkGoodStuff

Table of Contents (this document)

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.