ICONBAR(1) ICONBAR(1)
NAME
iconbar - a desktop utility for managing icon windows
SYNOPSIS
iconbar [-option1 value1] [-option2 value2] [...]
DESCRIPTION
iconbar is intended to be a drop-in replacement for the (OSF/Motif)
standard iconbox application that is included as part of the 4dwm(1X)
window manager running under the IRIX(tm) operating system. It uses
OSF/Motif, X Toolkit Intrinsics and Xlib functions to manipulate win-
dows on the desktop.
Iconbar creates an unmanaged window at the bottom of the screen that
Since version 0.8, Iconbar will automatically center itself in channel
zero on those system that have multiple channels per pipe.
Multi-Desks
Iconbar does not explicitly support the 4dwm concept of multiple desk-
tops. However, since it is not managed by the window manager it does
appear on every desktop and is capable of managing icons of top-level
windows across all desktops. Since version 0.8, Iconbar will automati-
cally center itself in channel zero on those system that have multiple
channels per pipe.
Disclaimer
4dwm and IRIX are trademarks of Silicon Graphics Inc. The iconbar
application is not endorsed by or affiliated with Silicon Graphics
Incorporated.
Copyright
Iconbar is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
Iconbar is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with Iconbar; if not, write to the Free Software Foundation, Inc., 59
Temple Place, Suite 330, Boston, MA 02111-1307 USA
OPTIONS/RESOURCES
The following added resources are intended for user customization. They
may be set using either a command line syntax as shown below, or in a
resources file such as the site default resources (/usr/lib/X11/app-
defaults/Iconbar) or the users personal default resources ($HOME/.Xde-
faults).
-animate increments
An integer value that specifies the number of increments used in
the animated pop-up of the iconbar. In this context 1 is fastest
and 20 is slowest. The default is 5. Resource: animate.
-border None|Default|<filename>
controlled by the animate resource, the hidden height by the
hideheight resource and the delay before the hide occurs by the
hidecount resource. Pressing either the Esc or space keys trig-
gers and immediate hide. Resource: hide.
-hidecount count
An integer value that specifies that the application should wait
count number of 200 millisecond update intervals after the cur-
sor is moved out of the bar windows, before hiding the iconbar.
The default is 10 which equates to a 2 second delay. Resource:
hidecount.
-hideheight pixels
An integer value determines the height in pixels of the hidden
iconbar. The default is 1. Resource: hideheight.
-highlightFG color
A string describing the color that the foreground text is
changed to when the cursor enters a particular icon window. The
default is blue. Resource: highlightFG.
-horzmin pixels
An integer value indicating the minimum horizontal screen loca-
tion for the center of the iconbar. The default is 0. Resource:
horzmin.
-horzmax pixels
An integer value indicating the maximum horizontal screen loca-
tion for the center of the iconbar. The default is 0. Resource:
horzmin.
-horzshift [-]pixels
An integer value indicating the number of pixels to displace the
iconbar from the center of the screen. The default is 0.
Resource: horzshift.
-ignoreApps app_list
app_list is a colon delimited string listing the window names of
applications that the iconbar program will ignore (i.e. not man-
age). The window name is the WM_NAME window manager hint prop-
erty that can be retrieved for a particular window using the
xprop(1) command. The default string is ToolChest (iconbar
always ignores itself). Resource: ignoreApps.
Iconbar retrieves the icon pixmaps for each application by
sequentially attempting the following methods: (WMHINTS)
retrieving an icon window hint property (currently not func-
tional see BUGS), retrieving an icon pixmap hint property (FILE)
an rgb(4) format image file in the user's $HOME/.icons directory
named with the application's instance name and the .icon suffix,
a similar file in the /usr/lib/images directory, a file in
$HOME/.icons with the application's class name, class-name.icon
file in /usr/lib/images (DEFAULT) the default icon file in
$HOME/default.icon /usr/lib/images/default.icon (SCREEN) a last
resort of copying the pixmap from the screen after a "quick"
minimization of the top-level window. The order that Iconbar
tries each of these methods in an attempt to resolve the appli-
cation's icon is specified as a colon separated string for this
option. The default is WMHINTS:FILES:DEFAULT:SCREEN. Resource:
path.
-raise True|False
If True (default) causes the iconbar window to be continuously
raised to the top of the window stack, prevented it from being
covered by overlapping windows. Resource: raise.
-scale factor
A floating point scale factor in the range from 0.1 to 1.0 that
is used to determine the size of the "non-magnified" (small)
icon pixmap in the iconbar window. Recall that the nominal (big)
4dwm(1X) icon size is 85x67 pixels. The default value is 0.75.
Resource: scale.
-shape True|False
A boolean value that determines if the X SHAPE extension will be
used to trim the magnified icon windows with smaller than full
size icons (typically those with icon_mask hints). The default
value is True. Resource: shape.
-tint True|False
A boolean value that determines if applications running on
remote hosts will have their icons automatically tinted. The
default value is True. Resource: tint.
-toolchestManage True|False
A boolean value that determine if iconbar will attempt to manage
the state of the IRIX application /usr/bin/X11/toolchest. If
True, iconbar will perform two window management tasks: it will
attempt to raise the toolchest window when it is obscured, and
it will force the window to remain at the geometry (root window
default value is 1. Resource: toolchestY.
USAGE
Iconbar may be invoked from the command line. It's a good idea to first
disable the iconbox from the desktop. This can be done graphically via
the toolchest(1X) menus Desktop->Customize->Windows and unchecking the
box next to Display Windows Overview.
To access a graphical menu that controls the toggling of some of the
interface options and also allows the icons to be rearranged, use the
Right or Middle mouse-button when over an icon pixmap.
To exit iconbar in a controlled manner either use the pop-up option
menu described above or else simply send a SIGHUP to the process using
the kill(1) command with argument -HUP followed by the process id num-
ber.
If iconbar terminates unexpectedly, the desktop icon windows may be
left in an inaccessible state. To rectify this, restart the window man-
ager. The restart can be accomplished from the toolchest(1X) or via the
command tellwm(1X) with the argument restart.
EXAMPLES
A sample shell command line launch of iconbar that would disable the
magnification and auto-hide options, eliminate the icon margins and
ignore the toolchest(1X), gr_osview(1) and ov(1) applications is as
follows:
iconbar -magnify False -hide False -margin 0 -ignoreApps ToolCh-
est:gr_osview:Desks Overview
Alternately, a user could place in his or her .Xdefaults file and
achieve identical results:
Iconbar*magnify: False
Iconbar*hide: False
Iconbar*margin: 0
Iconbar*ignoreApps: ToolChest:gr_osview:Desks Overview
FILES
/usr/lib/images/*.icon
system directory searched for rgb(4) format icon image files
$HOME/.icons/*.icon
user directory searched for rgb(4) format icon image files
/usr/lib/images/default.icon
AUTHORS
Steven Queen, Antony Fountain, and Bryan Sawler
ACKNOWLEDGMENTS
Thanks to all of the testers at http://www.nekochan.net for their
patience, feedback and support.
SEE ALSO
4dwm(1X), toolchest(1X), kill(1), xprop(1), tellwm(1X), rgb(4),
gr_osview(1), ov(1)
v0.8 27
May 2006
ICONBAR(1)
Man(1) output converted with
man2html