Интерактивная система просмотра системных руководств (man-ов)
>> coolicon (1) ( Linux man: Команды и прикладные программы пользовательского уровня )
coolicon-3.17.5 - Icon manager with graphical icon configuration
and drag and drop support. Written under the Coolwidget library.
displays pixmap (.XPM) files as icons on the desktop. Each icon presents
a menu (right-click) from where the user can perform various operations.
Each icon has two user configurable scripts which are executed on
recieving a drop event or on running the icon with a double-click.
The icons scripts' as well as other properties can be modified through
a dialog box accessable through each icon's menu. The scripts can directly
manipulate a recieved drop event making it easy to program Trash Cans,
Printer icons and so on. Several useful example icons are given.
- -d, -display <display>
The X server and display you would like to display to.
- -w, --wait-for-display
Most X programs exit with an error if the specified server refuses a connection,
or is unavailable. This option causes
to retry the server once every second until a connection is established. You
can use this to start
before starting the server. You must however set the
environment variable (eg. `setenv DISPLAY localhost:0.0' or
`DISPLAY=localhost:0.0 ; export DISPLAY') before-hand. The
advantage of this is that you can use
out of your startup scripts if you don't have access to them or don't
know how to find them.
- -M, --mail-name
If you specify this option,
will poll your mailbox at the default interval of once every 30
seconds. If it finds that the mailbox has grown more than 80
characters, it will bring up a 3D image of an `e' (remember
`Disclosure' with Demi Moore). The `e' can be double-clicked on to
- -s, -shape, --shape
Without this option, the `e' appears in a managed window. With this option
the `e' floats without a window above the desktop. On slow systems, this
causes a lot of flicker and CPU hogging. It looks really nice on a fast
- -S, --mail-seconds <seconds>
Set the number of seconds between polls of the mail box file.
- -e, --e-data <file-name>
Specify the file name of the data used to draw the `e'. Default
- -X, --size <pixels>
Specify the size of the `e' window to appear. Default is 150 pixels.
- -f, -fn, -font <font-name>
The font you would like to use.
- -h, -H, -?, --help
Print out commandline options summary.
- -V, -v, --version
Print out version number.
coolicon --mail-name /var/spool/mail/mdouglas &
Envoking coolicon will present the default icons onto the desktop.
These will initially be `raised', meaning that they will be printed
above the other windows on the screen. This is why you should start
coolicon before starting other applications. To lower the icons,
right-click on the `Icon manager' icon, and select `Lower icons' from
the menu (each icon has a menu). You can move icons around the desktop
by dragging them with the left mouse button, and then selecting `Save
icons' from any of the icon's menus, to save their current positions.
Each icon performs two functions. Firstly, it can be executed by double
clicking with the left button (this will usually run the application
described by the icon). Secondly it can recieve drag and drop events
(for example, dropping text onto the `Print...' icon will run `lpr' and
print that text). An icon's actions are defined by two scripts which you
can edit by selecting `Edit icon...' from the icon's menu. The fields in
the `Edit icon' dialog are mostly self explanatory. The field `Prompt
before executing' is the text to be displayed if the `Prompt on drop' or
`Prompt on double click' option is on. Similarly with `Confirmation
Prompt'. These options cause the user to be asked for some option before
the script is executed. This option is passed to the script as `%a'. See
the `Print...' icon for an example.
The first thing that is interesting to experiment with is the
`Launch...' icon. When you double click on `Launch...' you will be
prompted for a file to execute, and a nice browser to find it if you
need to. Now if you drop a file-name onto the `Launch...' icon, its
script will interpret the file type and launch the appropriate
application. For instance, I have coded most image file extensions into
the script, so xv will be executed for image files. The list of
file types (C files, dvi files etc.) was off the top of my head, so
please email me with additions to the script. This way the launch icon
will eventually support a large number of extensions. A good idea would
be to run the file program on the dropped file-name from within
the script and then interpret the result.
CREATING YOUR OWN ICONS
This is easy to do using the `New icon...' menu option - just fill in all
the fields. You may want to create your own pictures with some image editing
program; if so,
is ideal for manipulating small color images and is recommended. Be
sure that the format is `.xpm' and not some other format. Some places
where default XPM files may be stored on your system are:
Other icon packages may also have databases of useful XPM files - take a look
file-name you specify in the `Edit Icon' dialog box is not a full path-name
then the path
(or whatever prefix
was installed under) is prepended to the file-name.
SCRIPT FILE SUBSTITUTIONS
The following `percent substitutions' are available for convenience when
writing script files. Take a look through the example script files
(especially the `Launch...' icon) on the use of some of these.
The current directory as set from the
If the icon recieved a drop, and that drop was of the `file' type. Then
%f contains the full file name of that file, without the path. The
next three substitutions refer to this file name.
The file-name without the extension.
The file-name extension only.
The full path of the file-name without the trailing slash. eg. %p/%f is
the full path and file name.
The string typed in by the user if they where prompted.
The current font, or 8x13bold if the current font is a
proportionally spaced font - use for terminal apps.
The current font regardless.
Inserts a literal %.
A text string representing the type of the data dropped onto the icon.
This will be one of the Toplevel MIME Types eg, application,
audio, image, text or video. %T will evaluate
to one of the types comma-listed for the icon. (Click on Edit Icon
in the Icons menu.)
This is the counterpart to %T, its sub-type. %T/%s forms the
full mime type of the drop. Examples are application/postscript,
application/postscript, audio/x-wav, image/jpeg,
text/html or video/mpeg.
%A is the name of a file containing the data that was dropped. This
will be a file in the /tmp directory.
is useful for making point-and-click versions of standard text utilities.
The problem with text utilities is that there output won't be seen under
most X environemts. This is especially problematic if the output is an
error message. To display error messages, you can pipe error data
into the coolmessage
command. Run coolmessage -h
how it works, and then look at the `Print...' icon's scripts for
example usage. The coolbrowse
command is also useful for getting
files from the user from within scripts, run coolbrowse
info. There are several other utilities in the same vein: coolinput
. For fun, try
ps | sed -e 's/^[ ]*//g' -e 's/[ ][ ]*/,/g' | coollistbox -delim ','
This program is distributed under the terms of the GNU General Public
License as published by the Free Software Foundation. See the file
COPYING in the source distribution for details on the License and the
lack of warranty. Alternatively see the 'About' menu of the
The latest public release of this program can be found at sunsite.unc.edu
in the directory /pub/Linux/Incoming, or /pub/Linux/apps/editors/X. The
latest development version can be found at
in the directory
all by anonymous ftp.
is packed with the
Paul Sheer (psheer /AT/ icon.co.za)
- CREATING YOUR OWN ICONS
- SCRIPT FILE SUBSTITUTIONS
- SEE ALSO